Per iniziare

Seleziona la piattaforma: Android iOS JavaScript

Segui questi passaggi per configurare lo stile basato sui dati per i confini.

Attiva il nuovo renderer di mappe

È disponibile un renderer di mappe aggiornato a partire dalla versione 18.0.0 di Maps SDK for Android. Questo renderer offre molti miglioramenti, tra cui il supporto per la personalizzazione delle mappe basata su cloud, a Maps SDK for Android.

Con il rilascio della versione 18.2.0 di Maps SDK for Android, Google ha sostituito il renderer predefinito, passando dal renderer precedente al renderer di mappe aggiornato. Questa modifica significa che il renderer di mappe aggiornato viene ora utilizzato per impostazione predefinita nella tua app quando crei una nuova app o ricompili un'app esistente.

Attenzione: per utilizzare lo stile basato sui dati per i confini nella tua app, devi crearla utilizzando il renderer di mappe aggiornato. Se stai aggiungendo lo stile basato sui dati per i confini a un'app esistente, assicurati di ricompilarla in modo che utilizzi il renderer di mappe aggiornato. Per ulteriori informazioni, consulta Nuovo renderer di mappe.

Crea un ID mappa

Per creare un nuovo ID mappa, segui i passaggi descritti in Creare un ID mappa. Assicurati di impostare 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.

Sperimentale: questa funzionalità può essere impostata solo per gli stili di mappa chiari. Quando colleghi un ID mappa a uno stile di mappa chiaro con questa funzionalità attivata, i livelli abilitati sono disponibili anche per lo stile di mappa scuro.

Seleziona i livelli degli elementi nel nuovo stile di 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 un rendimento ottimale, seleziona solo i livelli di cui hai bisogno.

1. Nella console API di Google, vai alla pagina Stili di mappa.
2. Se richiesto, seleziona un progetto.
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.

Aggiorna il codice di inizializzazione della mappa

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

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

Accedi a un livello degli elementi di una mappa

Utilizza un FeatureLayer oggetto per rappresentare ogni livello degli elementi di una mappa, ad esempio un livello degli elementi Codice postale o Località. Per accedere a un oggetto livello degli elementi, 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 degli elementi. 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 uno stile ai poligoni dei confini in quell'elemento.

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

Controlla le funzionalità della mappa (obbligatorio)

Lo stile basato sui dati per i confini richiede un ID mappa. Se l'ID mappa è mancante o 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 lo stile basato sui dati per i confini è supportato.

Attenzione: alcuni dispositivi potrebbero non supportare il nuovo renderer di mappe e pertanto non possono visualizzare lo stile basato sui dati per i confini. Devi utilizzare MapCapabilities per verificare il supporto in fase di runtime. Se lo stile basato sui dati per i confini non è supportato, definisci un'opzione di riserva. Per i requisiti del dispositivo per il nuovo renderer di mappe, consulta 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());