Sovrapposizione al suolo

classe finale pubblica GroundOverlay estende l'oggetto

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

Riepilogo del metodo pubblico

boolean
uguale a (Altro oggetto)
Verifica se questo GroundOverlay è uguale a un altro.
numero in virgola mobile
getBearing()
Recupera il rilevamento della sovrapposizione del suolo in gradi in senso orario da nord.
LatLngBounds
getBounds()
Visualizza i limiti per l'overlay del suolo.
numero in virgola mobile
getHeight
Visualizza l'altezza della sovrapposizione del suolo.
Stringa
getId()
Visualizza l'ID di questo overlay del suolo.
LatLng
getPosition()
Visualizza la posizione del punto di ancoraggio.
Oggetto
getTag
Recupera il tag per il cerchio.
numero in virgola mobile
getTransparency()
Recupera la trasparenza di questo overlay di base.
numero in virgola mobile
getWidth()
Visualizza la larghezza della sovrapposizione del suolo.
numero in virgola mobile
getZIndex()
Visualizza lo z-index di questo overlay di base.
int
boolean
isClickable()
Recupera la cliccabilità dell'overlay del suolo.
boolean
isVisible()
Visualizza la sovrapposizione di questo suolo.
nullo
rimuovi()
Rimuove l'overlay del suolo dalla mappa.
nullo
setBearing(cuscinetto fluttuante)
Imposta la direzione della sovrapposizione del suolo (la direzione in cui punta l'asse verticale del suolo) in gradi in senso orario da nord.
nullo
setClickable(booleano cliccabile)
Imposta la cliccabilità dell'overlay del suolo.
nullo
setSize(larghezza in virgola mobile, altezza in virgola mobile)
Imposta le dimensioni della sovrapposizione del suolo.
nullo
setSize(larghezza in virgola mobile)
Imposta la larghezza dell'overlay del suolo.
nullo
setImage(BitmapDescriptor imageDescriptor)
Imposta l'immagine per la sovrapposizione del suolo.
nullo
setPosition(LatLng latLng)
Consente di impostare la posizione dell'overlay del suolo modificando la posizione del punto di ancoraggio.
nullo
setPositionFromBounds(limiti LatLngBounds)
Consente di impostare la posizione dell'overlay del suolo adattandolo al valore LatLngBounds specificato.
nullo
setTag(Tag oggetto)
Imposta il tag per l'overlay del suolo.
nullo
setTransparency (trasparenza in virgola mobile)
Imposta la trasparenza di questo overlay del suolo.
nullo
setVisible(booleano visibile)
Imposta la visibilità di questo overlay del suolo.
nullo
setZIndex(zindex mobile)
Imposta lo z-index di questo overlay del suolo.

Riepilogo del metodo ereditato

Metodi pubblici

pubblico booleano uguale a (Altro oggetto)

Verifica se questo GroundOverlay è uguale a un altro.

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

floating pubblico getBearing ()

Recupera il rilevamento della sovrapposizione del suolo in gradi in senso orario da nord.

Restituisce
  • il supporto della sovrapposizione del suolo.

pubblico LatLngBounds getBounds ()

Visualizza i limiti per l'overlay del suolo. La rotazione della sovrapposizione del suolo viene ignorata.

Restituisce
  • Un LatLngBounds che contiene l'overlay del suolo, ignorando la rotazione.

floating pubblico getHeight ()

Visualizza l'altezza della sovrapposizione del suolo.

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

pubblica Stringa getId ()

Visualizza l'ID di questo overlay del suolo. L'ID sarà univoco tra tutti i GroundOverlays su una mappa.

Restituisce
  • questo overlay di base.

pubblica LatLng getPosition ()

Visualizza la posizione del punto di ancoraggio.

Restituisce
  • la posizione sulla mappa (a LatLng).

pubblico Oggetto getTag ()

Recupera il tag per il cerchio.

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

floating pubblico getTransparency ()

Recupera la trasparenza di questo overlay di base.

Restituisce
  • la trasparenza di questa sovrapposizione.

floating pubblico getWidth ()

Visualizza la larghezza della sovrapposizione del suolo.

Restituisce
  • la larghezza della sovrapposizione del suolo in metri.

floating pubblico getZIndex ()

Visualizza lo z-index di questo overlay di base.

Restituisce
  • Lo z-index dell'overlay del suolo.

public int hashCode ()

pubblico booleano isClickable ()

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

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

pubblico booleano isVisible ()

Visualizza la sovrapposizione di questo suolo. Tieni presente che non restituisce se l'overlay del suolo è effettivamente visibile sullo schermo, ma se verrà disegnato se è contenuto nell'area visibile della fotocamera.

Restituisce
  • la visibilità di questo overlay di base.

pubblica void rimuovi ()

Rimuove l'overlay del suolo dalla mappa. Una volta rimosso un overlay di base, il comportamento di tutti i suoi metodi non è definito.

pubblica void setBearing (cuscinetto fluttuante)

Imposta la direzione della sovrapposizione del suolo (la direzione in cui punta l'asse verticale del suolo) in gradi in senso orario da nord. La rotazione viene eseguita per il punto di ancoraggio.

Parametri
bearing rilevamento in gradi in senso orario da nord

pubblico void setClickable (booleano cliccabile)

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

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

public void setSize (larghezza del galleggiante, altezza del galleggiante)

Imposta le dimensioni della sovrapposizione del suolo. L'immagine verrà allungata per adattarsi alle dimensioni.

Parametri
width larghezza in metri
height altezza in metri

pubblica void setSize (larghezza di virgola mobile)

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

Parametri
width larghezza in metri

pubblica void setImage (BitmapDescriptor imageDescriptor)

Imposta l'immagine per la sovrapposizione del suolo. La nuova immagine troverà gli stessi limiti della vecchia immagine.

Parametri
imageDescriptor il BitmapDescriptor da utilizzare per questo overlay di base.

public void setPosition (LatLng latLng)

Consente di impostare la posizione dell'overlay del suolo modificando la posizione del punto di ancoraggio. Conserva tutte le altre proprietà dell'immagine.

Parametri
latLng Una LatLng che è la nuova posizione in cui posizionare il punto di ancoraggio.

public void setPositionFromBounds (limiti 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 il cuscinetto verrà comunque utilizzato durante il disegno.

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

pubblica void setTag (Tag oggetto)

Imposta il tag per l'overlay del suolo.

Puoi utilizzare questa proprietà per associare un elemento Object arbitrario a questo overlay di base. 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à. È tua responsabilità chiamare il numero setTag(null) per cancellare il tag quando non ti serve più, per evitare perdite di memoria nella tua app.

Parametri
tag (m.) se il valore è null, il tag viene cancellato.

pubblico void setTransparency (trasparenza in virgola mobile)

Imposta la trasparenza di questo overlay del suolo. Per ulteriori informazioni, consulta la documentazione all'inizio di questo corso.

Parametri
trasparenza Un numero in virgola mobile nell'intervallo [0..1] in cui 0 indica che l'overlay del suolo è opaco e 1 indica che l'overlay del suolo è trasparente.

pubblica void setVisible (booleano visibile)

Imposta la visibilità di questo overlay del suolo. Se non è visibile, non viene tracciato un overlay del suolo, ma conserva tutte le altre proprietà.

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

pubblico void setZIndex (zindex mobile)

Imposta lo z-index di questo overlay del suolo. Per ulteriori informazioni, consulta la documentazione all'inizio di questo corso.

Parametri
z-index Lo z-index di questo overlay di base