Uma coordenada não sabe qual governo a reivindica. Latitude e longitude são fatos físicos, mas o rótulo administrativo associado a um local, a qual país ele pertence e qual é o seu nome oficial, às vezes é uma questão realmente contestada, com mais de um governo afirmando uma reivindicação legítima sobre o mesmo território. Qualquer API de localização que retorne dados do mundo inteiro acabará sendo consultada sobre um ponto que fica em uma dessas áreas, e a resposta honesta é que não existe uma opção politicamente neutra, apenas escolhas diferentes sobre qual convenção seguir.
A abordagem geral do setor é descrever o que está administrativamente presente no local, o sistema postal local em uso e a estrutura administrativa que de fato opera no dia a dia, em vez de julgar a questão de soberania subjacente, que cabe a governos e organismos internacionais, e não a uma resposta de geocodificação. Isso significa que uma área disputada normalmente ainda retorna dados de localização utilizáveis, como coordenadas, um nome de localidade e a estrutura administrativa que funcione ali, sem que a API embuta uma posição política no rótulo de país que escolher.
É também por isso que a classificação por país em regiões disputadas merece cautela extra se a sua aplicação toma decisões com base nela, como jurisdição tributária, regras de envio ou conformidade legal. Um resultado de geocodificação para uma área disputada deve ser tratado como uma descrição do local e dos dados disponíveis ali, e não como uma declaração oficial sobre soberania para fins legais ou regulatórios. Se o seu caso de uso tem peso jurídico real ligado à jurisdição, verifique com uma fonte criada especificamente para esse fim legal, em vez de depender apenas de uma resposta de geocodificação de uso geral.
Vale a pena separar duas ideias diferentes que muitas vezes são confundidas aqui. A cobertura, ou seja, se uma área disputada retorna algum dado utilizável, é uma questão de cobertura. Qual nome ou código de país é associado a esses dados é uma questão de convenção de rotulagem. Uma região pode ter uma cobertura sólida, com ruas reais, informações postais reais e coordenadas reais, e ainda assim ser uma área em que provedores de dados sensatos fazem escolhas de rotulagem diferentes para o campo de país.
Se você desenvolve para uma base de usuários global, espere essa categoria de caso extremo e projete para ela deliberadamente, em vez de supor que ela não vai aparecer. Trate os campos de localização retornados como descritivos, teste especificamente o seu tratamento de regiões ambíguas ou disputadas e mantenha qualquer decisão de jurisdição juridicamente sensível separada da saída geral de geocodificação. O nosso endpoint de geocodificação reversa busca retornar a descrição mais útil e honesta disponível para uma coordenada, o que, nessas regiões, significa descrever o que existe, em vez de resolver uma disputa que nenhuma API está em posição de resolver.