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®ion=JP&language=ja&callback=initMap">
</script>
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®ion=EG&language=ar&callback=initMap">
</script>
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®ion=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.