Suggerisci lingua e area geografica preservando la scelta dell'utente
Usa il contesto disponibile del visitatore per offrire un punto di partenza utile per lingua, area geografica e valuta — poi ricorda la preferenza esplicita del visitatore invece di ricalcolarla dalla posizione a ogni visita.
Precedenza delle preferenze
Controlla prima l'eventuale scelta esplicita salvata — un cookie, un'impostazione dell'account o un parametro di query che il visitatore ha impostato lui stesso. Ricorri a un suggerimento derivato dall'IP solo quando non esiste alcuna scelta esplicita, e non lasciare mai che una nuova chiamata a /v1/geo sovrascriva una preferenza già impostata dal visitatore.
Paese IP contro lingua del browser
Rispondono a domande diverse e possono essere in disaccordo. Un visitatore francofono che si connette dal Canada potrebbe risolversi a country: "CA" da /v1/geo, mentre l'header Accept-Language del suo browser (usato da locale.suggestedLocale) riflette già "fr" — combina il country con il locale.suggestedLocale della risposta stessa invece di indovinare una lingua dal solo codice paese, e tratta il risultato come un suggerimento, non come una destinazione di reindirizzamento.
Campi locale e valuta
geo.locale.suggestedLocale, measurementSystem, firstDayOfWeek e dateFormat forniscono valori predefiniti di formattazione regionale; geo.currency fornisce un'ipotesi di valuta di partenza. Tutto ciò è un suggerimento iniziale derivato dal paese e dagli header della richiesta, non una preferenza verificata.
Quando manca la posizione
locale, currency e country sono nullable — una richiesta da una rete non risolvibile restituisce null anziché un'ipotesi. Ricorri alla lingua e alla formattazione predefinite del tuo sito invece di bloccare la pagina in attesa di un valore che potrebbe non arrivare.
Mantieni gli URL di lingua stabili e indicizzabili
Offri un selettore visibile invece di un reindirizzamento automatico a ogni visita. Un reindirizzamento permanente basato sull'IP rende una versione linguistica irraggiungibile a un URL stabile sia per i motori di ricerca sia per i visitatori su una rete inattesa, come una VPN o una connessione d'albergo.
Cosa questo non garantisce
Un paese derivato dall'IP non è prova della preferenza linguistica, della cittadinanza o della presenza fisica — un viaggiatore, un utente VPN o una rete aziendale condivisa possono tutti risolversi in un luogo che il visitatore non associa realmente alla propria lingua preferita. Tratta ogni suggerimento come reversibile.