Sovrapposizione al suolo

pubblica final class GroundOverlay estende Object

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));

Riepilogo del metodo pubblico

boolean
uguale a(oggetto altro)
Verifica se questo GroundOverlay è uguale a un altro.
float
getBearing()
Restituisce l'orientamento della sovrapposizione del suolo in gradi in senso orario da nord.
LatLngBounds
getBounds()
Restituisce i limiti per l'overlay del suolo.
float
getHeight()
Restituisce l'altezza dell'overlay del suolo.
Stringa
getId()
Ottieni l'ID di questo overlay del suolo.
LatLng
getPosition()
Restituisce la posizione del punto di ancoraggio.
Oggetto
getTag()
Recupera il tag per la cerchia.
float
getTransparency()
Acquisisce la trasparenza dell'overlay del suolo.
float
getWidth()
Consente di acquisire la larghezza dell'overlay del suolo.
float
getZIndex()
Restituisce lo zIndex di questo overlay al suolo.
int
hashCode()
boolean
isClickable()
Restituisce la cliccabilità dell'overlay del suolo.
boolean
isVisible()
Ottieni la visibilità dell'overlay del suolo.
void
remove()
Rimuove l'overlay del suolo dalla mappa.
void
setBearing(cuscinetto fluttuante)
Imposta l'orientamento dell'overlay del suolo (la direzione in cui è rivolto l'asse verticale del suolo in overlay) in gradi in senso orario da nord.
void
setClickable(cliccabile booleano)
Imposta la cliccabilità dell'overlay del suolo.
void
setDimensions(larghezza del floating, altezza del floating)
Imposta le dimensioni dell'overlay del suolo.
void
setDimensions(larghezza del floating)
Imposta la larghezza dell'overlay del suolo.
void
setImage(imageDescriptor BitmapDescriptor)
Imposta l'immagine per l'overlay del suolo.
void
setPosition(LatLng latLng)
Imposta la posizione dell'overlay del suolo modificando la posizione del punto di ancoraggio.
void
setPositionFromBounds(limiti LatLngBounds)
Consente di impostare la posizione dell'overlay del suolo adattandolo al valore LatLngBounds specificato.
void
setTag(tag oggetto)
Imposta il tag per l'overlay del suolo.
void
setTransparency(trasparenza mobile)
Imposta la trasparenza dell'overlay del suolo.
void
setVisible(boolean visibile)
Imposta la visibilità dell'overlay del suolo.
void
setZIndex(zIndex in virgola mobile)
Imposta il valore zIndex di questa sovrapposizione al suolo.

Riepilogo del metodo ereditato

Metodi pubblici

Public booleano uguale a (Object other)

Verifica se questo GroundOverlay è uguale a un altro.

Parametri
altro un Object.
Ritorni
  • true se entrambi gli oggetti sono lo stesso oggetto, ovvero questo == other.

numero in virgola mobile getBearing ()

Restituisce l'orientamento della sovrapposizione del suolo in gradi in senso orario da nord.

Ritorni
  • il posizionamento della sovrapposizione del suolo.

pubblico LatLngBounds getBounds ()

Restituisce i limiti per l'overlay del suolo. In questo modo viene ignorata la rotazione dell'overlay del suolo.

Ritorni
  • un elemento LatLngBounds contenente l'overlay del suolo, che ignora la rotazione.

numero in virgola mobile pubblico getHeight ()

Restituisce l'altezza dell'overlay del suolo.

Ritorni
  • l'altezza della sovrapposizione del suolo in metri.

Stringa pubblica getId ()

Ottieni l'ID di questo overlay del suolo. L'ID sarà univoco tra tutti gli overlay al suolo su una mappa.

Ritorni
  • ID dell'overlay del suolo.

pubblica LatLng getPosition ()

Restituisce la posizione del punto di ancoraggio.

Ritorni
  • la posizione sulla mappa (un LatLng).

pubblico Oggetto getTag ()

Recupera il tag per la cerchia.

Ritorni
  • il tag se un tag è stato impostato con setTag; null se non è stato impostato alcun tag.

float pubblico getTransparency ()

Acquisisce la trasparenza dell'overlay del suolo.

Ritorni
  • la trasparenza dell'overlay del suolo.

numero in virgola mobile pubblico getWidth ()

Consente di acquisire la larghezza dell'overlay del suolo.

Ritorni
  • la larghezza della sovrapposizione del suolo in metri.

numero in virgola mobile getZIndex ()

Restituisce lo zIndex di questo overlay al suolo.

Ritorni
  • zIndex dell'overlay del suolo.

pubblici int hashCode ()

pubblico booleano isClickable ()

Restituisce la cliccabilità dell'overlay del suolo. Se è possibile fare clic sull'overlay al suolo, l'app riceverà notifiche a GoogleMap.OnGroundOverlayClickListener quando l'utente farà clic sull'overlay al suolo. Il listener di eventi è registrato tramite setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Ritorni
  • true se l'overlay al suolo è cliccabile; in caso contrario, restituisce false.

pubblici booleano isVisible ()

Ottieni la visibilità dell'overlay del suolo. Tieni presente che ciò non mostra se l'overlay del suolo è effettivamente sullo schermo, ma se verrà disegnato se è contenuto nell'area visibile della fotocamera.

Ritorni
  • la visibilità di questo overlay del suolo.

Public void remove ()

Rimuove l'overlay del suolo dalla mappa. Dopo la rimozione di un overlay al suolo, il comportamento di tutti i suoi metodi non è definito.

Public void setBearing (cuscinetto fluttuante)

Imposta l'orientamento dell'overlay del suolo (la direzione in cui è rivolto l'asse verticale del suolo in overlay) in gradi in senso orario da nord. La rotazione viene eseguita attorno al punto di ancoraggio.

Parametri
bearing orientamento in gradi in senso orario da nord

Public void setClickable (booleano cliccabile)

Imposta la cliccabilità dell'overlay del suolo. Se è possibile fare clic sull'overlay al suolo, l'app riceverà notifiche a GoogleMap.OnGroundOverlayClickListener quando l'utente farà clic sull'overlay al suolo. Il listener di eventi è registrato tramite setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Parametri
cliccabile Nuova impostazione di cliccabilità per l'overlay del suolo.

pubblici void setDimensions (larghezza virgola mobile, altezza virgola mobile)

Imposta le dimensioni dell'overlay del suolo. L'immagine verrà allungata per adattarla alle dimensioni.

Parametri
width larghezza in metri
altezza altezza in metri

Public void setDimensions (larghezza del floating)

Imposta la larghezza dell'overlay del suolo. L'altezza dell'overlay del suolo verrà adattata di conseguenza per mantenere le proporzioni.

Parametri
width larghezza in metri

Public void setImage (BitmapDescriptor imageDescriptor)

Imposta l'immagine per l'overlay del suolo. La nuova immagine occuperà gli stessi limiti di quella precedente.

Parametri
imageDescriptor il BitmapDescriptor da utilizzare per questo overlay del suolo.

Public void setPosition (LatLng latLng)

Imposta la posizione dell'overlay del suolo modificando la posizione del punto di ancoraggio. Mantiene tutte le altre proprietà dell'immagine.

Parametri
latLng Un LatLng che corrisponde alla nuova posizione in cui posizionare il punto di ancoraggio.

Public void setPositionFromBounds (limiti di LatLngBounds)

Consente di impostare la posizione dell'overlay del suolo adattandolo al valore LatLngBounds specificato. Questo metodo ignorerà la rotazione (cuscinetto) dell'overlay del suolo durante il posizionamento, ma verrà comunque utilizzato durante il disegno.

Parametri
limiti un elemento LatLngBounds in cui posizionare l'overlay del suolo

Public void setTag (Tag oggetto)

Imposta il tag per l'overlay del suolo.

Puoi utilizzare questa proprietà per associare un Object arbitrario a questo overlay del suolo. Ad esempio, Object può contenere dati relativi ai contenuti rappresentati dall'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. L'SDK Google Maps per Android non legge né scrive questa proprietà. È tua responsabilità chiamare setTag(null) per cancellare il tag quando non ti serve più, al fine di evitare perdite di memoria nella tua app.

Parametri
tag (m.) Se null, il tag viene cancellato.

Public void setTransparency (trasparenza fluttuante)

Imposta la trasparenza dell'overlay del suolo. Per ulteriori informazioni, consulta la documentazione all'inizio di questa lezione.

Parametri
trasparenza adeguata un numero mobile nell'intervallo [0..1], dove 0 indica che l'overlay del suolo è opaco, mentre 1 indica che l'overlay del suolo è trasparente.

Public void setVisible (boolean visible)

Imposta la visibilità dell'overlay del suolo. Quando non è visibile, non viene tracciato un overlay del suolo, ma mantiene tutte le altre proprietà.

Parametri
visibile Se true, l'overlay del suolo è visibile; se false, non lo è

Public void setZIndex (zIndex in virgola mobile)

Imposta il valore zIndex di questa sovrapposizione al suolo. Per ulteriori informazioni, consulta la documentazione all'inizio di questa classe.

Parametri
zIndex zIndex di questa sovrapposizione al suolo