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 delle polilinee

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 consentono di personalizzare e gestire lo stile delle mappe. Anziché applicare lo stile alla mappa nel codice utilizzando le API e gli SDK di Maps, puoi gestire e applicare lo stile alle mappe nella console Google Cloud. Per saperne di più, consulta la panoramica della Personalizzazione delle mappe per Android. Android Map Customization Overview.

Gestione della collisione tra indicatori (beta)

Puoi specificare se gli indicatori personalizzati devono sostituire le etichette della basemap predefinite in caso di collisione e indicare la priorità relativa tra gli indicatori personalizzati. Per saperne di più, consulta Gestione della collisione tra indicatori (Android).

Personalizzazione delle polilinee (beta)

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

  • Le polilinee multicolore impostano segmenti di polilinee di colori diversi.
  • Le polilinee a gradiente colorano una polilinea utilizzando un gradiente di due colori.
  • Le polilinee con timbro applicano lo stile a una polilinea utilizzando bitmap ripetute.

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

Creare una polilinea a gradiente

Puoi definire un gradiente specificando due numeri interi ARGB (Alpha-Red-Green-Blue) a 32 bit per specificare i colori di inizio e fine del tratto. Imposta questa proprietà sull'oggetto delle opzioni della forma chiamando PolylineOptions.addSpan().

Creare 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 delle opzioni della forma chiamando PolylineOptions.addSpan().

Importare 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 di utilità 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'