Un overlay riquadro è un insieme di immagini che vengono visualizzate sopra i riquadri della mappa base. Questi riquadri può essere trasparente, consentendoti di aggiungere elementi a mappe esistenti. Un overlay riquadro ha seguenti proprietà:
- Fornitore di riquadri
- L'elemento
TileProvider
fornisce le immagini utilizzate nell'overlay del riquadro. Devi specificare il fornitore di riquadri prima che venga aggiunto alla mappa. Il fornitore dei riquadri non può essere modificato dopo l'aggiunta. ma puoi modificare il comportamento del provider di riquadri per restituire immagini diverse per coordinate specifiche. Se i riquadri forniti dal riquadro modifica del fornitore, devi chiamareclearTileCache()
in seguito per assicurarti che i riquadri precedenti non vengono più visualizzati. - Z-index
- L'ordine in cui viene disegnato l'overlay dei riquadri rispetto agli altri overlay (inclusi
GroundOverlay
,Circle
s,Polyline
ePolygon
s ma nonMarker
). Un overlay con uno z-index più grande viene disegnato sopra gli overlay con dimensioni indici z. L'ordine degli overlay con lo stesso z-index è arbitrario. Il valore predefinito di zIndex è 0. - Trasparenza
- Trasparenza dell'overlay dei riquadri nell'intervallo
[0..1]
, dove0
indica 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 la trasparenza dell'overlay dei riquadri è pari a 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 l'overlay del riquadro è visibile o invisibile, ovvero se è disegnato su
mappa. Un overlay riquadro invisibile non viene disegnato, ma conserva tutte le altre proprietà. La
Il valore predefinito è
true
, ovvero visibile.
Devi richiamare solo i metodi di questa classe nel thread principale. In caso contrario,
IllegalStateException
.
Coordinate dei riquadri
Tieni presente che il mondo viene proiettato utilizzando la proiezione di Mercatore (vedi Wikipedia) con il lato sinistro (ovest) della mappa corrispondente a -180 gradi di longitudine e al lato destro (est) della mappa corrispondente a 180 gradi di longitudine. Per rendere la mappa quadrata, il lato superiore (nord) della La mappa corrisponde a 85,0511 gradi di latitudine e il lato inferiore (sud) della mappa corrisponde a -85,0511 gradi di latitudine. Il rendering delle aree al di fuori di questo intervallo di latitudine non viene eseguito.
Ad ogni livello di zoom, la mappa viene divisa in riquadri e solo nei riquadri che si sovrappongono allo schermo. vengono scaricati e visualizzati. Ogni riquadro è quadrato e la mappa è divisa in riquadri nel seguente modo:
- A livello di zoom pari a 0, un riquadro rappresenta il mondo intero. Le coordinate del riquadro sono (x, y) = (0, 0).
- Al livello di zoom 1, il mondo è diviso in 4 caselle disposte in una griglia 2 x 2.
- …
- A livello di zoom N, il mondo è diviso in 4N riquadri disposti in modo da 2N x 2N sulla griglia.
GoogleMap.getMinZoomLevel
e
il livello di zoom massimo è GoogleMap.getMaxZoomLevel
.
Le coordinate dei riquadri sono misurate dall'angolo in alto a sinistra (nord-ovest) della mappa. Alle ore
livello di zoom N, i valori x
delle coordinate dei riquadri sono compresi tra 0 e 2N - 1 e
di aumento da ovest a est e i valori y
sono compresi tra 0 e 2N - 1 e
aumenta da nord a sud.
Esempio
GoogleMap map; // ... get a map.
TileProvider tileProvider; // ... create a tile provider.
TileOverlay tileOverlay = map.addTileOverlay(
new TileOverlayOptions().tileProvider(tileProvider));
Riepilogo del metodo pubblico
null |
clearTileCache()
Cancella la cache dei riquadri in modo che tutti i riquadri vengano richiesti nuovamente da
TileProvider . |
booleano |
uguale a(altro oggetto)
Verifica se questo valore di
TileOverlay è uguale a un altro. |
booleano |
getFadeIn()
Determina se i riquadri di overlay devono entrare in dissolvenza.
|
Stringa |
getId()
Ottiene l'ID di questo overlay di riquadri.
|
numero in virgola mobile |
getTransparency()
Consente di ottenere la trasparenza dell'overlay del riquadro.
|
numero in virgola mobile |
getZIndex()
Restituisce lo zIndex di questo overlay di riquadri.
|
int |
hashCode()
|
booleano |
isVisible()
Consente di acquisire la visibilità di questo overlay riquadro.
|
null |
remove()
Rimuove questo overlay riquadro dalla mappa.
|
null |
setFadeIn(boolean fadeIn)
Consente di impostare la dissolvenza in entrata dei riquadri di overlay.
|
null |
setTransparency(trasparenza mobile)
Imposta la trasparenza dell'overlay del riquadro.
|
null |
setVisible(boolean visible)
Imposta la visibilità di questo overlay del riquadro.
|
null |
setZIndex(float zIndex)
Imposta lo zIndex di questa sovrapposizione di riquadri.
|
Riepilogo del metodo ereditato
Metodi pubblici
pubblica null . clearTileCache ()
Cancella la cache dei riquadri in modo che tutti i riquadri vengano richiesti nuovamente da TileProvider
.
Anche i riquadri correnti di questa sovrapposizione di riquadri verranno cancellati dalla mappa dopo la chiamata
. L'API gestisce una piccola cache in memoria di riquadri. Se vuoi memorizzare nella cache i riquadri
dovresti implementare una cache su disco.
pubblica booleano . uguale a (altro oggetto)
Verifica se questo valore di TileOverlay
è uguale a un altro.
Parametri
altro | Object . |
---|
Resi
- true se entrambi gli oggetti sono lo stesso oggetto, ovvero questo == altro.
pubblica booleano . getFadeIn ()
Determina se i riquadri di overlay devono entrare in dissolvenza.
Resi
true
se i riquadri devono finire in dissolvenza;false
se non lo sono.
pubblica Stringa . getId ()
Ottiene l'ID di questo overlay di riquadri.
pubblica in virgola mobile . getTransparency ()
Consente di ottenere la trasparenza dell'overlay del riquadro.
Resi
- la trasparenza dell'overlay dei riquadri.
pubblica in virgola mobile . getZIndex ()
Restituisce lo zIndex di questo overlay di riquadri.
Resi
- lo zIndex dell'overlay dei riquadri.
pubblica int . hashCode ()
pubblica booleano . isVisible ()
Consente di acquisire la visibilità di questo overlay riquadro. Tieni presente che non viene indicato se il riquadro si trova all'interno dell'area visibile dello schermo, ma indica se sarà disegnato contenuto nell'area visibile dello schermo.
Resi
- la visibilità di questo overlay riquadro.
pubblica null . rimuovi ()
Rimuove questo overlay riquadro dalla mappa.
pubblica null . setFadeIn (fadeIn booleano)
Consente di impostare la dissolvenza in entrata dei riquadri di overlay.
Parametri
fadeIn | true per far scomparire i riquadri; false per eseguirne il rendering istantaneo.
|
---|
pubblica null . setTransparency (trasparenza mobile)
Imposta la trasparenza dell'overlay del riquadro. 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 riquadro
la sovrapposizione è opaca, mentre 1 indica che l'overlay del riquadro è trasparente.
|
---|
pubblica null . setVisible (booleano visibile)
Imposta la visibilità di questo overlay del riquadro. Quando non è visibile, l'overlay del riquadro non viene disegnato, ma conserva tutte le altre proprietà. Gli overlay riquadro sono visibili per impostazione predefinita.
Parametri
visibile | true per rendere visibile questo overlay; false per renderlo invisibile.
|
---|
pubblica null . setZIndex (zIndex in virgola mobile)
Imposta lo zIndex di questa sovrapposizione di riquadri. Per saperne di più, consulta la documentazione all'inizio di questo corso informazioni.
Parametri
zIndex | lo zIndex di questa sovrapposizione di riquadri. |
---|