Sugira uma língua e região preservando a escolha do utilizador
Utilize o contexto disponível do visitante para oferecer um ponto de partida útil para a língua, região e moeda — e depois memorize a preferência explícita do visitante em vez de a voltar a derivar da localização em cada visita.
Precedência de preferências
Verifique primeiro se existe uma escolha explícita guardada — um cookie, uma definição de conta ou um parâmetro de consulta que o próprio visitante definiu. Recorra a uma sugestão derivada do IP apenas quando não existir uma escolha explícita, e nunca deixe que uma nova chamada a /v1/geo substitua uma preferência que o visitante já tenha feito.
País por IP versus língua do navegador
Estas respondem a perguntas diferentes e podem discordar. Um visitante de língua francesa a ligar-se a partir do Canadá pode resolver para country: "CA" a partir de /v1/geo, enquanto o cabeçalho Accept-Language do seu navegador (utilizado por locale.suggestedLocale) já reflete "fr" — combine o país com o próprio locale.suggestedLocale da resposta em vez de adivinhar uma língua apenas a partir do código de país, e trate o resultado como uma sugestão, não como um destino de redirecionamento.
Campos de configuração regional e moeda
geo.locale.suggestedLocale, measurementSystem, firstDayOfWeek e dateFormat dão predefinições de formatação regional; geo.currency dá uma estimativa inicial de moeda. Tudo isto é uma sugestão inicial derivada do país e dos cabeçalhos do pedido, não uma preferência verificada.
Quando não há localização
locale, currency e country podem ser nulos — um pedido de uma rede não resolvível devolve null em vez de uma estimativa. Recorra à língua e formatação predefinidas do seu próprio site em vez de bloquear a página enquanto espera por um valor que pode nunca chegar.
Mantenha os URLs de língua estáveis e indexáveis
Ofereça um seletor visível em vez de um redirecionamento automático em cada visita. Um redirecionamento permanente baseado em IP torna uma versão linguística inacessível num URL estável, tanto para motores de busca como para visitantes numa rede inesperada, como uma VPN ou uma ligação de hotel.
O que isto não garante
Um país derivado do IP não é prova de preferência linguística, cidadania ou presença física — um viajante, utilizador de VPN, ou uma rede corporativa partilhada podem todos resolver para um local com o qual o visitante não se identifica realmente para a sua língua preferida. Trate cada sugestão como reversível.