Localizzazione della mappa

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Puoi personalizzare la mappa per un paese o un'area geografica specifica 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 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 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, 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, quando geocodifica indirizzi a livello stradale il nome del paese viene restituito nella lingua richiesta, ma il resto dell'indirizzo sarà specifico per la località che stai geocodificando. D'altra parte, i risultati postali e politici vengono restituiti nella lingua richiesta. Prova questa demo per sperimentare con 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 esempio.

Se imposti la lingua della mappa, è importante considerare anche l'impostazione dell'area geografica. In questo modo puoi assicurarti che la tua applicazione rispetti le leggi locali.

Nota: quando carichi l'API come indicato in precedenza, 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 in lingue native da sinistra a destra (LTR) e da destra a sinistra (RTL). Esempi di lingue RTL includono arabo, ebraico e Farsi. In generale, dovresti 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 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 l'esempio

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

Localizzazione per area geografica

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 di mappa diversi o eseguire il bias dell'applicazione (ad esempio, aggiungendo bias ai risultati di geocodifica nell'area geografica).

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

Il parametro region accetta identificatori di tag di regione Unicode che, in generale, hanno una mappatura one-to-one con i domini di primo livello (ccTLD) del 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 Gran Bretagna è "uk" (corrispondente al dominio .co.uk) mentre il relativo identificatore regione è "GB." Consulta i dettagli sulla copertura di Google Maps Platform per le aree geografiche supportate. Prova questa demo per sperimentare con 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>

Gli esempi riportati di seguito mostrano due mappe, una che geocodifica "Toledo" in base a un region impostato su US (Stati Uniti) su "Toledo, Ohio" e uno che ordina i risultati in base a un region impostato su ES (Spagna) su "Toledo; Spagna".

Visualizza l'esempio USA e l'esempio ES.

Demo Localizzazione

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

Guarda questa demo a schermo intero.