Localizzare la mappa

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

  • Modificare 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 note sul 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 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 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 l'esempio.

Se imposti la lingua della mappa, è importante prendere in considerazione anche l'impostazione della regione. Ciò contribuisce a garantire che la tua richiesta 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. Assicurati di volere questo comportamento prima di impostare questa opzione.

L'API Maps JavaScript supporta anche in modo nativo il testo bidirezionale (Bidi) contenente caratteri in lingue da sinistra a destra (LTR) e da destra a sinistra (RTL). Esempi di lingue RTL includono arabo, ebraico e farsi. In genere, devi specificare le pagine in lingua RTL per il rendering corretto 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

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 l'applicazione per mostrare 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 della regione per il paese in cui è ospitata l'applicazione.

Il parametro region accetta identificatori di tag secondari di regione Unicode che (generalmente) hanno una mappatura one-to-one con i domini di primo livello nazionali (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 TLD specifico per paese della Gran Bretagna è "uk " (corrispondente al dominio .co.uk), mentre l'identificatore di 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 degli Stati Uniti e l'esempio spagnolo.

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.