Localizzare la mappa

Puoi personalizzare la mappa per un paese o una regione specifici nei seguenti modi:

  • Modificare le impostazioni della lingua predefinite.
  • Specifica un codice regione, che modifica il comportamento della mappa in base a un determinato paese o territorio.

Localizzazione della lingua

Per impostazione predefinita, l'API Maps JavaScript utilizza l'impostazione della lingua preferita dell'utente, come specificato nel browser, per visualizzare informazioni di testo come i nomi dei controlli, le notifiche sul copyright, le indicazioni stradali e le etichette sulle mappe. Nella maggior parte dei casi, è preferibile rispettare l'impostazione del browser. Tuttavia, se vuoi che l'API Maps JavaScript ignori l'impostazione della lingua del browser, puoi forzarla a visualizzare le informazioni in una lingua specifica aggiungendo un parametro language al tag <script> durante il caricamento del codice dell'API Maps JavaScript.

Il parametro language influisce sui nomi dei controlli, delle notifiche sul copyright, delle indicazioni stradali e delle etichette di controllo, nonché sulle risposte alle richieste di servizio. L'effetto sui servizi non è così evidente. Ad esempio, quando esegui la geocodifica degli indirizzi a livello di strada, il nome del paese viene restituito nella lingua richiesta, ma il resto dell'indirizzo sarà specifico per la località di cui esegui la geocodifica. I risultati relativi a indirizzi postali e dati politici, invece, vengono restituiti nella lingua richiesta. Prova questa demo per sperimentare le modifiche sulla mappa quando aggiorni il parametro language.

L'esempio seguente mostra una mappa in giapponese e imposta la regione su Giappone:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=JP&language=ja&callback=initMap">
</script>

Visualizza l'esempio.

Se imposti la lingua della mappa, è importante anche considerare l'impostazione della regione. In questo modo, ti assicurerai che la tua applicazione rispetti le leggi locali.

Nota: quando carichi l'API nel modo mostrato sopra, la mappa utilizza la lingua giapponese per tutti gli utenti, indipendentemente dalle preferenze dell'utente. Assicurati di volere questo comportamento prima di impostare questa opzione.

L'API Maps JavaScript supporta anche il testo bidirezionale (Bidi) contenente caratteri in lingue da sinistra a destra (LTR) e da destra a sinistra (RTL) in modo nativo. Esempi di lingue con scrittura da destra a sinistra includono арабский, עברית e فارسی. In genere, devi specificare le pagine in lingua RTL per visualizzarle correttamente aggiungendo dir='rtl' all'elemento <html> della pagina. L'esempio seguente mostra una mappa del Cairo, in Egitto, utilizzando i controlli in arabo:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=EG&language=ar&callback=initMap">
</script>

Visualizza esempio

Consulta l'elenco delle lingue supportate. Tieni presente che vengono aggiunte spesso nuove lingue, pertanto questo elenco potrebbe non essere esaustivo.

Localizzazione della regione

Aggiungi un parametro region al tag <script> quando carichi il codice dell'API Maps JavaScript, se vuoi modificare l'applicazione in modo da pubblicare diversi riquadri della mappa o scompensarla (ad esempio, scompensare i risultati di geocodifica in base alla regione).

In qualità di sviluppatore di un'applicazione API Maps JavaScript, ti consigliamo di impostare sempre un parametro region, in quanto vari servizi (come Place Autocomplete) tendono a fornire risultati migliori quando region è impostato. È inoltre tua responsabilità garantire che la tua applicazione rispetti le leggi locali assicurandoti che venga applicata la localizzazione della regione corretta per il paese in cui è ospitata.

Il parametro region accetta identificatori di sottotag di regione Unicode che (in genere) hanno una mappatura one-to-one ai domini di primo livello nazionali (ccTLD). La maggior parte degli identificatori di regione Unicode è identica ai codici ISO 3166-1 alpha-2, con alcune importanti eccezioni. Ad esempio, il TLD di primo livello della Gran Bretagna è "uk" (corrispondente al dominio .co.uk), mentre il suo identificatore di regione è "GB". Consulta la sezione Dettagli sulla copertura di Google Maps Platform per informazioni sulle regioni supportate. Prova questa demo per sperimentare le modifiche sulla mappa quando aggiorni il parametro region.

Ad esempio, il seguente tag script localizza la mappa nel Regno Unito:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=GB&callback=initMap">
</script>

Gli esempi seguenti mostrano due mappe, una che esegue il geocodifica di "Toledo" in base a un valore region impostato su US (Stati Uniti) per "Toledo, Ohio" e un'altra che assegna un bias ai risultati in base a un valore region impostato su ES (Spagna) per "Toledo, Spagna".

Visualizza l'esempio per gli Stati Uniti e l'esempio per la Spagna.

Demo di localizzazione

Quando imposti la lingua della mappa, è importante considerare anche l'impostazione della regione. Ecco una demo che ti consente di caricare la mappa con la lingua e la regione che preferisci.

Visualizza questa demo in schermo intero.