O Nominatim ocupa um lugar incomum entre as opções de geocodificação porque é ao mesmo tempo um software de código aberto que você pode executar por conta própria e uma instância pública de demonstração que qualquer pessoa pode consultar diretamente, regida por uma política de uso que espera um cabeçalho User-Agent descritivo e um ritmo razoável de requisições, em vez de uma chave de API formal. A resposta JSON inclui uma string display_name, um par lat e lon como strings em vez de números e um objeto address com as convenções de tags do próprio OpenStreetMap, como road, suburb e postcode.
As equipes costumam bater no teto da instância pública quando o tráfego cresce além do que um recurso comunitário compartilhado deve absorver, e auto-hospedar o Nominatim é uma opção real, mas pesada: exige baixar e importar um grande extrato de dados do OpenStreetMap, do planeta inteiro ou de uma região, manter esses dados atualizados e operar a infraestrutura de servidores por conta própria indefinidamente. Essa troca, trabalho de infraestrutura e manutenção em troca de controle, merece uma avaliação honesta antes de se comprometer com qualquer um dos caminhos.
O host compatível com Nominatim do My Geocode reproduz exatamente a estrutura dos campos display_name, lat, lon e de endereço, e os textos de copyright, termos e privacidade são o único conteúdo que difere da saída do próprio Nominatim. Os detalhes de referência estão em /compatibility/nominatim/. O código escrito para a instância pública do Nominatim, incluindo os campos de coordenadas do tipo string, deve interpretar as respostas do host compatível sem alterações.
O que de fato muda nesta migração específica:
X-API-Key, cabeçalho Authorization: Bearer, autenticação HTTP Basic ou parâmetro de consultaAlém da cota gratuita, os preços são crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês, e todos os endpoints, incluindo este host compatível, têm o mesmo preço de qualquer outro na plataforma.
Para equipes que valorizavam especificamente a base do Nominatim em dados geográficos abertos, vale saber que a nomenclatura de campos construída sobre as convenções do OpenStreetMap, como suburb e postcode em vez de termos mais genéricos, se mantém na estrutura deste host compatível, então o vocabulário de endereço que o seu código já espera deve continuar fazendo sentido do outro lado da migração.