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