ForHosting KIT · Viagens e geografia

União de caixas delimitadoras

Duas caixas, uma de latitude 40,7 a 40,8 e outra de 40,75 a 40,9, viram uma só de 40,7 a 40,9; no sentido leste-oeste, ela vai de −74,1 a −73,85. Você recebe ainda largura, altura, área e centro. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Latitude mínima A
40,7
Latitude máxima A
40,8
Longitude mínima A
-74,1
Longitude máxima A
-73,9
Latitude mínima B
40,75
Latitude máxima B
40,9
Você obtém
Latitude mínima
40,7
Latitude máxima
40,9
Longitude mínima
-74,1
Longitude máxima
-73,85

Uma calculadora de união de caixas delimitadoras recebe dois retângulos geográficos definidos por latitude e longitude mínimas e máximas e devolve o menor retângulo alinhado aos eixos que contém por completo os dois. Pipelines de mapas costumam reunir envelopes separados —um por camada, cluster ou tile de download— e precisam de um único viewport, janela de consulta ou extensão de exportação sem montar uma biblioteca geométrica pesada.

O que é a união de caixas delimitadoras e quando você precisa dela

Uma caixa delimitadora geográfica alinhada aos eixos é o retângulo definido por uma latitude sul, uma latitude norte, uma longitude oeste e uma longitude leste. Quando você já tem dois retângulos desse tipo —vindos de consultas de feições independentes, caches de tiles, pacotes offline ou microsserviços irmãos— muitas vezes precisa do único envelope que cobre todos os cantos de ambos sem calcular uma dissolução completa de multipolígonos.

A união clássica de caixas alinhadas usa extremos componente a componente: a borda sul da união é a menor das duas bordas sul; a norte é a maior das duas bordas norte; a oeste é a menor das duas longitudes ocidentais; a leste é a maior das duas longitudes orientais. Essa construção é o menor retângulo alinhado que ainda contém as duas entradas, medido no mesmo sistema lat/lon.

Professores, estudantes de SIG e engenheiros de backend exigem que intervalos invertidos (mín maior que máx) sejam erros duros: trocar cantos em silêncio esconderia bugs do cliente e produziria envelopes que não batem com as camadas pretendidas. Casos aninhados resolvem-se com a mesma regra min/max: se a caixa A está totalmente dentro de B, a união é B; se são idênticas, a união é qualquer uma.

Caixas disjuntas ainda produzem um envelope válido que cobre o vão entre elas —útil para enquadrar a câmera do mapa mesmo quando as camadas não se sobrepõem. Esta página é para quem já tem duas bboxes e precisa da extensão combinada, não para quem só tem um centro e um raio (use antes uma ferramenta de caixa ponto-raio) nem para quem precisa de buffers geodésicos em um elipsoide.

Mesclar envelopes de camadas e consultas para viewports

Combine duas caixas delimitadoras independentes de camadas de feições em uma única extensão de câmera ou de pedido de tiles que cubra toda a geometria retornada.

Pré-filtros espaciais SQL entre microsserviços

Una os envelopes de resultado do serviço A e do serviço B em uma única janela BETWEEN antes de um join ou refinamento por distância mais pesado.

Como a caixa delimitadora da união é calculada?

Essa é a menor caixa alinhada que contém as duas entradas.

Por que um mín maior que o máx é rejeitado?

Um intervalo invertido quase sempre é bug do cliente.

Isso trata o antimeridiano?

A ferramenta aplica min/max puro e não inventa multipolígono que cruza a linha de data. Prepare intervalos desenrolados no cliente se precisar desse caso.

A calculadora de união de caixas delimitadoras é grátis?

A ferramenta do navegador é grátis e roda localmente.

O que acontece se uma caixa estiver toda dentro da outra?

