Localizzazione della mappa

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

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

Localizzazione linguistica

Per impostazione predefinita, l'API Maps JavaScript utilizza l'impostazione della lingua preferita dell'utente specificata nel browser, per la visualizzazione di 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 forzare la visualizzazione delle informazioni in una determinata lingua 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 note 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 indirizzi a livello stradale di geocodifica, il nome del paese viene restituito nella lingua richiesta, ma il resto dell'indirizzo sarà specifico per la località in cui stai geocodificando. I risultati postali e politici sono invece 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 sul 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 considerare anche la possibilità di impostare anche l'area geografica. Ciò contribuisce a garantire che la tua applicazione sia 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 testo bidirezionale (Bidi) contenente caratteri nelle lingue con scrittura da sinistra a destra (LTR) e da destra a sinistra (RTL) in modo nativo. Esempi di lingue con scrittura da destra a sinistra includono l'arabo, l'ebraico e il persiano. In genere, devi specificare le pagine in lingua RTL per eseguire correttamente il rendering aggiungendo dir='rtl' all'elemento <html> della pagina. L'esempio seguente mostra una mappa del Cairo, in Egitto, utilizzando controlli arabi:

<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 spesso vengono aggiunte nuove lingue, pertanto questo elenco potrebbe non essere esaustivo.

Localizzazione delle regioni

Aggiungi un parametro region al tag <script> durante il caricamento del codice dell'API Maps JavaScript, se vuoi modificare l'applicazione per pubblicare riquadri della mappa diversi o polarizzare l'applicazione (ad esempio, polarizzando i risultati di geocodifica in base alla regione).

In qualità di sviluppatore di un'applicazione API Maps JavaScript, ti invitiamo a impostare sempre un parametro region poiché vari servizi (come il completamento automatico di Places) tendono a fornire risultati migliori quando viene impostato il region. È inoltre tua responsabilità garantire che la tua domanda sia conforme alle leggi locali assicurandoti che venga applicata la localizzazione per regione corretta per il paese in cui è ospitata.

Il parametro region accetta identificatori di sottotag della regione Unicode che (in genere) hanno una mappatura one-to-one ai domini di primo livello nazionali (ccTLD). La maggior parte degli identificatori della regione Unicode sono identici ai codici ISO 3166-1 alpha-2, con alcune eccezioni degne di nota. Ad esempio, il ccTLD della Gran Bretagna è "uk " (corrispondente al dominio .co.uk) e l'identificatore della regione è "GB". Consulta i dettagli sulla copertura di Google Maps Platform per le 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>

I seguenti esempi mostrano due mappe, una che codifica i dati di "Toledo" in base a un valore region impostato su US (USA) su "Toledo, Ohio" e una che influenza i risultati in base a un valore region impostato su ES (Spagna) su "Toledo, Spagna".

Visualizza l'esempio US e l' esempio ES.

Demo localizzazione

Quando imposti la lingua della mappa, è importante considerare anche la possibilità di impostare anche la 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.