Creare e utilizzare gli stili di mappa

Seleziona la piattaforma: Android Android 3D iOS iOS 3D JavaScript Servizio web

Uno stile di mappa è un insieme di personalizzazioni visive degli elementi della mappa che associ a un ID mappa. Fai riferimento all'ID mappa nel codice dell'applicazione per visualizzare la mappa personalizzata.

Puoi creare uno stile di mappa prima di avere un ID mappa, ma per utilizzarlo devi associarlo a un ID mappa. Per utilizzare uno stile di mappa, devi seguire tutti questi passaggi:

  1. Crea e pubblica uno stile di mappa. Per maggiori dettagli, consulta Creare uno stile e Pubblicare uno stile.

  2. Crea un ID mappa. Per maggiori dettagli, consulta Creare un ID mappa.

  3. Associa lo stile di mappa a un ID mappa. Per maggiori dettagli, consulta Associare un ID mappa a uno stile di mappa.

  4. Aggiungi l'ID mappa all'app per visualizzare lo stile. Per maggiori dettagli, consulta Aggiungere l'ID mappa alla mappa.

Questo documento descrive come creare, modificare e pubblicare stili di mappa e come associarli a un ID mappa.

Creare uno stile di mappa

Crea uno stile di mappa utilizzando uno di questi metodi:

  • Crea un nuovo stile utilizzando lo stile di mappa predefinito di Google.

  • Copia e modifica uno stile personalizzato esistente.

  • Importa uno stile di mappa JSON da utilizzare come stile personalizzato.

Creare un nuovo stile

  1. Nella console Google Cloud, vai a Stili mappa e seleziona un progetto, se necessario.

  2. In Stili di mappa, fai clic su Crea stile.

  3. Nella finestra di dialogo, nella scheda Stili Google, seleziona una modalità.

    • Chiaro crea uno stile con tema chiaro, ideale per ambienti luminosi o esterni.
    • Scuro crea uno stile con tema scuro, ideale per ambienti con scarsa illuminazione.

    Per saperne di più sugli stili in modalità Chiaro e Scuro, consulta Scopri di più su modalità e tipi di mappe.

  4. (Facoltativo) Per applicare una variazione del tema allo stile di mappa, in Tema facoltativo, seleziona una delle seguenti opzioni:

    • Monocromatico: crea una versione in scala di grigi dello stile di mappa.
    • Ambientale: crea una versione attenuata dello stile di mappa. Questa opzione è disponibile solo se nel progetto è abilitato Navigation SDK.

    In alternativa, puoi fare clic sulla scheda JSON per importare uno stile di mappa JSON.

    Punto blu e cerchio blu che indicano uno stile personalizzato e lo stile principale

  5. Seleziona Personalizza per creare un nuovo stile senza titolo.

  6. Seleziona gli elementi della mappa e modificali per creare lo stile di mappa che preferisci.

    Gli elementi della mappa con stili personalizzati sono contrassegnati da un punto blu pieno. Se personalizzi uno stile secondario, lo stile principale mostra un cerchio blu. Per saperne di più sulla gerarchia degli stili di mappa, consulta Informazioni sull'ereditarietà e sulla gerarchia degli stili di mappa.

  7. Fai clic su Salva.

  8. Nella casella Salva e pubblica stile di mappa , inserisci un nome per lo stile e, facoltativamente, una descrizione, quindi fai clic su Salva.

Lo stile viene pubblicato automaticamente e viene visualizzata la pagina dei dettagli dello stile per il nuovo stile.

Copiare uno stile

  1. Vai a Stili mappa e seleziona un progetto, se necessario.

  2. Seleziona uno degli stili esistenti.

  3. Nella pagina dello stile, fai clic su Crea una copia.

  4. Nella finestra di dialogo Crea una copia , inserisci un nuovo nome per lo stile di mappa e, facoltativamente, una descrizione.

  5. (Facoltativo) Per creare la versione complementare in modalità Chiaro o Scuro dello stile copiato, seleziona la casella di controllo nella sezione Opzioni modalità stile.

  6. Fai clic su Salva.

    Lo stile viene pubblicato automaticamente e puoi visualizzare la pagina principale del nuovo stile. Associalo a un ID mappa per utilizzarlo per le tue mappe. Per maggiori dettagli, consulta Associare un ID mappa a uno stile di mappa.

  7. Se vuoi modificare lo stile, fai clic su Personalizza, apporta le modifiche, e fai clic su Salva.

