Localizza la mappa

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

  • Modificare le impostazioni predefinite della lingua.
  • Specifica un codice regione, che altera 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, quando vengono visualizzate 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 le impostazioni del browser. Tuttavia, se vuoi che l'API Maps JavaScript ignori l'impostazione della lingua del browser, puoi forzarne 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, sulle note sul copyright, sulle indicazioni stradali e sulle etichette di controllo, nonché sulle risposte alle richieste di servizio. L'effetto sui servizi non è così evidente. Ad esempio, per la geocodifica degli indirizzi a livello stradale, il nome del paese viene restituito nella lingua richiesta, ma il resto dell'indirizzo sarà specifico per la località per cui stai geocodificando. Invece, 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&loading=async&region=JP&language=ja&callback=initMap">
</script>

Visualizza esempio.

Se imposti la lingua della mappa, è importante prendere in considerazione anche l'impostazione dell'regione. Ciò contribuisce a garantire che la tua applicazione rispetti le leggi locali.

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

L'API Maps JavaScript supporta anche testo bidirezionale (Bidi) contenente caratteri sia in lingua da sinistra a destra (LTR) che da destra a sinistra (RTL) in modo nativo. Esempi di lingue RTL includono l'arabo, l'ebraico e il farsi. In genere, devi specificare le pagine in lingua RTL affinché vengano visualizzate 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 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 vengono aggiunte spesso nuove lingue, quindi 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 la tua applicazione per pubblicare riquadri della mappa diversi o differenziazione dell'applicazione (ad esempio differenziazione dei 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, in quanto vari servizi (come Places Autocomplete) tendono a fornire risultati migliori quando è impostato region. È inoltre tua responsabilità garantire che l'applicazione rispetti le leggi locali, assicurandoti che venga applicata la localizzazione corretta per la regione 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 (ccTLD) con codice paese. 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 della Gran Bretagna è "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&loading=async&region=GB&callback=initMap">
</script>

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

Visualizza l'esempio US e l'esempio ES.

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.

Guarda la demo a schermo intero.