Utilizzo dell'SDK di Maps per Android v3.1.0 BETA

La versione beta 3.1.0 dell'SDK Maps per Android è una nuova implementazione con la stessa API della versione precedente (tutte le classi e i metodi rimangono invariati) e alcune nuove funzionalità da provare:

  • Personalizzazione di Maps
  • Gestione della collisione tra indicatori
  • Personalizzazione della polilinea

Questa guida illustra come utilizzare le nuove funzionalità.

Personalizzazione di Maps (beta)

La personalizzazione delle mappe basata su cloud offre una serie di strumenti e funzionalità che ti consentono di personalizzare e gestire più facilmente lo stile delle mappe. Anziché personalizzare la mappa nel codice utilizzando le API e gli SDK di Maps, puoi gestire e personalizzare le mappe nella console Google Cloud. Per ulteriori informazioni, consulta la Panoramica della personalizzazione delle mappe Android.

Gestione della collisione tra indicatori (beta)

Puoi specificare se gli indicatori personalizzati devono sostituire le etichette della mappa di base predefinite in caso di collisione e per indicare la priorità relativa tra gli indicatori personalizzati. Per ulteriori informazioni, consulta la sezione Gestione degli scontri con gli indicatori (Android).

Personalizzazione di polilinee (beta)

Ora sono disponibili diversi nuovi modi per personalizzare l'aspetto delle polilinee:

  • Le polilinee multicolori impostano i segmenti delle polilinee su colori diversi.
  • Le polilinee con gradiente colorano una polilinea utilizzando un gradiente di due colori.
  • Le polilinee con timbro applicano uno stile a una polilinea utilizzando bitmap ripetute.

Creazione di una polilinea multicolore

Puoi utilizzare gli intervalli per colorare singolarmente i segmenti di una polilinea creando oggetti StyleSpan e aggiungendoli a PolylineOptions utilizzando i metodi addSpan() o addSpans(). Per impostazione predefinita, ogni elemento dell'array imposta il colore del segmento di linea corrispondente.

Creazione di una polilinea con gradiente

Puoi definire un gradiente specificando due interi alpha-red-green-blue (ARGB) di 32 bit per specificare i colori iniziale e finale del tratto. Imposta questa proprietà sull'oggetto opzioni della forma chiamando PolylineOptions.addSpan().

Creazione di una polilinea con timbro

Puoi impostare l'aspetto di una polilinea su una trama bitmap ripetuta. Per farlo, crea un StampStyle di TextureStyle, quindi imposta questa proprietà sull'oggetto opzioni della forma chiamando PolylineOptions.addSpan().

Importa la libreria di utilità compatibile con la versione beta

Se utilizzi la libreria di utilità dell'API Android di Google Maps, dovrai aggiornare anche le dipendenze del progetto per sostituire la versione esistente con quella compatibile con la versione beta seguendo questa procedura:

  1. Importa la libreria util compatibile con la versione beta nel file build.gradle: 
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. Rimuovi quanto segue da build.gradle per rimuovere la libreria di utilità non compatibile con la versione beta: 
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

Esegui i sample

Il repository Google Samples su GitHub include app di esempio che mostrano l'utilizzo della versione beta 3.1.0 dell'SDK Maps per Android.