Pubblicare uno stile

Quando crei un nuovo stile di mappa, la prima istanza del nuovo stile di mappa viene pubblicata automaticamente. Dopodiché, salvi le modifiche come bozza e, quando sei soddisfatto, devi pubblicarle.

  1. Apporta le modifiche allo stile di mappa o allo stile di mappa duplicato. Per maggiori dettagli, consulta Modificare uno stile.

  2. Fai clic su Salva per salvare le modifiche come bozza.

  3. Quando è tutto pronto per la pubblicazione e le modifiche devono essere applicate a tutti gli ID mappa che utilizzano lo stile di mappa, fai clic su Pubblica.

Stili di mappa pubblicati e in bozza

Pubblicato: uno stile di mappa pubblicato è attivo. Tutte le mappe che utilizzano lo stile di mappa mostrano la versione pubblicata.

Bozza: le versioni in bozza di uno stile di mappa sono in fase di elaborazione e non vengono visualizzate nelle mappe finché non le pubblichi.

Modificare uno stile

Se vuoi apportare modifiche allo stile di mappa, puoi farlo direttamente nell'editor di stili. Quando aggiorni uno stile, hai a disposizione due opzioni:

  • Se vuoi che le modifiche vengano applicate non appena sono pronte: fai clic su Personalizza e apporta le modifiche. Fai clic su Salva per salvare le modifiche come bozza, quindi fai clic su Pubblica quando è tutto pronto.

  • Se vuoi testare le modifiche in un ambiente di test: invece di apportare modifiche direttamente allo stile di mappa, duplica prima lo stile. Per maggiori dettagli, consulta Copiare uno stile e Testare gli aggiornamenti dello stile di mappa.

Dopo aver creato uno stile di mappa, puoi apportare modifiche nella pagina dei dettagli dello stile in uno dei seguenti modi:

  • Modifica: fai clic su Personalizza.

  • Crea una copia: per maggiori dettagli, consulta Copiare uno stile.

  • Rinomina: rinomina lo stile di mappa.

  • Elimina: elimina lo stile di mappa.

Utilizzare stili basati sui dati e set di dati

Nella pagina dei dettagli dello stile, puoi attivare e visualizzare i livelli per gli stili basati sui dati per i confini e gli stili basati sui dati per i set di dati negli stili in modalità Luce.

Quando colleghi uno stile in modalità Luce con stili basati sui dati o set di dati abilitati a un ID mappa, i livelli abilitati sono disponibili anche per lo stile in modalità Scuro.

Per utilizzare stili basati sui dati o set di dati con uno stile in modalità Scuro, devi eseguire le seguenti operazioni nella console Google Cloud:

  1. Vai a Stili mappa e seleziona uno stile in modalità Chiaro o creane uno.

  2. Nella pagina dei dettagli dello stile, abilita i livelli che preferisci nello stile in modalità Luce.

  3. Associa lo stile in modalità Luce allo stesso ID mappa dello stile in modalità Buio.

Associare lo stile a un ID mappa

Associa lo stile a un ID mappa per visualizzare lo stile personalizzato sul tuo sito web e nella tua app. Un ID mappa può avere associato un solo stile in modalità Luce e un solo stile in modalità Buio.

Per modificare gli stili associati a un ID mappa, procedi nel seguente modo nella console Google Cloud:

  1. Vai a Gestione mappa e seleziona un ID mappa.

  2. Nella sezione Stili di mappa, fai clic su Modifica per la modalità Chiaro o Buio.

  3. Nel riquadro, seleziona uno stile da associare a questo ID mappa.

  4. Fai clic su Fine.

  5. (Facoltativo) Applica lo stile a diversi tipi di mappe.

    Per impostazione predefinita, lo stile viene applicato a tutti i tipi di mappe disponibili (roadmap, navigation, terrain, hybrid, 3D roadmap, 3D hybrid). Per applicare lo stile a tipi di mappe specifici, fai clic su Mostra altro e seleziona la casella di controllo per ogni tipo di mappa elencato sia per la modalità Chiaro sia per la modalità Scuro. Per applicare invece lo stile di mappa predefinito di Google per quella modalità, deseleziona la casella di controllo per un tipo di mappa.

    Per saperne di più sui tipi di mappe, consulta Scopri di più su modalità e tipi di mappe.

  6. Fai clic su Salva per applicare tutte le modifiche.

Per utilizzare lo stile di mappa basato su cloud, aggiungi l'ID mappa all'app.