ForHosting KIT · Ferramentas para dev

Densificar linha geodésica com vértices equidistantes

Densifique uma linha geográfica inserindo vértices intermediários de latitude e longitude em cada segmento.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe uma linha ordenada e um espaçamento máximo em metros; o resultado seguirá o arco de círculo máximo mais curto e garantirá que nenhuma lacuna gerada ultrapasse esse valor. Os vértices originais permanecerão na ordem, enquanto contagens e resumos de distância facilitarão a conferência, a exibição no mapa ou o uso em outro fluxo espacial sem depender de um programa SIG para computador.

Escolha um espaçamento adequado à próxima etapa

A densificação de linhas é útil quando uma operação precisa de amostras mais frequentes do que a geometria original oferece. Comece com uma lista ordenada de registros contendo lat e lon e defina spacing_m como a maior lacuna aceitável em metros. A calculadora avalia cada segmento original separadamente. Quando um segmento já é menor que o espaçamento solicitado, ele permanece como uma única lacuna, sem pontos desnecessários. Quando é maior, o trecho é dividido no menor número inteiro de partes geodésicas iguais capaz de respeitar o máximo. Portanto, o espaçamento é um teto, não uma exigência de que todas as lacunas tenham exatamente o valor informado. Como cada segmento é dividido à parte, seu ponto final é preservado e o seguinte começa exatamente no vértice original. Use valores maiores em mapas de visão geral e menores quando as amostras alimentarem consultas de terreno, cobertura, animações ou cálculos que pressupõem arestas curtas. Um espaçamento muito pequeno pode produzir uma resposta extensa; por isso, a capacidade rejeita resultados acima do limite documentado em vez de cortar a linha sem aviso.

Entenda o cálculo geodésico esférico

Cada par de coordenadas consecutivas define um segmento sobre uma esfera. O algoritmo transforma os dois pontos em vetores unitários tridimensionais, mede o ângulo central e interpola pelo arco de círculo máximo mais curto. A distância corresponde a esse ângulo multiplicado por earth_radius_m, cujo padrão é o raio médio convencional da Terra. O método funciona corretamente ao atravessar o antimeridiano: uma linha de 179 graus leste a 179 graus oeste segue o caminho curto junto à linha internacional de data. Ele também evita tratar latitude e longitude como coordenadas cartesianas planas, aproximação que se torna enganosa em grandes distâncias ou perto dos polos. As coordenadas originais e inseridas são determinísticas e recebem arredondamento estável para comparações confiáveis em JSON. Pontos consecutivos coincidentes são mantidos, pois podem ter significado estrutural, embora a lacuna seja zero. Pontos exatamente antípodas são recusados porque infinitos círculos máximos ligam pontos opostos e não há um caminho curto único. Em trabalhos de levantamento que exijam elipsoide, considere que esta capacidade usa uma esfera configurável, e não o elipsoide WGS-84 completo.

Leia e valide o resultado

O resultado principal é vertices, uma lista ordenada pronta para ser serializada como coordenadas ou convertida ao formato geométrico do seu aplicativo. A primeira e a última coordenada são os extremos de origem, e cada vértice interno original aparece na divisa entre segmentos. A resposta também informa input_vertices, output_vertices e inserted_vertices, tornando a expansão visível e ajudando a controlar limites de armazenamento ou renderização. total_distance_m soma os comprimentos geodésicos originais. max_segment_distance_m mostra a maior lacuna real depois da subdivisão; ela deve ser menor ou igual ao espaçamento solicitado, exceto por arredondamento numérico irrelevante. Confira esse campo quando a densificação proteger um requisito posterior de amostragem. Preserve a ordem das coordenadas ao converter para GeoJSON, no qual os pares normalmente trazem longitude antes de latitude, embora esta API use propriedades nomeadas lat e lon. O cálculo é puro, não acessa a rede e não guarda a linha enviada. Você pode fazer verificações interativas no navegador e automatizar pela API por US$ 0,002 por solicitação, recebendo a mesma estrutura determinística.

Preparar uma rota para amostragem regular

Inclua vértices suficientes antes de consultar elevação, clima, cobertura de sinal ou outro valor variável ao longo da rota.

Melhorar o desenho de arestas longas

Represente arestas geográficas extensas com pontos intermediários de círculo máximo para que trajetos projetados ou animados sigam a rota pretendida.

Normalizar linhas com resoluções variadas

Aplique uma única regra de lacuna máxima a linhas cujos vértices originais foram capturados em intervalos inconsistentes.

spacing_m define uma distância exata entre todos os pontos?

Não. Ele define a maior lacuna permitida. Cada segmento original é repartido em trechos geodésicos iguais que não ultrapassam esse valor.

Os vértices originais são preservados?

Sim. Todos permanecem na mesma ordem, e os novos vértices são inseridos entre originais consecutivos.

Funciona ao atravessar o antimeridiano?

Sim. A interpolação segue o arco de círculo máximo mais curto, inclusive na passagem breve entre longitudes próximas de 180 graus.

Por que pontos antípodas são recusados?

Pontos opostos não determinam um único círculo máximo. A recusa evita a escolha de uma rota arbitrária.

O cálculo se baseia no elipsoide WGS-84?

Não. Ele usa geometria esférica de círculo máximo com raio configurável, cujo padrão é o raio médio da Terra.

Quanto custa uma solicitação de API?

Cada solicitação custa US$ 0,002. O cálculo determinístico não chama serviços de terceiros.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/geo/densify-line

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/geo/densify-line \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"line":[{"lat":37.7749,"lon":-122.4194},{"lat":37.8044,"lon":-122.2711},{"lat":37.6879,"lon":-122.4702}],"spacing_m":5000}'
{
  "line": [
    {
      "lat": 37.7749,
      "lon": -122.4194
    },
    {
      "lat": 37.8044,
      "lon": -122.2711
    },
    {
      "lat": 37.6879,
      "lon": -122.4702
    }
  ],
  "spacing_m": 5000
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.densify_line",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_points10000
max_output_vertices100000
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →