Desprojeção Web Mercator

Tiles, camadas vetoriais e exportações SIG frequentemente armazenam posições como easting e northing em metros em uma esfera de raio 6378137 metros em vez de graus de latitude e longitude. Esta capacidade realiza essa conversão de forma determinística a partir de dois campos numéricos, rejeita coordenadas que caem fora da extensão quadrada do mundo projetado usada por mapas slippy, e devolve JSON estruturado com nomes de campo curtos e longos para lon e lat.

O que a desprojeção Web Mercator calcula e quais entradas são válidas

Envie os campos obrigatórios x e y como números finitos medidos em metros em EPSG:3857, também conhecido como Pseudo-Mercator de Visualização Popular ou o sistema projetado de Bing e Google Maps. A longitude se recupera como x dividido pelo raio da esfera vezes cento e oitenta sobre pi; a latitude como duas vezes o arco-tangente de e elevado a y sobre R, menos pi sobre dois, depois convertida em graus. A extensão mundial publicada é mais ou menos pi vezes R metros, cerca de vinte milhões trezentos e setenta e cinco mil e oito metros em cada eixo. Cadeias numéricas são analisadas quando casam com notação decimal ou científica ordinária. O motor interpreta x como easting e y como northing relativos à origem equador e meridiano de Greenwich em zero zero. Valores fora desse quadrado são invalid_input porque ficam além do recorte de latitude perto de mais ou menos oitenta e cinco ponto zero cinco graus onde o mapa Mercator se torna infinito. Aliases mercator_x e easting para x, e mercator_y e northing para y, são aceitos para payloads orientados a SIG. Campos ausentes, valores não finitos e coordenadas fora da extensão nunca produzem um NaN silencioso; falham com mensagem clara invalid_input e não são cobrados. Entradas idênticas sempre produzem o mesmo JSON porque o caminho é aritmética pura sem rede, sem semente aleatória e sem relógio de parede.

Lendo lon, lat, rótulos CRS e constantes de extensão

Use lon e lat ao construir coordenadas GeoJSON Point em ordem longitude primeiro; use latitude e longitude ao vincular a rótulos de UI que preferem os nomes longos. A origem zero zero se desprojeta para a ilha nula do Golfo da Guiné a zero graus norte e zero leste. x positivo move para leste; y positivo para norte até o recorte polar. A projeção direta de lat/lon para metros fica intencionalmente fora de escopo para esta página se concentrar na intenção de busca de desprojeção. O campo crs_in é sempre EPSG:3857 e crs_out sempre EPSG:4326 para que o código a jusante afirme a transformação sem cheirar formas. radius_m informa seis milhões trezentos e setenta e oito mil cento e trinta e sete, o semi-eixo maior WGS-84 que EPSG:3857 usa como raio de esfera, e max_extent_m informa pi vezes esse raio para clientes validarem no lado do cliente antes de chamar a API. O rótulo method é sempre web_mercator_inverse. Combine este endpoint com ferramentas de tile ou quadkey quando já tiver índices de pixel ou tile e ainda precisar de graus geográficos para um marcador.

Uso da API, preços, fluxos SIG e limites práticos

Envie um corpo JSON com x e y numéricos em metros Web Mercator. Use a API pré-paga quando um backend de mapas, job ETL ou cache offline móvel precisar de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. Autores de SDK podem mapear os campos lon e lat diretamente em alvos de câmera de mapa, enquanto pipelines analíticos podem armazenar radius_m e max_extent_m junto ao resultado para trilhas de auditoria.