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.
IllegalArgumentException
quando l'overlay del suolo viene aggiunto alla mappa. Inoltre, devi specificare la posizione solo utilizzando uno di questi metodi nell'oggettoGroundOverlayOptions
; in caso contrario, viene generato un erroreIllegalStateException
quando specifichi un secondo metodo. - Utilizzo di una posizione: devi fornire un'immagine dell'overlay del suolo, un
- 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 unIllegalArgumentException
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
eTileOverlay
, ma nonMarker
). 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]
, dove0
indica che l'overlay è opaco e1
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 sutrue
, la tua app riceverà notifiche alGoogleMap.OnGroundOverlayClickListener
registrato tramitesetOnGroundOverlayClickListener(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 unMap<GroundOverlay, Object>
separato. Come ulteriore esempio, puoi associare un IDString
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 | |
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, restituiscefalse
.
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 |
---|