Localizzare la mappa

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

  • Modifica 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 specificata nel browser quando visualizza informazioni testuali come i nomi dei controlli, le note 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, sulle notifiche di copyright, sulle indicazioni stradali e sulle etichette dei controlli, nonché sulle risposte alle richieste di servizio. L'effetto sui servizi non è così evidente. Ad esempio, quando esegui la geocodifica degli indirizzi a livello stradale, il nome del paese viene restituito nella lingua che hai richiesto, ma il resto dell'indirizzo sarà specifico della località che stai geocodificando. D'altra parte, i risultati postali e politici vengono restituiti nella lingua richiesta. Prova la demo di localizzazione 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 esempio.

Se imposti la lingua della mappa, è importante prendere in considerazione anche l'impostazione della regione. In questo modo, la tua richiesta è conforme alle 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 RTL includono arabo, ebraico e farsi. In genere, devi specificare le pagine in lingua RTL da visualizzare correttamente aggiungendo dir='rtl' all'elemento <html> della pagina. L'esempio seguente esegue il rendering di 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

Lingue supportate

Google aggiorna spesso le lingue supportate. Questo elenco potrebbe non essere esaustivo ed è soggetto a modifiche.

Codice della lingua Lingua Codice della lingua Lingua
af Afrikaans ja Giapponese
sq Albanese kn Kannada
am Amarico kk Kazako
ar Arabo km Khmer
hy Armeno ko Coreano
az Azero ky Kirgizo
eu Basco lo Lao
be Bielorusso lv Lettone
bn Bengalese lt Lituano
bs Bosniaco mk Macedone
bg Bulgaro ms Malese
my Birmano ml Malayalam
ca Catalano mr Marathi
zh Cinese mn Mongolo
zh-CN Cinese (semplificato) ne Nepalese
zh-HK Cinese (Hong Kong) no Norvegese
zh-TW Cinese (tradizionale) pl Polacco
h Croato pt Portoghese
cs Ceco pt-BR Portoghese (Brasile)
da Danese pt-PT Portoghese (Portogallo)
nl Olandese pa Punjabi
it Inglese ro Rumeno
en-AU Inglese (australiano) ru Russo
en-GB Inglese (Gran Bretagna) sr Serbo (cirillico)
et Estone sr-Latn Serbo (alfabeto latino)
fa Farsi si Sinhalese
fi Finlandese sk Slovacco
fil Filippino sl Sloveno
fr Francese es Spagnolo
fr-CA Francese (Canada) es-419 Spagnolo (America Latina)
gl Galiziano sw Swahili
ka Georgiano sv Svedese
de Tedesco ta Tamil
el Greek te Telugu
gu Gujarati th Thailandese
iw Ebraico tr Turco
hi Hindi uk Ucraino
hu Ungherese UK Urdu
è Islandese uz Uzbeco
id Indonesiano vi Vietnamita
it Italiano zu Zulu

Localizzazione della regione

Aggiungi un parametro region al tag <script> quando carichi il codice dell'API Maps JavaScript, se vuoi modificare l'applicazione per pubblicare riquadri della mappa diversi o distorcere l'applicazione (ad esempio distorcere i risultati di geocodifica verso la 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 è impostato region. È inoltre tua responsabilità garantire che la tua applicazione sia conforme alle leggi locali assicurandoti che venga applicata la localizzazione corretta per il paese in cui l'applicazione è ospitata.

Il parametro region accetta identificatori di sottotag di regione Unicode che (generalmente) hanno una mappatura uno a uno con i domini di primo livello nazionali (ccTLD). La maggior parte degli identificatori di regione Unicode sono identici ai codici ISO 3166-1 alpha-2, con alcune eccezioni degne di nota. Ad esempio, il TLD specifico per paese della Gran Bretagna è "uk " (corrispondente al dominio .co.uk), mentre l'identificatore della regione è "GB". Per le regioni supportate, consulta Dettagli della copertura di Google Maps Platform. Prova questa demo per sperimentare le modifiche sulla mappa quando aggiorni il parametro region.

Ad esempio, il seguente tag di 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>

I seguenti esempi mostrano due mappe: una che geocodifica "Toledo" in base a un region impostato su US (Stati Uniti) in "Toledo, Ohio" e una che distorce i risultati in base a un region impostato su ES (Spagna) in "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 a schermo intero.