Localizza la mappa

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

  • Modificare le impostazioni predefinite della lingua.
  • Specifica un codice regione, che altera il comportamento della mappa in base a un paese o territorio.

Localizzazione della lingua

Per impostazione predefinita, l'API Maps JavaScript utilizza il metodo l'impostazione della lingua come specificato nel browser, quando viene visualizzato informazioni quali i nomi dei controlli, delle note sul copyright, dei indicazioni stradali ed etichette sulle mappe. Nella maggior parte dei casi, è preferibile rispettare impostazione del browser. Tuttavia, se vuoi API Maps JavaScript per ignorare di lingua, puoi forzare la visualizzazione delle informazioni in una determinata lingua aggiungendo un parametro language alla <script> durante il caricamento Codice dell'API Maps JavaScript.

Il parametro language influisce sui nomi dei controlli, sul copyright avvisi, indicazioni stradali ed etichette di controllo, nonché le risposte alle richieste di servizio. L'effetto sui servizi non è così evidente. Ad esempio, quando per geocodificare indirizzi a livello stradale il cui nome viene restituito nella lingua che hai richiesto, ma il resto dell'indirizzo sarà specifico per la località di geocodifica. Invece, i risultati postali e politici sono restituito nella lingua richiesta. Prova questa demo per sperimentare le modifiche sulla mappa quando aggiorni 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 esempio.

Se imposti la lingua della mappa, è importante valuta la possibilità di impostare anche l'regione. Questo aiuta a garantire che la tua applicazione sia conforme alle leggi locali.

Nota: quando carichi l'API nel modo descritto in precedenza, 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 (Bidi) contenente caratteri sia da sinistra a destra (LTR) che lingue con scrittura da destra a sinistra (RTL). Esempi di lingue RTL includono: Arabo, ebraico e persiano. In genere, dovresti specificare le pagine in lingua RTL per vengono visualizzati correttamente aggiungendo dir='rtl' al parametro Elemento <html>. L'esempio seguente mostra una mappa di Il Cairo, Egitto, con 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. Tieni presente che vengono aggiunte spesso nuove lingue, pertanto questo elenco potrebbe non esaustivi.

Localizzazione della regione

Aggiungi un parametro region al tag <script> durante il caricamento del codice dell'API Maps JavaScript, se vuoi modificare la tua applicazione per mostrare riquadri della mappa diversi o polarizzare dell'applicazione (ad esempio la differenziazione dei risultati di geocodifica verso una regione).

Come sviluppatore di un'API Maps JavaScript per l'applicazione ti consigliamo di impostare sempre un parametro region come vari servizi (come Places Autocomplete) tendono a fornire risultati migliori quando region è impostato. È inoltre tua responsabilità garantire che la tua applicazione rispetti le leggi locali verificando che venga applicata la localizzazione corretta della regione per il paese in cui viene presentata la domanda in hosting.

Il parametro region accetta Gli identificatori dei sottotag della regione Unicode che (generalmente) hanno un mappatura one-to-one sui domini di primo livello (ccTLD) con codice paese. La maggior parte dei codici Unicode identificatori di regione sono identici ai codici ISO 3166-1 alpha-2, con alcuni degne di nota. Ad esempio, il ccTLD della Gran Bretagna è "uk". (corrispondenti al dominio .co.uk) mentre l'identificatore di regione è "GB". Consulta Dettagli sulla copertura di Google Maps Platform per regioni supportate. Prova questa demo per sperimentare le modifiche sulla mappa quando aggiorni region.

Ad esempio, il seguente tag script localizza la mappa nell'area Regno:

<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 per "Toledo" in base a region impostato su US (USA) su "Toledo, Ohio" e uno che influenza i risultati in base a un valore region impostato su ES (Spagna) a "Toledo, Spagna".

Visualizza Stati Uniti esempio e ES esempio.

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.