Sovrapposizione al suolo

Un overlay del suolo è un'immagine fissata a una mappa. Un overlay del suolo ha le seguenti proprietà:

Posizione

Esistono due modi per specificare la posizione dell'overlay del suolo:

• Utilizzo di una posizione: devi fornire un'immagine dell'overlay del suolo, un LatLng a cui sarà fisso l'ancoraggio e la larghezza dell'overlay (in metri). Per impostazione predefinita, l'ancoraggio è posizionato al 50% dalla parte superiore dell'immagine e al 50% da sinistra dell'immagine. Questa opzione può essere modificata. Facoltativamente, puoi specificare l'altezza dell'overlay (in metri). Se non specifichi l'altezza dell'overlay, questa verrà calcolata automaticamente per mantenere le proporzioni dell'immagine.
• Utilizzo dei limiti: devi fornire un LatLngBounds che contenga l'immagine.

Devi specificare la posizione dell'overlay del suolo prima che venga aggiunto alla mappa. In caso contrario, verrà generato un IllegalArgumentException quando l'overlay del suolo viene aggiunto alla mappa. Inoltre, devi specificare la posizione solo utilizzando uno di questi metodi nell'oggetto GroundOverlayOptions; in caso contrario, viene generato un errore IllegalStateException quando specifichi un secondo metodo.

Immagine

L'immagine (come BitmapDescriptor) da utilizzare per questo overlay. L'immagine verrà ridimensionata per adattarsi alla posizione specificata. Devi specificare un'immagine prima di aggiungere l'overlay del suolo alla mappa. In caso contrario, verrà generato un IllegalArgumentException quando viene aggiunto alla mappa.

Rilevamento

L'entità della rotazione dell'immagine in senso orario. Il centro della rotazione sarà l'ancoraggio dell'immagine. Questo è facoltativo e l'orientamento predefinito è 0, ad esempio l'immagine sia allineata in modo che verso l'alto sia il nord.

zIndex

L'ordine in cui l'overlay del suolo viene disegnato rispetto agli altri overlay (inclusi Polyline e TileOverlay, ma non Marker). Un overlay con un valore zIndex più grande viene disegnato sopra overlay con valori zIndex più piccoli. L'ordine delle sovrapposizioni con lo stesso valore zIndex è arbitrario. È facoltativo e il valore predefinito di zIndex è 0.

Trasparenza

Trasparenza dell'overlay del suolo nell'intervallo [0..1], dove 0 indica che l'overlay è opaco e 1 indica che l'overlay è completamente trasparente. Se la bitmap specificata è già parzialmente trasparente, la trasparenza di ciascun pixel verrà scalata di conseguenza (ad esempio, se un pixel nella bitmap ha un valore alfa di 200 e specifichi la trasparenza dell'overlay del suolo pari a 0,25, il pixel verrà visualizzato sullo schermo con un valore alfa di 150). La specifica di questa proprietà è facoltativa e la trasparenza predefinita è 0 (opaca).

Visibilità

Indica se l'overlay del suolo è visibile o invisibile, ovvero se è disegnato sulla mappa. Una sovrapposizione al suolo invisibile non viene tracciata, ma conserva tutte le altre proprietà. Questa opzione è facoltativa e la visibilità predefinita è true, ovvero visibile.

Cliccabilità

Se vuoi gestire gli eventi attivati quando l'utente fa clic sull'overlay al suolo, imposta questa proprietà su true. Puoi modificare questo valore in qualsiasi momento. Il valore predefinito è false. Se questa proprietà è impostata su true, la tua app riceverà notifiche al GoogleMap.OnGroundOverlayClickListener registrato tramite setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Tag

Un elemento Object associato all'overlay del suolo. Ad esempio, Object può contenere dati su ciò che rappresenta l'overlay al suolo. Questa operazione è più semplice rispetto all'archiviazione di un Map<GroundOverlay, Object> separato. Come ulteriore esempio, puoi associare un ID String corrispondente all'ID di un set di dati. L'SDK Google Maps for Android non legge né scrive questa proprietà.

I metodi di questa classe devono essere chiamati nel thread dell'interfaccia utente Android. In caso contrario, verrà generato un IllegalStateException in fase di runtime.

Esempio

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));