Sovrapposizione al suolo

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

Posizione

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

• Utilizzando una posizione. Devi fornire un'immagine dell'overlay del suolo, un LatLng a cui verrà fissato l'ancoraggio e la larghezza dell'overlay (in metri). Per impostazione predefinita, l'ancoraggio è al 50% dalla parte superiore dell'immagine e al 50% da sinistra della stessa. Questa scelta può essere modificata. Facoltativamente, puoi fornire l'altezza dell'overlay (in metri). Se non fornisci l'altezza dell'overlay, questo verrà calcolato automaticamente per preservare le proporzioni dell'immagine.
• Utilizzo di 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, viene 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; altrimenti verrà generato un IllegalStateException quando specifichi un secondo metodo.

Immagine

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

Rilevamento

La quantità di immagine che deve essere ruotata in senso orario. Il centro della rotazione sarà l'ancoraggio dell'immagine. Il valore predefinito è facoltativo e il valore predefinito è 0, ovvero l'immagine è allineata in modo tale che sia verso nord.

z-index

L'ordine in cui viene estratto questo overlay del suolo rispetto agli altri (inclusi Polyline e TileOverlay, ma non Marker). Un overlay con uno z-index più grande viene disegnato su overlay con uno z-index più piccolo. L'ordine degli overlay con lo stesso valore zIndex è arbitrario. Questo valore è facoltativo e il valore predefinito di zIndex è 0.

Trasparenza

La trasparenza della sovrapposizione del suolo nell'intervallo [0..1], dove 0 indica che l'overlay è opaco, mentre 1 indica che l'overlay è completamente trasparente. Se la bitmap specificata è già parzialmente trasparente, la trasparenza di ogni pixel verrà ridimensionata di conseguenza (ad esempio, se un pixel nella bitmap ha un valore alfa di 200 e specifichi la trasparenza dell'overlay del suolo come 0,25, il pixel verrà visualizzato sullo schermo con un valore alfa di 150). Le specifiche di questa proprietà sono facoltative e la trasparenza predefinita è 0 (opaca).

Visibilità

Indica se l'overlay del suolo è visibile o invisibile, ad esempio se è disegnato sulla mappa. Un overlay invisibile del terreno non viene tracciato, ma conserva tutte le altre proprietà. Questa operazione è facoltativa e la visibilità predefinita è true, ovvero visibile.

Cliccabilità

Se vuoi gestire gli eventi attivati quando l'utente fa clic sull'overlay del 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à le notifiche per GoogleMap.OnGroundOverlayClickListener registrate tramite setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Tag

Un Object associato all'overlay del suolo. Ad esempio, Object può contenere dati su ciò che rappresenta l'overlay del 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. Google Maps SDK for Android non legge né scrive questa proprietà.

I metodi in questa classe devono essere chiamati nel thread dell'interfaccia utente di Android. In caso contrario, verrà lanciato un elemento IllegalStateException durante il 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));