Utilizzare Maps SDK for Android versione 3.1.0 BETA

La versione 3.1.0 beta di Maps SDK for Android è una nuova implementazione con la stessa superficie 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 spiega 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 lo stile delle tue mappe. Anziché applicare uno stile alla mappa nel codice utilizzando le API e gli SDK di Maps, puoi gestire e applicare uno stile alle mappe nella console Google Cloud. Per saperne di più, consulta Panoramica della personalizzazione delle mappe Android.

Gestione della collisione tra indicatori (beta)

Puoi specificare se gli indicatori personalizzati devono sostituire le etichette della mappa base predefinita in caso di collisione e indicare la priorità relativa tra gli indicatori personalizzati. Per saperne di più, consulta Gestione delle collisioni dei segnaposto (Android).

Personalizzazione delle polilinee (beta)

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

  • Le polilinee multicolore impostano i segmenti di polilinea 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.

Crea 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.

Crea una polilinea con gradiente

Puoi definire un gradiente specificando due numeri interi alfa-rosso-verde-blu (ARGB) a 32 bit per indicare i colori iniziale e finale del tratto. Imposta questa proprietà sull'oggetto delle opzioni della forma chiamando PolylineOptions.addSpan().

Crea una polilinea con timbro

Puoi impostare l'aspetto di una polilinea su una texture 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 Google Maps per Android, devi anche aggiornare le dipendenze del progetto per sostituire la versione esistente con la versione compatibile con la versione beta seguendo questi passaggi:

  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 dal tuo 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'