Sovrapposizione al suolo

lezione finale pubblica GroundOverlay estende l'oggetto

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.
Devi specificare la posizione dell'overlay del suolo prima che venga aggiunto alla mappa In caso contrario, verrà generato un IllegalArgumentException quando l'overlay al suolo aggiunti alla mappa. Inoltre, devi specificare la posizione utilizzando solo uno di questi nell'oggetto GroundOverlayOptions; In caso contrario, viene generato un valore IllegalStateException quando viene specificato l'utilizzo di un secondo metodo.
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 un IllegalArgumentException 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 e TileOverlay, ma non Marker). 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], dove 0 indica la l'overlay è opaco e 1 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 su true, la tua app riceverà notifiche relative a GoogleMap.OnGroundOverlayClickListener registrato tramite setOnGroundOverlayClickListener(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 separa Map<GroundOverlay, Object>. Come ulteriore esempio, puoi associare un ID String 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
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
setImage(BitmapDescriptor imageDescriptor)
Imposta l'immagine per l'overlay del suolo.
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 restituisce false.

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