A união é simplesmente a caixa maior, porque as bordas dela já são os extremos. Se as duas caixas forem idênticas, a união é igual a qualquer uma delas. A mesma regra de mínimos e máximos resolve os dois casos.

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/bbox-union

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/bbox-union \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"min_lat_a":40.7,"max_lat_a":40.8,"min_lon_a":-74.1,"max_lon_a":-73.9,"min_lat_b":40.75,"max_lat_b":40.9,"min_lon_b":-74.05,"max_lon_b":-73.85}'
{
  "min_lat_a": 40.7,
  "max_lat_a": 40.8,
  "min_lon_a": -74.1,
  "max_lon_a": -73.9,
  "min_lat_b": 40.75,
  "max_lat_b": 40.9,
  "min_lon_b": -74.05,
  "max_lon_b": -73.85
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.bbox_union",
  "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.

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.

Informe oito cantos finitos em graus decimais (mín e máx de lat e lon para a caixa A e a B); a ferramenta devolve min_lat, max_lat, min_lon e max_lon da união, um array bbox no estilo GeoJSON [west, south, east, north], largura e altura em graus, área em graus ao quadrado, o centro, as caixas de entrada, um indicador de relação para casos idênticos ou aninhados, e linhas de derivação passo a passo. Caixas invertidas e coordenadas fora do intervalo falham com invalid_input para que você não publique um intervalo trocado em silêncio. O caminho é aritmética determinística pura —sem rede, sem sementes aleatórias, sem relógio— de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após o arredondamento decimal fixo em cada chamada.

Como chamar a API e o que volta na resposta

Os campos de latitude devem estar no intervalo fechado de menos noventa a noventa; os de longitude, de menos cento e oitenta a cento e oitenta. Envie um corpo JSON com oito números finitos obrigatórios: min_lat_a, max_lat_a, min_lon_a e max_lon_a para a primeira caixa, e min_lat_b, max_lat_b, min_lon_b e max_lon_b para a segunda. Dentro de cada caixa, min_lat deve ser menor ou igual a max_lat e min_lon menor ou igual a max_lon. Os nomes canônicos aceitam aliases como south_a, north_a, west_a, east_a e as formas _b correspondentes, além de alternativas no estilo lat_min_a, para que clientes existentes mapeiem nomes GIS comuns sem reescrever. Em caso de sucesso a resposta define min_lat, max_lat, min_lon e max_lon da união; define bbox como a quádrupla min_lon, min_lat, max_lon, max_lat na ordem west-south-east-north; define width_deg, height_deg e area_deg2 por aritmética de graus; define center_lat e center_lon como o ponto médio da união; devolve box_a e box_b com cantos arredondados; define relation como identical, a_inside_b, b_inside_a ou partial_or_disjoint; define message como um resumo curto em inglês; e define steps como um array ordenado de linhas de derivação para logs ou interface. Validação falha —campos ausentes, números não finitos, latitude ou longitude fora do intervalo, ou um mín maior que o máx— devolve invalid_input e não é cobrada. O preço é um US$ 0,002 fixo por pedido bem-sucedido com unidade item.

Dicas práticas, limites e buscas relacionadas

Mantenha as duas caixas no mesmo CRS geográfico e em graus decimais; não misture metros web-mercator com graus lat/lon na mesma chamada. Perto dos polos um grau de longitude é curto em metros, então use a união para indexação e enquadramento do viewport e refine com medidas projetadas ou geodésicas se precisar de área física. Esta landing mira quem busca união de caixas delimitadoras, mesclar duas bounding boxes, envelope lat lon de duas caixas ou extensão geográfica combinada; não é buffer ponto-raio, nem codificador geohash, nem dissolução de polígonos. Prefira esta capacidade quando você já tem dois envelopes alinhados e só precisa do retângulo contêiner; se a fonte é um conjunto multiponto, calcule um bbox multiponto. Lembre-se de que um envelope em graus não é área geodésica real: width_deg e height_deg são spans angulares, e area_deg2 é o produto deles para comparações rápidas, não metros quadrados no elipsoide. Para trabalho centrado no Pacífico perto do antimeridiano, garanta que cada entrada já tenha min_lon menor ou igual a max_lon no sentido não enrolado que você escolheu; esta ferramenta não inventa um multipolígono que cruza a linha de data, porque o contrato do produto é min e max componente a componente. Exemplos emparelhados: dois bairros sobrepostos de Manhattan que expandem bordas sul e leste; uma caixa pequena aninhada em uma de escala urbana com relation a_inside_b; e uma caixa invertida de propósito que demonstra o caminho duro invalid_input. Tarefas que falham com invalid_input não consomem saldo pré-pago, o que mantém baratos scripts exploratórios quando se enviam intervalos invertidos de propósito. Checagens de ida e volta são simples: recalcule à mão o mínimo dos dois min_lat e confirme que a resposta coincide dentro do arredondamento a doze casas publicado.

Planejamento de pacotes offline e extensão de exportação

Com dois pacotes regionais já descritos como caixas lat/lon, calcule de forma determinística a extensão combinada de download ou impressão para fixtures de CI.

E se uma caixa estiver totalmente dentro da outra?

A união é igual à caixa exterior. A resposta define relation como a_inside_b ou b_inside_a para que os clientes detectem o aninhamento sem checagens extras.

Ver a documentação completa do KIT →