Inizia

Seleziona la piattaforma: iOS JavaScript

Per utilizzare gli stili basati sui dati per i confini, devi creare un ID mappa che utilizzi la mappa vettoriale JavaScript. Successivamente, devi creare un nuovo stile di mappa, selezionare i livelli degli elementi per i confini desiderati e associare lo stile all'ID mappa.

Crea un ID mappa

Per creare un nuovo ID mappa, segui i passaggi descritti in Personalizzazione di Cloud. Imposta il tipo di mappa su JavaScript e seleziona l'opzione Vettore. Seleziona Inclinazione e/o Rotazione per attivare l'inclinazione e la rotazione sulla mappa. Se l'uso dell'inclinazione o dell'orientamento incide negativamente sull'app, lascia deselezionate Inclinazione e Rotazione in modo che gli utenti non possano regolare l'inclinazione e la rotazione.

Crea ID mappa vettoriale

Crea un nuovo stile di mappa

Per creare un nuovo stile di mappa, segui le istruzioni in Gestire gli stili di mappa per creare lo stile e associare lo stile all'ID mappa appena creato.

Seleziona livelli degli elementi

Nella console API di Google puoi selezionare i livelli degli elementi da visualizzare. Questo determina quali tipi di confini verranno visualizzati sulla mappa (ad esempio località, stati e così via).

Per gestire i livelli delle caratteristiche

  1. Nella console API di Google, vai alla pagina Stili di mappa.
  2. Seleziona un progetto, se richiesto.
  3. Seleziona uno stile di mappa.
  4. Fai clic sul menu a discesa Livelli degli elementi per aggiungere o rimuovere livelli.
  5. Fai clic su Salva per salvare le modifiche e renderle disponibili per le tue mappe.

Uno screenshot che mostra il menu a discesa.

Aggiorna il codice di inizializzazione della mappa

È necessario l'ID mappa che hai appena creato. È disponibile nella pagina Gestione di Maps.

  1. Carica l'API Maps JavaScript aggiungendo il bootstrap in linea al codice dell'applicazione, come mostrato nello snippet seguente:
<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "weekly",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>
  1. Fornisci un ID mappa quando crei un'istanza della mappa utilizzando la proprietà mapId. Deve essere l'ID mappa che hai configurato utilizzando uno stile di mappa con livelli di funzionalità abilitati.

    map = new
    google.maps.Map(document.getElementById('map'), {
      center: {lat: -34.397, lng: 150.644},
      zoom: 8,
      mapId: 'MAP_ID' // A map ID using a style with one or more feature layers enabled.
    });

Scopri di più sul caricamento dell'API Maps JavaScript.

Aggiungere livelli di elementi a una mappa

Per ottenere un riferimento a un livello di elementi sulla mappa, chiama map.getFeatureLayer() durante l'inizializzazione della mappa:

function initMap() {
  map = new google.maps.Map(document.getElementById("map"), {
    center: { lat: 20.773, lng: -156.01 },
    zoom: 12,
    mapId: 'MAP_ID',
  });

  // Add a feature layer for localities.
  localityLayer = map.getFeatureLayer('LOCALITY');
  ...
}

Verifica le funzionalità della mappa

L'applicazione di stili basati sui dati per i confini richiede funzionalità abilitate nella console API di Google e associate a un ID mappa. Poiché gli ID mappa sono temporanei e soggetti a modifiche, puoi chiamare map.getMapCapabilities() per verificare se una determinata funzionalità (ad esempio gli stili basati sui dati) è disponibile prima di chiamarla. Questo controllo è facoltativo.

L'esempio seguente mostra l'aggiunta di un listener per la sottoscrizione alle modifiche delle funzionalità della mappa:

// subscribe to changes
map.addListener('mapcapabilities_changed', () => {
  const mapCapabilities = map.getMapCapabilities();

  if (!mapCapabilities.isDataDrivenStylingAvailable) {
    // Data-driven styling is *not* available, add a fallback.
    // Existing feature layers are also unavailable.
  }
});

Passaggi successivi