Per iniziare

Seleziona la piattaforma: Android iOS JavaScript

Segui questi passaggi per configurare gli stili basati sui dati per i confini.

Attivare il nuovo visualizzatore delle mappe

È disponibile un renderer delle mappe di cui è stato eseguito l'upgrade a partire dalla versione 18.0.0 del Maps SDK for Android. Questo visualizzatore apporta molti miglioramenti a Maps SDK for Android, tra cui il supporto della personalizzazione delle mappe basata su cloud.

Con il rilascio della versione 18.2.0 di Maps SDK for Android, Google ha impostato il renderer predefinito dal renderer precedente al renderer di mappe di cui è stato eseguito l'upgrade. Questa variazione significa che il visualizzatore di mappe di cui è stato eseguito l'upgrade ora viene utilizzato per impostazione predefinita nella tua app quando crei una nuova app o ne ricostruisci una esistente.

Attenzione: per utilizzare lo stile basato sui dati per i confini nella tua app, l'app deve essere sviluppata utilizzando il visualizzatore delle mappe di cui è stato eseguito l'upgrade. Se aggiungi stile basato sui dati per i confini a un'app esistente, assicurati di ricostruirla in modo che utilizzi il renderer della mappa di cui è stato eseguito l'upgrade. Per ulteriori informazioni, consulta Nuovo visualizzatore di mappe.

Creare un ID mappa

Per creare un nuovo ID mappa, segui i passaggi descritti in Creare un ID mappa. Assicurati di impostare il tipo di mappa su Android.

Crea un nuovo stile di mappa

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

Seleziona i livelli degli elementi nel nuovo stile della mappa

Nella console API di Google puoi selezionare i livelli degli elementi da visualizzare per il nuovo stile di mappa. Il livello degli elementi determina i tipi di confini visualizzati sulla mappa (ad esempio località, stati e così via).

Importante: per prestazioni ottimali, seleziona solo i livelli che ti servono.

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

Aggiorna il codice di inizializzazione della mappa

Questo passaggio richiede l'ID mappa appena creato. Puoi trovarlo nella pagina Gestione Maps.

Per aggiungere l'ID mappa al codice di inizializzazione, consulta Aggiungere l'ID mappa all'app.

Ottenere l'accesso a un livello di funzionalità di una mappa

Utilizza un oggetto FeatureLayer per rappresentare ogni livello di funzionalità di una mappa, ad esempio un livello di funzionalità di codice postale o località. Per ottenere l'accesso a un oggetto del livello delle caratteristiche, chiama GoogleMap.getFeatureLayer() quando la mappa viene inizializzata:

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

Passa un oggetto FeatureLayerOptions a getFeatureLayer() per specificare il tipo di livello di funzionalità. In questo esempio, vuoi accedere al livello POSTAL_CODE. Crea un oggetto FeatureLayer diverso per ogni livello a cui vuoi applicare uno stile.

Una volta ottenuto l'oggetto FeatureLayer, puoi applicare lo stile ai poligoni dei confini nella caratteristica.

Nota: se per la mappa non esiste un FeatureLayer del tipo specificato o se lo stile basato sui dati per i confini non è abilitato perché non hai specificato l'ID mappa, questa chiamata viene restituita, ma viene registrato un errore. Utilizza il metodo FeatureLayer.isAvailable() per determinare se è disponibile un FeatureLayer.

Verifica le funzionalità della mappa (obbligatorio)

L'applicazione di stili basati sui dati per i confini richiede un ID mappa. Se l'ID mappa non è presente o se viene passato un ID mappa non valido, lo stile basato sui dati per i confini non può essere caricato. Come passaggio per la risoluzione dei problemi, puoi utilizzare MapCapabilities per verificare se gli stili basati sui dati per i confini sono supportati.

Attenzione: alcuni dispositivi potrebbero non supportare il nuovo visualizzatore della mappa e quindi non essere in grado di visualizzare gli stili basati sui dati per i confini. Devi utilizzare MapCapabilities per verificare la presenza del supporto in fase di esecuzione. Se gli stili basati sui dati per i confini non sono supportati, definisci un'opzione di riserva. Per i requisiti del dispositivo per il nuovo visualizzatore di mappe, consulta la sezione Dispositivi supportati.

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());