Um endereço que parece perfeitamente natural em um país pode parecer completamente invertido, ou simplesmente errado, quando estruturado segundo a convenção de outro. A ordem em que aparecem o número, o nome da rua, a localidade, a região e o código postal é uma questão de convenção nacional e, às vezes, regional, e não um modelo universal fixo, e supor que a ordem do seu país é a natural ou a padrão é um dos erros mais comuns e evitáveis ao criar qualquer coisa que lide com endereços internacionais.
Algumas convenções colocam o número antes do nome da rua, outras o colocam depois. Algumas põem o código postal antes do nome da cidade na mesma linha, outras o põem depois, e algumas o colocam em uma linha totalmente separada. A ordem relativa de cidade, região e país também varia, e alguns países estruturam os endereços de cima para baixo pela hierarquia administrativa, de um jeito que parece quase invertido em comparação com as convenções construídas de baixo para cima, a partir do prédio específico.
Isso importa para duas partes bem diferentes de um sistema. O tratamento de entradas, especialmente campos de endereço em texto livre, precisa ser realmente tolerante a variações de formato em vez de esperar um modelo rígido, já que usuários reais digitando endereços do próprio país vão escrevê-los naturalmente na ordem convencional desse país, e não na ordem em torno da qual o seu formulário foi projetado. A formatação de saída, ao exibir um endereço retornado para o usuário, idealmente deve respeitar a convenção do país de destino, em vez de sempre renderizar todos os endereços em um único layout fixo com o número primeiro ou o código postal primeiro, independentemente de onde o endereço esteja de fato, já que um endereço formatado localmente parece natural, enquanto um formatado no padrão estrangeiro parece visivelmente estranho, mesmo quando todos os componentes estão corretos.
A geocodificação em si geralmente é mais resistente à ordem dos componentes do que um parser ingênuo seria, especialmente quando trata a entrada como uma string inteira a ser comparada com dados de referência conhecidos, em vez de esperar os componentes em uma sequência estrita e predeterminada. Dito isso, testar o seu tratamento de endereços especificamente com exemplos formatados corretamente de vários países, e não apenas com versões reordenadas do formato do seu país, vai revelar lacunas na sua própria lógica de validação e de exibição bem antes que usuários internacionais as encontrem diretamente.
Se você está criando entrada ou exibição de endereços para um público internacional, vale a pena testar deliberadamente com alguns países cujas convenções sejam bem diferentes das suas, em vez de supor que um único modelo serve para todos. O nosso endpoint de geocodificação direta foi projetado para tolerar essas variações na própria entrada, mas vale verificar de forma independente, com a mesma variedade, a validação do formulário e a lógica de exibição de endereços ao redor dele.