Tiles slippy para uma caixa delimitadora

Informe oeste, sul, leste, norte e um nível de zoom; a calculadora retornará cada tile intersectado em ordem determinística por linhas. Ela também apresenta intervalos compactos de x e y, indica se a caixa cruza o antimeridiano e se a latitude polar precisou ser limitada ao Web Mercator. Assim, você reproduz estimativas de cache, downloads para uso offline, filas de renderização e verificações de cobertura sem consultar um provedor de tiles.

Defina a área geográfica e o zoom

Informe a caixa delimitadora como oeste, sul, leste e norte em graus decimais WGS84 e escolha um zoom inteiro de 0 a 22. O sul deve ficar abaixo do norte, e oeste e leste precisam ser diferentes. Na maioria das caixas, oeste é menor que leste. Quando oeste é maior, a calculadora interpreta intencionalmente que a área cruza o antimeridiano, evitando que uma região próxima a Fiji ou ao estreito de Bering se expanda por engano por quase todo o planeta. Para abranger todas as longitudes, use -180 no oeste e 180 no leste. O cálculo segue a convenção XYZ conhecida dos mapas slippy: x aumenta de oeste para leste, y aumenta de norte para sul e z representa o zoom selecionado. Latitudes além do limite do Web Mercator são aceitas como entrada geográfica, mas projetadas para a borda representável mais próxima. O resultado sinaliza esse ajuste e explica por que limites polares não produzem linhas extras além das bordas do mapa.

Entenda quais tiles de limite entram na lista

A lista retornada contém tiles que se sobrepõem à caixa com área positiva. Um tile que apenas encosta no limite leste ou sul não é incluído, impedindo que uma caixa perfeitamente alinhada à grade receba uma coluna ou linha desnecessária. As bordas oeste e norte selecionam os tiles imediatamente internos. Esse tratamento semiaberto é especialmente útil no planejamento de cache, pois caixas adjacentes podem ser processadas sem aumentar sistematicamente os dois lados de cada limite compartilhado. Cada tile é um objeto com x, y e z, organizado por linhas de y do norte para o sul. Dentro da linha, x avança de oeste para leste; em uma caixa que cruza o antimeridiano, o segmento ocidental de x altos termina antes da continuação em x zero. A resposta também traz x_ranges e y_range para você consultar ou armazenar a cobertura compacta sem reconstruí-la. A quantidade é calculada antes da alocação, e solicitações acima de 100,000 coordenadas recebem um erro de entrada claro.

Use as coordenadas em um fluxo de cache

Trate a saída como um plano determinístico, e não como conteúdo cartográfico baixado. A capacidade não faz solicitações de rede e desconhece provedor, estilo, extensão de arquivo, token de acesso ou política de uso. Seu aplicativo pode converter cada objeto XYZ em uma URL do provedor, um diretório local como z/x/y, uma chave de banco de dados ou uma tarefa de renderização. Consulte tile_count antes de agendar o trabalho para deixar claros o armazenamento, a largura de banda e as cotas do provedor. Para pacotes offline reproduzíveis, salve os limites e o zoom junto da lista; outra execução com a mesma entrada manterá valores e ordem. Se a região exigir vários níveis, chame a capacidade uma vez por zoom, pois cada nível tem grade própria e contagem crescente. Divida áreas extensas em zoom alto ou planeje primeiro em um nível menor. O preço da API é US$ 0,002 por solicitação; hospedagem e obtenção dos tiles têm custos separados, definidos pelo provedor escolhido.