ForHosting KIT · Ferramentas para dev

Caixa delimitadora de polígono

A caixa delimitadora de um polígono é o menor retângulo alinhado aos eixos de latitude e longitude que contém todos os vértices informados.

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

Esta calculadora percorre as coordenadas e retorna o canto mínimo, semelhante ao sudoeste, e o canto máximo, semelhante ao nordeste, sem consultar serviços de mapas. Ela é útil para ajustar visualizações, filtrar dados espaciais, criar índices, validar geometrias e resumir rapidamente uma área geográfica. O cálculo é determinístico, aceita coordenadas comuns em graus decimais e usa a mesma lógica no navegador e pela API.

Prepare os vértices do polígono

Informe pelo menos três vértices, cada um representado por números lat e lon em graus decimais. A latitude deve ficar entre -90 e 90, e a longitude entre -180 e 180. Os pontos podem descrever um polígono convexo ou côncavo, e o primeiro ponto pode ser repetido no fim para fechar o anel. Diferentemente de cálculos de área ou centroide, a caixa delimitadora não depende da orientação e não exige vértices em sentido horário ou anti-horário. Cada ponto participa de forma independente da busca pelos extremos. Ainda são exigidos três pontos porque a entrada representa um polígono, não uma coleção arbitrária. Use números em vez de textos com símbolo de grau, sufixos cardeais ou coordenadas separadas por vírgula. Registros inválidos, coordenadas ausentes, valores não finitos e números fora da faixa são rejeitados claramente. Cada solicitação aceita até 10,000 vértices, mantendo a execução previsível para limites geográficos detalhados.

Entenda os cantos retornados

O resultado contém min_corner e max_corner. O canto mínimo reúne a menor latitude da lista e a menor longitude; o canto máximo reúne a maior latitude e a maior longitude. Eles descrevem um retângulo alinhado aos eixos no plano de latitude e longitude. Esses cantos não precisam ser vértices reais do polígono, pois os menores valores podem ocorrer em pontos diferentes. Não são aplicados margem, projeção, arredondamento nem expansão geodésica, portanto a resposta preserva os extremos numéricos enviados. A longitude é tratada literalmente na faixa convencional de -180 a 180. Assim, um polígono que atravesse o antimeridiano pode gerar uma caixa numericamente larga, como uma extensão de -179 a 179 graus. Esse comportamento é intencional: ele relata mínimos e máximos comuns, sem escolher uma janela de mapa com quebra. Caso seu aplicativo trabalhe com longitudes cíclicas, você pode comparar extensões alternativas após receber esses limites diretos.

Use os limites em mapas e pipelines de dados

Caixas delimitadoras são resumos compactos e funcionam bem no início de muitos fluxos espaciais. Uma interface de mapa pode usar os dois cantos para escolher a visualização inicial. Uma importação pode armazenar os quatro extremos junto ao polígono e usá-los em um teste rápido de sobreposição antes de executar verificações mais caras de ponto no polígono ou interseção. O código de validação pode comparar áreas de serviço esperadas com formas recebidas, enquanto análises podem agrupar limites por extensão geral. Lembre-se de que a caixa contém o polígono, mas não reproduz seu formato: pontos dentro do retângulo ainda podem estar fora de um polígono côncavo, e caixas sobrepostas não provam que os polígonos se cruzam. O cálculo usa latitude e longitude, não um sistema projetado; larguras em graus não são distâncias físicas constantes. Você pode executar uma verificação gratuitamente no navegador ou automatizar solicitações via API por US$ 0,002 por item.

Ajustar a visualização do mapa

Converta vértices em cantos mínimo e máximo para enquadrar todo o limite no cliente de mapas.

Pré-filtrar registros espaciais

Armazene extremos simples para filtrar candidatos antes de testar interseções exatas de polígonos.

Validar a cobertura geográfica

Compare a extensão de uma forma recebida com as faixas permitidas durante uma importação.

Quanto custa o cálculo?

O preço da API é US$ 0,002 por item, e a calculadora no navegador é gratuita nesta página.

A ordem dos vértices importa?

Não. O cálculo encontra separadamente as latitudes e longitudes mínimas e máximas.

Preciso repetir o primeiro vértice no final?

Não. Listas abertas e fechadas geram os mesmos limites quando seus extremos são iguais.

Como polígonos que cruzam o antimeridiano são tratados?

A longitude usa extremos literais de -180 a 180, então a caixa pode ser larga em vez de envolvente.

Este é um teste exato de contenção no polígono?

Não. O retângulo contém os vértices, mas um ponto dentro dele ainda pode estar fora do polígono.

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/polygon-bounding-box

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/polygon-bounding-box \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vertices":[{"lat":40.7128,"lon":-74.006},{"lat":34.0522,"lon":-118.2437},{"lat":41.8781,"lon":-87.6298}]}'
{
  "vertices": [
    {
      "lat": 40.7128,
      "lon": -74.006
    },
    {
      "lat": 34.0522,
      "lon": -118.2437
    },
    {
      "lat": 41.8781,
      "lon": -87.6298
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.polygon_bounding_box",
  "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_items10000
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 →