ForHosting KIT · Ferramentas para dev

Grade de caixa delimitadora

Transforme uma caixa delimitadora geográfica em uma malha regular completa sem instalar software de SIG nem programar laços de coordenadas.

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

Informe as bordas oeste, sul, leste e norte em graus decimais e o tamanho da célula quadrada. O resultado apresenta as dimensões da grade e a linha, a coluna e os limites exatos de cada célula. As células começam no canto sudoeste, seguem uma ordem previsível e são recortadas nas bordas opostas para cobrir exatamente a caixa solicitada.

Defina a caixa delimitadora e o tamanho da célula

Comece com uma caixa convencional de longitude e latitude. Oeste e leste representam longitudes entre -180 e 180; sul e norte representam latitudes entre -90 e 90. Leste deve ser maior que oeste, e norte deve ser maior que sul. A capacidade não interpreta um valor oeste maior que leste como cruzamento do antimeridiano, pois isso deixaria menos claros a ordem das colunas e o recorte das bordas. Defina cell_size em graus decimais. O mesmo valor controla largura e altura, criando quadrados angulares, não quadrados com a mesma área física. Um grau de longitude corresponde a uma distância menor perto dos polos. Por isso, esta grade é indicada para particionamento geográfico transparente, mosaicos, amostragem e preparação de visualizações que aceitam limites angulares. Se distâncias ou áreas equivalentes forem essenciais, projete primeiro a extensão em um sistema plano apropriado. Escolha um tamanho que ofereça o detalhe necessário sem produzir saída desnecessária. A solicitação é rejeitada antes da alocação se ultrapassar 10,000 células. Esse limite explícito mantém previsíveis o navegador, a API e o processamento posterior de JSON.

Entenda cobertura, recorte e ordenação

A malha fica ancorada exatamente no canto sudoeste informado, e não em uma origem global oculta. A linha zero começa em sul e a coluna zero em oeste. Cada célula normal avança cell_size para o norte e para o leste. Quando a largura ou a altura da caixa não é múltipla exata desse tamanho, as células da última coluna ou linha são encurtadas e recortadas em leste ou norte. Nenhuma célula ultrapassa a caixa solicitada e não sobra lacuna interna. A resposta inclui rows, columns e cell_count para você validar o volume esperado sem recontar o array cells. As células são retornadas por linha: primeiro aparecem todas as colunas da linha mais ao sul, seguidas pelas linhas ao norte. Cada registro contém linha e coluna iniciadas em zero, além de quatro limites numéricos chamados west, south, east e north. As coordenadas são normalizadas para doze casas decimais, eliminando artefatos como 0.30000000000000004 que podem surgir da soma repetida em ponto flutuante. Use diretamente os limites retornados ao desenhar retângulos, montar polígonos, nomear mosaicos ou dividir outro conjunto de dados.

Use uma malha determinística em fluxos de dados

Uma malha gerada é útil sempre que uma área de estudo contínua precisa virar unidades retangulares repetíveis. Um aplicativo cartográfico pode transformar cada registro de limites em um anel poligonal. Um fluxo de amostragem pode atribuir uma tarefa a cada linha e coluna. Um pipeline analítico pode testar pontos contra as células, agregar registros por mosaico ou dividir uma consulta grande em solicitações geográficas menores. Como a origem é a caixa fornecida, duas chamadas geram identificadores correspondentes somente quando west, south, east, north e cell_size são idênticos; guarde essas entradas com qualquer linha e coluna armazenada. A operação é determinística e não usa provedor de mapas, rede, semente aleatória, relógio nem estado compartilhado. Entradas JSON idênticas geram a mesma geometria e ordem. Esta capacidade retorna limites em vez de GeoJSON para manter a resposta compacta e neutra entre formatos de SIG. Ela não calcula centroides, áreas, vizinhos, associação de pontos, interseções nem transformações de coordenadas. Essas etapas podem ser feitas depois a partir dos limites explícitos. A execução interativa no navegador é gratuita; cada solicitação bem-sucedida de API usa o preço-base publicado de US$ 0,002.

Particione uma extensão de mapa

Crie mosaicos estáveis por linha e coluna para agrupar consultas espaciais ou distribuir processamento geográfico.

Prepare unidades de amostragem

Gere unidades retangulares completas sobre uma área de estudo antes de selecionar ou atribuir amostras de campo.

Desenhe uma malha sobreposta

Converta cada registro de limites em retângulo ou polígono para uma camada de SIG ou mapa web.

Quanto custa uma solicitação de API?

Cada solicitação bem-sucedida de API custa US$ 0,002. Você também pode executar gratuitamente o mesmo cálculo determinístico no navegador.

Qual unidade cell_size utiliza?

Graus decimais. O valor controla a largura longitudinal e a altura latitudinal; as células são quadrados angulares, não áreas terrestres iguais.

O que ocorre se a caixa não for divisível pelo tamanho da célula?

A última linha e coluna são recortadas nos limites norte e leste, mantendo cobertura completa sem ultrapassar a caixa.

A caixa pode cruzar o antimeridiano?

Não. Leste deve ser maior que oeste. Divida uma extensão que cruze o antimeridiano em duas caixas convencionais.

Em qual ordem as células são retornadas?

Elas seguem a ordem das linhas: começam no sudoeste, avançam para leste e depois continuam para norte.

Por que existe o limite de 10,000 células?

Ele limita o cálculo e o tamanho da resposta. Aumente cell_size ou divida a caixa quando uma solicitação ultrapassar esse máximo.

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/grid-from-bbox

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/grid-from-bbox \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"west":-2,"south":50,"east":0.5,"north":52,"cell_size":1}'
{
  "west": -2,
  "south": 50,
  "east": 0.5,
  "north": 52,
  "cell_size": 1
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.grid_from_bbox",
  "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_cells10000
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 →