Utilizzare Maps SDK for Android versione 3.1.0 BETA

Avviso di ritiro dell'SDK beta:

La versione beta dell'SDK è deprecata e verrà ritirata. Non è più disponibile per un nuovo utilizzo. Le funzionalità descritte in questo argomento sono attualmente accessibili tramite l'SDK beta. Una versione futura dell'SDK fornirà un supporto simile per queste funzionalità.

Per saperne di più, consulta le note di rilascio. Utilizza lo strumento di migrazione Maps V3 BETA per eseguire la migrazione dalla versione beta deprecata a una versione supportata.

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

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

Questa guida mostra 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é personalizzare lo stile della mappa nel codice utilizzando le API e gli SDK Maps, puoi gestire e personalizzare lo stile delle mappe nella console Google Cloud. Per ulteriori informazioni, vedi Panoramica della personalizzazione delle mappe per Android.

Gestione della collisione tra indicatori (beta)

Puoi specificare se i marcatori personalizzati devono ignorare le etichette della basemap predefinita in caso di collisione e indicare la priorità relativa tra i marcatori personalizzati. Per maggiori informazioni, consulta la sezione Gestione della collisione dei marcatori (Android).

Personalizzazione polilinee (beta)

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

• Le polilinee multicolore impostano segmenti di polilinea su colori diversi.
• Le polilinee sfumate colorano una polilinea utilizzando una sfumatura di due colori.
• Lo stile Polilinee con timbro applica uno stile a una polilinea utilizzando bitmap ripetuti.

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.

Crea una polilinea sfumata

Puoi definire un gradiente specificando due numeri interi alpha-rosso-verde-blu (ARGB) 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 trama bitmap ripetuta. Per farlo, crea un StampStyle di TextureStyle, quindi imposta questa proprietà sull'oggetto delle 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 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 i seguenti elementi 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'