Inizia

Seleziona la piattaforma: Android iOS JavaScript

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

Attivare il nuovo renderer delle mappe

Un renderer delle mappe aggiornato è disponibile a partire dalla versione 18.0.0 del Maps SDK per Android. Questo renderer apporta molti miglioramenti, tra cui 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 cambiato la renderer predefinito dal renderer precedente al renderer della mappa aggiornato. Questo significa che il renderer delle mappe aggiornato è ora utilizzato per impostazione predefinita nella tua app quando crei una nuova app o crei di nuovo un'app esistente.

Attenzione: per usare gli stili basati sui dati per i confini nell'app, questa deve essere creato utilizzando il renderer delle mappe aggiornato. Se aggiungi stili basati sui dati per limitare i confini di un'app esistente, assicurati di ricreare il in modo che la tua app utilizzi il renderer delle mappe aggiornato. Per ulteriori informazioni, vedi Nuovo renderer della mappa.

Crea un ID mappa

Per creare un nuovo ID mappa, segui la procedura alla pagina Crea un ID mappa. Assicurati di Imposta 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 di mappa

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

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

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.

Aggiorna il codice di inizializzazione della mappa

Questo passaggio richiede l'ID mappa appena creato. Puoi trovarlo sul tuo pagina Gestione di Maps.

Per aggiungere l'ID mappa al codice di inizializzazione, vedi Aggiungi l'ID mappa all'app.

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

Utilizzi una FeatureLayer per rappresentare ogni livello di elementi di una mappa, come un codice postale o Livello degli elementi località. Per ottenere l'accesso a un oggetto di 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())
  ...
}

Supera un FeatureLayerOptions in getFeatureLayer() per specificare il tipo di livello delle caratteristiche. In questo Ad esempio, vuoi accedere al livello POSTAL_CODE. Crea un altro FeatureLayer per ogni livello a cui vuoi applicare uno stile.

Una volta ottenuto l'oggetto FeatureLayer, puoi applicare lo stile poligoni di confine.

Nota: se non esiste un FeatureLayer del tipo specificato per la mappa, oppure se gli stili basati sui dati per i confini non sono attivati perché non hai specificato l'ID mappa, la chiamata viene restituita, ma registra un errore. Utilizza la FeatureLayer.isAvailable() per determinare se FeatureLayer è disponibile.

Verifica le funzionalità della mappa (obbligatorio)

L'applicazione di stili basati sui dati per i confini richiede un ID mappa. Se manca l'ID mappa o se È stato trasmesso un ID mappa non valido, impossibile caricare gli stili basati sui dati per i confini. 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 renderer delle mappe e, di conseguenza, non possono mostrare stili basati sui dati per i confini. Devi utilizzare MapCapabilities per verificare il supporto in fase di runtime. 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 renderer delle mappe, vedi Supportato Google Cloud.

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());