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 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 più facilmente lo stile delle mappe. Anziché definire uno stile per la mappa nel codice utilizzando le API e gli SDK di Google Maps, puoi gestire e definire le tue 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 delle mappe base predefinite in caso di collisione e indicare la priorità relativa tra gli indicatori personalizzati. Per ulteriori informazioni, consulta la sezione Gestione degli scontri con gli indicatori (Android).

Personalizzazione di Polyline (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 stampate assegnano uno stile a una polilinea mediante 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 sfumata

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 stampata

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, devi anche aggiornare le dipendenze del progetto per sostituire la versione esistente con la versione compatibile con la versione beta procedendo nel seguente modo:

  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 di Google Samples su GitHub include app di esempio che dimostrano l'utilizzo dell'SDK di Maps beta v3.1.0 per Android.