Pergunte o que um código postal representa e a resposta honesta é que depende inteiramente de qual país o emitiu. Não existe um padrão internacional para a granularidade do código postal, apenas um conceito geral, aplicado de forma diferente em cada lugar, de que uma autoridade postal nacional define um formato de código adequado à sua própria rede de entregas. O resultado são níveis de precisão muito diferentes dependendo de onde você olha.
Os postcodes do Reino Unido ficam na ponta mais fina do espectro. Um postcode completo, incluindo a parte externa (outward) e a interna (inward), muitas vezes se restringe a uma única rua, a um trecho curto dela ou, em áreas densas, a um pequeno punhado de edifícios. Isso faz de um postcode britânico, sozinho, um dado de localização realmente útil, mais próximo em valor prático de um endereço parcial do que de um simples código de área.
Os ZIP codes dos Estados Unidos funcionam em um nível muito mais amplo. Um ZIP code normalmente cobre uma área de entrega que pode abranger uma parte considerável de uma cidade pequena ou um pedaço de uma cidade grande, às vezes contendo milhares de endereços e cobrindo uma área física significativa. Um ZIP code indica o bairro geral ou a zona de entrega, não uma rua específica, e tratá-lo como equivalente a um postcode britânico em termos de precisão levará a suposições erradas.
Os outros países ficam em algum ponto entre esses dois extremos, e alguns nem usam uma grade numérica ou alfanumérica da forma como o Reino Unido ou os Estados Unidos usam. Os códigos postais do Canadá se aproximam dos britânicos em granularidade, restringindo-se a uma área pequena ou até a um único edifício no caso de endereços de alto volume. Muitos países usam códigos que correspondem mais a um distrito ou a uma localidade do que a uma área de coordenadas. Há uma variação real aqui que vale a pena verificar país por país, em vez de presumir que um único padrão se aplica universalmente.
Isso afeta diretamente qualquer coisa que infira a localização a partir de um código postal. Usar apenas um ZIP code para posicionar um cliente nos Estados Unidos o coloca em algum lugar dentro de uma área bastante ampla, o que serve para análises regionais e é arriscado para qualquer coisa que exija mais precisão. Usar um postcode britânico para o mesmo fim deixa você muito mais perto de um endereço exato, às vezes perto o suficiente para ser confundido com um. Criar uma lógica que presume precisão postal uniforme entre países é uma das fontes mais comuns de problemas silenciosos de precisão no tratamento internacional de endereços.
A nossa consulta de código postal recebe um código junto com o país no formato ISO 3166-1 alpha-2 e retorna as coordenadas e os componentes administrativos correspondentes, para que você possa verificar exatamente com que precisão um determinado código é resolvido antes de confiar nele como sinal de localização.
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.