Un overlay al suolo è un'immagine fissata a una mappa. Un overlay al suolo ha le seguenti caratteristiche: proprietà:
- Posizione
- Esistono due modi per specificare la posizione dell'overlay al suolo:
- Uso di una posizione: devi fornire un'immagine dell'overlay al suolo, un
LatLng
a cui verrà fissato l'ancoraggio e la larghezza dell'overlay (in metri). La l'ancoraggio è, per impostazione predefinita, al 50% dal bordo superiore dell'immagine e al 50% dal lato sinistro dell'immagine. Questa opzione può essere modificata. Facoltativamente, puoi specificare l'altezza dell'overlay (in metri). Se non specifichi l'altezza dell'overlay, verrà automaticamente calcolati per preservare le proporzioni dell'immagine. - Utilizzo dei limiti: devi fornire un elemento
LatLngBounds
che conterrà l'immagine.
IllegalArgumentException
quando l'overlay al suolo aggiunti alla mappa. Inoltre, devi specificare la posizione utilizzando solo uno di questi nell'oggettoGroundOverlayOptions
; In caso contrario, viene generato un valoreIllegalStateException
quando viene specificato l'utilizzo di un secondo metodo. - Uso di una posizione: devi fornire un'immagine dell'overlay al suolo, un
- Immagine
- L'immagine (come
BitmapDescriptor
) da utilizzare per questo overlay. L'immagine sarà e ridimensionato in base alla posizione specificata. Devi specificare un'immagine prima di aggiungere il terreno sovrapporre alla mappa gli elementi necessari. se non viene restituito unIllegalArgumentException
quando viene aggiunti alla mappa. - Rilevamento
- La quantità di rotazione dell'immagine in senso orario. Il centro la rotazione sarà l'ancoraggio dell'immagine. Questo valore è facoltativo e il valore predefinito è 0, ovvero l'immagine è allineata in modo che in alto sia verso nord.
- zIndex
- L'ordine in cui viene tracciata questa sovrapposizione al suolo rispetto ad altri overlay (tra cui
Polyline
eTileOverlay
, ma nonMarker
). Un overlay con un zIndex più grande viene tracciato sopra overlay con zIndex più piccoli. L'ordine degli overlay con lo stesso valore zIndex è arbitrario. Questo valore è facoltativo e il valore predefinito di zIndex è 0. - Trasparenza
- Trasparenza dell'overlay al suolo nell'intervallo
[0..1]
, dove0
indica la l'overlay è opaco e1
significa che è completamente trasparente. Se viene specificato bitmap è già parzialmente trasparente, la trasparenza di ogni pixel verrà scalata di conseguenza (ad esempio, se un pixel nella bitmap ha un valore alfa pari a 200 e Se specifichi la trasparenza dell'overlay al suolo di 0,25, il pixel viene visualizzato schermo con un valore alpha di 150). La specifica di questa proprietà è facoltativa e il campo La trasparenza predefinita è 0 (opaca). - Visibilità
- Indica se la sovrapposizione al suolo è visibile o invisibile, ovvero se è disegnato su
mappa. Una sovrapposizione al suolo invisibile non viene tracciata, ma conserva tutte le altre proprietà.
Questo campo è facoltativo e la visibilità predefinita è
true
, ovvero visibile. - Cliccabilità
- Se vuoi gestire gli eventi attivati quando l'utente fa clic sull'overlay del suolo, imposta questo
a
true
. Puoi modificare questo valore in qualsiasi momento. Il valore predefinito èfalse
. Se questa proprietà è impostata sutrue
, la tua app riceverà notifiche relative aGoogleMap.OnGroundOverlayClickListener
registrato tramitesetOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
. - Tag
- Un
Object
associato all'overlay al suolo. Ad esempio,Object
può contengono dati relativi a ciò che rappresenta la sovrapposizione al suolo. È più semplice che archiviare separaMap<GroundOverlay, Object>
. Come ulteriore esempio, puoi associare un IDString
corrispondente all'ID di un set di dati. né Google Maps SDK per Android né legge né scrive questa proprietà.
I metodi in questa classe devono essere chiamati nel thread della UI di Android. In caso contrario, durante il runtime verrà generato un errore IllegalStateException
.
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
booleano |
uguale a(altro oggetto)
Verifica se questo valore di
GroundOverlay è uguale a un altro. |
numero in virgola mobile |
getBearing()
Ottiene la direzione dell'overlay del suolo in gradi in senso orario da nord.
|
LatLngBounds |
getBounds()
Consente di acquisire i limiti dell'overlay al suolo.
|
numero in virgola mobile |
getHeight()
Restituisce l'altezza dell'overlay al suolo.
|
Stringa |
getId()
Ottiene l'ID di questa sovrapposizione al suolo.
|
LatLng |
getPosition()
Restituisce la posizione del punto di ancoraggio.
|
Oggetto |
getTag()
Ottiene il tag per il cerchio.
|
numero in virgola mobile |
getTransparency()
Consente di ottenere la trasparenza di questa sovrapposizione al suolo.
|
numero in virgola mobile |
getWidth()
Restituisce la larghezza dell'overlay al suolo.
|
numero in virgola mobile |
getZIndex()
Restituisce lo zIndex di questa sovrapposizione al suolo.
|
int |
hashCode()
|
booleano |
isClickable()
Consente di ottenere la cliccabilità dell'overlay del suolo.
|
booleano |
isVisible()
Ottiene la visibilità di questa sovrapposizione al suolo.
|
null |
remove()
Rimuove questa sovrapposizione al suolo dalla mappa.
|
null |
setBearing(cuscinetto fluttuante)
Imposta l'orientamento dell'overlay del suolo (la direzione in cui si trova l'asse verticale del suolo)
punti di sovrapposizione) in gradi in senso orario da nord.
|
null |
setClickable(booleano selezionabile)
Imposta la cliccabilità dell'overlay al suolo.
|
null |
setDimensions(larghezza in virgola mobile, altezza in virgola mobile)
Imposta le dimensioni dell'overlay al suolo.
|
null |
setDimensions(larghezza in virgola mobile)
Imposta la larghezza dell'overlay al suolo.
|
null | |
null |
setPosition(LatLng latLng)
Imposta la posizione dell'overlay al suolo modificando la posizione del punto di ancoraggio.
|
null |
setPositionFromBounds(limiti di LatLngBounds)
Imposta la posizione dell'overlay al suolo adattandolo al
LatLngBounds specificato. |
null |
setTag(tag oggetto)
Imposta il tag per l'overlay al suolo.
|
null |
setTransparency(trasparenza mobile)
Imposta la trasparenza di questa sovrapposizione al suolo.
|
null |
setVisible(boolean visible)
Imposta la visibilità di questa sovrapposizione al suolo.
|
null |
setZIndex(float zIndex)
Imposta lo zIndex di questa sovrapposizione del suolo.
|
Riepilogo del metodo ereditato
Metodi pubblici
pubblica booleano . uguale a (altro oggetto)
Verifica se questo valore di GroundOverlay
è uguale a un altro.
Parametri
altro | Object . |
---|
Resi
- true se entrambi gli oggetti sono lo stesso oggetto, ovvero questo == altro.
pubblica in virgola mobile . getBearing ()
Ottiene il rilevamento della sovrapposizione del suolo in gradi in senso orario da nord.
Resi
- la direzione dell'overlay al suolo.
pubblica LatLngBounds getBounds ()
Consente di acquisire i limiti dell'overlay al suolo. La rotazione dell'overlay del suolo viene ignorata.
Resi
- un
LatLngBounds
che contiene l'overlay al suolo, ignorando la rotazione.
pubblica in virgola mobile . getHeight ()
Restituisce l'altezza dell'overlay al suolo.
Resi
- l'altezza dell'overlay al suolo in metri.
pubblica Stringa . getId ()
Ottiene l'ID di questa sovrapposizione al suolo. L'ID sarà univoco tra tutti gli overlay GroundOverlay su una mappa.
Resi
- l'ID di questa sovrapposizione al suolo.
pubblica LatLng getPosition ()
Restituisce la posizione del punto di ancoraggio.
Resi
- la posizione sulla mappa (un
LatLng
).
pubblica Oggetto . getTag ()
Ottiene il tag per il cerchio.
Resi
- il tag, se è stato impostato con
setTag
;null
se non è stato impostato alcun tag.
pubblica in virgola mobile . getTransparency ()
Consente di ottenere la trasparenza di questa sovrapposizione al suolo.
Resi
- la trasparenza di questa sovrapposizione al suolo.
pubblica in virgola mobile . getWidth ()
Restituisce la larghezza dell'overlay al suolo.
Resi
- la larghezza dell'overlay al suolo in metri.
pubblica in virgola mobile . getZIndex ()
Restituisce lo zIndex di questa sovrapposizione del suolo.
Resi
- lo zIndex dell'overlay del suolo.
pubblica int . hashCode ()
pubblica booleano . isClickable ()
Ottieni la cliccabilità dell'overlay del suolo. Se è possibile fare clic sull'overlay al suolo, l'app
riceveranno notifiche a GoogleMap.OnGroundOverlayClickListener
quando l'utente
fa clic sull'overlay al suolo. Il listener di eventi è registrato tramite setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
.
Resi
true
se l'overlay del suolo è cliccabile; altrimenti restituiscefalse
.
pubblica booleano . isVisible ()
Ottiene la visibilità di questa sovrapposizione al suolo. Tieni presente che questo non restituisce se il terreno l'immagine di sovrapposizione è effettivamente sullo schermo, ma se sarà disegnata se è contenuta area visibile.
Resi
- la visibilità dell'overlay del suolo.
pubblica null . rimuovi ()
Rimuove questa sovrapposizione al suolo dalla mappa. Dopo la rimozione di un overlay al suolo, il comportamento di tutti i suoi metodi non è definito.
pubblica null . setBearing (cuscinetto fluttuante)
Imposta l'orientamento dell'overlay del suolo (la direzione in cui si trova l'asse verticale del suolo) punti di sovrapposizione) in gradi in senso orario da nord. La rotazione viene eseguita sull'ancoraggio punto di accesso.
Parametri
bearing | indicazione in gradi in senso orario da nord |
---|
pubblica null . setClickable (booleano selezionabile)
Imposta la cliccabilità dell'overlay al suolo. Se è possibile fare clic sull'overlay al suolo, l'app
riceveranno notifiche a GoogleMap.OnGroundOverlayClickListener
quando l'utente
fa clic sull'overlay al suolo. Il listener di eventi è registrato tramite setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
.
Parametri
selezionabile | Nuova impostazione di cliccabilità per l'overlay al suolo. |
---|
pubblica null . setDimensions (larghezza in virgola mobile, altezza in virgola mobile)
Imposta le dimensioni dell'overlay al suolo. L'immagine verrà allungata per adattarsi alle dimensioni.
Parametri
larghezza | larghezza in metri |
---|---|
altezza | altezza in metri |
pubblica null . setDimensions (larghezza in virgola mobile)
Imposta la larghezza dell'overlay al suolo. L'altezza dell'overlay al suolo verrà adattata di conseguenza per preservare le proporzioni.
Parametri
larghezza | larghezza in metri |
---|
pubblica null . setImage (BitmapDescriptor imageDescriptor)
Imposta l'immagine per l'overlay del suolo. La nuova immagine occuperà gli stessi limiti della vecchia dell'immagine.
Parametri
imageDescriptor | BitmapDescriptor da utilizzare per l'overlay al suolo.
|
---|
pubblica null . setPosition (LatLng latLng)
Imposta la posizione dell'overlay al suolo modificando la posizione del punto di ancoraggio. Conserve tutte le altre proprietà dell'immagine.
Parametri
latLng | un LatLng che corrisponde alla nuova posizione in cui posizionare il punto di ancoraggio.
|
---|
pubblica null . setPositionFromBounds (limiti di LatLngBounds)
Imposta la posizione dell'overlay al suolo adattandolo al LatLngBounds
specificato. Questo
ignora la rotazione (supporto) dell'overlay del suolo durante il posizionamento, ma
l'orientamento verrà ancora utilizzato
per il disegno.
Parametri
limiti | un LatLngBounds in cui posizionare l'overlay al suolo
|
---|
pubblica null . setTag (tag oggetto)
Imposta il tag per l'overlay al suolo.
Puoi utilizzare questa proprietà per associare un Object
arbitrario a questo overlay al suolo.
Ad esempio, Object
può contenere dati relativi a ciò che rappresenta l'overlay al suolo. Questo
è più semplice rispetto all'archiviazione di un elemento Map<GroundOverlay, Object>
separato. Per fare un altro esempio,
può associare un ID String
corrispondente all'ID di un set di dati. Google Maps SDK per
Android non legge né scrive questa proprietà. È tua responsabilità chiamare setTag(null)
per cancellare il tag quando non ti serve più, per evitare fughe di memoria nella tua app.
Parametri
tag | se nullo, il tag viene cancellato. |
---|
pubblica null . setTransparency (trasparenza mobile)
Imposta la trasparenza di questa sovrapposizione al suolo. Consulta la documentazione all'inizio di questo corso per ulteriori informazioni.
Parametri
trasparenza adeguata | un numero in virgola mobile nell'intervallo [0..1] dove 0 indica che il suolo
la sovrapposizione è opaca, mentre 1 indica che l'overlay al suolo è trasparente.
|
---|
pubblica null . setVisible (booleano visibile)
Imposta la visibilità di questa sovrapposizione al suolo. Quando non è visibile, non viene disegnato un overlay al suolo. ma conserva tutte le altre proprietà.
Parametri
visibile | se true , l'overlay del suolo è visibile; se false , non è
|
---|
pubblica null . setZIndex (zIndex in virgola mobile)
Imposta lo zIndex di questa sovrapposizione del suolo. Per saperne di più, consulta la documentazione all'inizio di questo corso informazioni.
Parametri
zIndex | lo zIndex di questa sovrapposizione |
---|