Os limites administrativos dentro de um país, regiões, províncias, distritos, não são mais permanentes do que as regras de fuso horário. Os governos os redesenham periodicamente: fundindo unidades menores em maiores, dividindo uma unidade grande em menores, ajustando uma linha de limite para refletir o crescimento populacional ou renomeando uma região inteira como parte de uma reorganização administrativa mais ampla. Cada uma dessas mudanças se propaga para todos os conjuntos de dados que fazem referência ao limite antigo, e essa propagação raramente se completa em todos os lugares ao mesmo tempo.
O efeito imediato recai sobre qualquer endereço ou coordenada cujo rótulo administrativo depende do limite que mudou. Um endereço que corretamente indicava o nome de uma região antes de um ajuste de limite pode precisar indicar outra região depois, mesmo que o prédio físico não tenha se movido um centímetro, e a coordenada desse prédio continua exatamente tão precisa quanto sempre foi, já que as coordenadas descrevem a posição física, enquanto os rótulos administrativos descrevem uma designação legal sobreposta a essa posição.
Isso cria um desafio real e específico para manter os dados de localização atualizados, porque sistemas diferentes que fazem referência à mesma geografia subjacente se atualizam em ritmos diferentes. Os registros oficiais do próprio governo são atualizados no momento em que a mudança entra em vigor legalmente. Os conjuntos de dados de terceiros que fazem referência a limites administrativos, e os sistemas internos construídos sobre eles, geralmente ficam para trás em alguma medida, e o tamanho desse atraso depende inteiramente da frequência com que essa fonte de dados é atualizada e da rapidez com que ela consegue identificar e propagar uma mudança de limite depois que ela ocorre. Até que essa fonte de dados se atualize, uma consulta a ela pode retornar um rótulo administrativo tecnicamente desatualizado, mesmo que a coordenada em si nunca tenha estado errada.
Para quem constrói sobre esse tipo de dado, a implicação prática é tratar os rótulos administrativos, em especial os nomes de regiões e distritos, como dados com ritmo de atualização próprio, separado das coordenadas subjacentes, que são mais estáveis, e esperar que as mudanças de limites criem um período de transição em que sistemas diferentes podem discordar brevemente sobre qual rótulo administrativo se aplica atualmente a uma determinada área. Essa é uma categoria real e recorrente de manutenção de dados, não uma anomalia ocasional, e construir sistemas que tolerem um rótulo administrativo desatualizado sem efeitos catastróficos mais adiante é mais realista do que supor que os dados de limites ficam permanentemente fixos depois de compilados.
As coordenadas e os componentes administrativos retornados pelos nossos endpoints de geocodificação reversa e consulta de código postal refletem dados de limites mantidos atualmente e, como qualquer fonte de dados de localização, se beneficiam de ser atualizados em um cronograma que leve em conta que a geografia administrativa, ao contrário da geografia física, é algo que um governo pode redesenhar, e de fato redesenha, periodicamente.
Um endereço no centro de uma cidade bem mapeada quase não diz nada sobre como o seu sistema lida com uma estrada rural, uma fronteira disputada ou uma consulta perto dos polos. Teste os casos difíceis de propósito.
Nem todo conjunto de dados com informações de localização de aparência pública pode ser usado legalmente dentro de um produto pago. Os termos de licenciamento, e não a disponibilidade técnica, costumam definir o limite real.
Quando uma consulta realmente não pode ser resolvida de forma confiável, não retornar nada é uma resposta melhor do que retornar um palpite disfarçado de fato. Veja o raciocínio por trás dessa escolha.