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 altera 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 come specificato nel browser quando mostra informazioni testuali come i nomi per i 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> quando carichi il codice dell'API Maps JavaScript.

Il parametro language influisce sui nomi di controlli, note di copyright, indicazioni stradali ed etichette di controllo, nonché sulle risposte alle richieste di servizio. L'effetto sui servizi non è altrettanto evidente. Ad esempio, quando geocodificati a livello di strada il nome del paese viene restituito nella lingua che hai richiesto, ma il resto dell'indirizzo sarà specifico per la località che stai creando. D'altro canto, i risultati postali e politici 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 sul Giappone:

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

Visualizza l'esempio.

Se imposti la lingua della mappa, è importante considerare anche l'impostazione dell'area geografica. Ciò contribuisce a garantire 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 i caratteri sia da sinistra a destra (LTR) da sinistra a destra (RTL) da destra a sinistra in modo nativo. Esempi di lingue RTL includono arabo, ebraico e farsi. In genere, devi specificare le pagine nella 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 i controlli arabi:

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

Visualizza esempio

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

Localizzazione per 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 riquadri della mappa diversi o polarizzare l'applicazione, ad esempio per correggere i risultati di geocodifica in base all'area geografica.

In qualità di sviluppatore di un'applicazione API Maps JavaScript, ti invitiamo a impostare sempre un parametro region, in quanto vari servizi (come il completamento automatico di Places) tendono a fornire risultati migliori quando viene impostato l'region. Inoltre, è tua responsabilità garantire che l'applicazione rispetti le leggi locali garantendo che venga applicata la localizzazione corretta per il paese in cui è ospitata.

Il parametro region accetta identificatori di sottotag di regione Unicode che, in generale, hanno una mappatura one-to-one sui domini di primo livello con codice paese (ccTLD). La maggior parte degli identificatori di regione Unicode è identica ai codici ISO 3166-1 alpha-2, con alcune eccezioni degne di nota. Ad esempio, il ccTLD britannico è "uk" (corrispondente al dominio .co.uk), mentre 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&region=GB&callback=initMap">
</script>

I seguenti esempi mostrano due mappe, una con geocodifica "Toledo" basata su un valore di region impostato su US (Stati Uniti) su "Toledo, Ohio" e uno di bias nei risultati basato su un valore di region impostato su ES (Spagna) su "Toledo, Spagna".

Visualizza l'esempio per gli Stati Uniti e l'esempio per ES.

Demo Localizzazione

Quando imposti la lingua della mappa, è importante prendere in considerazione anche l'impostazione della regione. Ecco una demo che ti consente di caricare la mappa con la lingua e la regione che hai scelto.

Visualizza la demo in schermo intero.