Un poligono sulla superficie terrestre. Un poligono può essere convesso o concavo e può estendersi meridiano e può avere fori che non sono stati riempiti. Ha le seguenti proprietà:
- Contorno
- Il contorno è specificato da un elenco di vertici in ordine orario o antiorario. it non è necessario perché i punti di partenza e di arrivo coincidano; In caso contrario, il poligono automaticamente. I segmenti di linea vengono tracciati tra punti consecutivi nel segmento delle due direzioni (est o ovest).
- Spazi vuoti
- Un buco è un'area non riempita all'interno del poligono. Un buco è specificato esattamente esattamente come la struttura. Un foro deve essere contenuto completamente all'interno del contorno. Più di uno è possibile specificare i fori, ma i fori sovrapposti non sono supportati.
- Larghezza tratto
- Larghezza del segmento della linea in pixel dello schermo. La larghezza è costante e indipendente dalla livello di zoom. Il valore predefinito è 10.
- Colore tratto
- Colore del segmento delle linee nel formato ARGB, lo stesso formato utilizzato da
Color
. Il valore predefinito è nero (0xff000000
). . - Tipo di giunzione tratto
- Il tipo di giunzione definisce la forma da utilizzare per unire segmenti di linea adiacenti
vertici del contorno del poligono. Consulta
JointType
per i tipi di giunti supportati. La il valore predefinito èDEFAULT
. - Sequenza tratto
- Solido (predefinito, rappresentato da
null
) o una sequenza diPatternItem
oggetti da ripetere lungo il contorno del poligono. Tipi diPatternItem
disponibili:Gap
(definito dalla lunghezza dell'intervallo in pixel),Dash
(definito dalla larghezza del tratto e dal trattino). lunghezza in pixel) eDot
(circolare, centrato sul contorno, diametro del poligono definito dallo spessore del tratto in pixel). - Colore riempimento
- Colore di riempimento in formato ARGB, lo stesso formato utilizzato da
Color
. La il valore predefinito è trasparente (0x00000000
). Se la geometria del poligono non è specificata correttamente (vedi sopra per contorni e buchi), non verrà tracciato alcun riempimento. - Z-index
- L'ordine in cui viene tracciato il poligono rispetto ad altri overlay, inclusi
Polyline
,Circle
,GroundOverlay
eTileOverlay
, 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 valore z-index è arbitrario. L'impostazione predefinita è 0. - Visibilità
- Indica se il poligono è visibile o invisibile, ovvero se è stato disegnato sulla mappa. Un
un poligono invisibile non viene disegnato, ma conserva tutte le altre proprietà. L'impostazione predefinita è
true
, ovvero visibile. - Stato geodetica
- Indica se i segmenti del poligono devono essere disegnati come geodetiche, anziché linee rette sulla proiezione di Mercatore. Una geodetica è il percorso più breve tra due punti sulla superficie terrestre. La curva geodetica viene costruita supponendo che la Terra sia una sfera
- Cliccabilità
- Se vuoi gestire gli eventi attivati quando l'utente fa clic sul poligono, imposta questa proprietà su
true
. Puoi modificare questo valore in qualsiasi momento. Il valore predefinito èfalse
. Se questo è impostata sutrue
, la tua app riceverà notifiche per ilGoogleMap.OnPolygonClickListener
registrato tramitesetOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
. - Tag
- Un
Object
associato al poligono. Ad esempio,Object
può contenere i dati su ciò che rappresenta il poligono. È più semplice che archiviare un fileMap<Polygon, Object>
separato. Per fare un altro esempio, puoi associare un IDString
corrispondente all'ID di un set di dati. Google Maps SDK for Android non legge né legge 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.
// Add a triangle in the Gulf of Guinea
Polygon polygon = map.addPolygon(new PolygonOptions()
.add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
.strokeColor(Color.RED)
.fillColor(Color.BLUE));
Guida per gli sviluppatori
Per ulteriori informazioni, consulta lo sviluppatore Shapes guida.
Riepilogo del metodo pubblico
booleano | |
int |
getFillColor()
Ottiene il colore di riempimento di questo poligono.
|
Elenco<List<LatLng>> |
getHoles()
Restituisce un'istantanea dei fori di questo poligono presenti in quel momento .
|
Stringa |
getId()
Ottiene l'ID di questo poligono.
|
Elenco<LatLng> |
getPoints()
Restituisce un'istantanea dei vertici di questo poligono in questo momento .
|
int |
getStrokeColor()
Restituisce il colore del tratto di questo poligono.
|
int |
getStrokeJointType()
Restituisce il tipo di giunto del tratto utilizzato in tutti i vertici del contorno del poligono.
|
Elenco<PatternItem> |
getStrokePattern()
Restituisce il pattern del tratto del contorno di questo poligono.
|
numero in virgola mobile |
getStrokeWidth()
Restituisce lo spessore del tratto di questo poligono.
|
Oggetto |
getTag()
Ottiene il tag per il poligono.
|
numero in virgola mobile |
getZIndex()
Restituisce il valore zIndex di questo poligono.
|
int |
hashCode()
|
booleano |
isClickable()
Restituisce la cliccabilità del poligono.
|
booleano |
isGeodesic()
Riconosce se ogni segmento della linea è stato tracciato come geodetica o meno.
|
booleano |
isVisible()
Ottiene la visibilità di questo poligono.
|
null |
remove()
Rimuove il poligono dalla mappa.
|
null |
setClickable(booleano selezionabile)
Consente di impostare la cliccabilità del poligono.
|
null |
setFillColor(int color)
Imposta il colore di riempimento di questo poligono.
|
null |
setGeodesic(boolean geodesic)
Consente di stabilire se tracciare ogni segmento della linea come geodetica o meno.
|
null | |
null | |
null |
setStrokeColor(int color)
Imposta il colore del tratto di questo poligono.
|
null |
setStrokeJointType(int jointType)
Imposta il tipo di giunto per tutti i vertici del contorno del poligono.
|
null |
setStrokePattern(List<PatternItem> pattern)
Consente di impostare il pattern del tratto del contorno del poligono.
|
null |
setStrokeWidth(larghezza in virgola mobile)
Imposta lo spessore del tratto di questo poligono.
|
null |
setTag(tag oggetto)
Imposta il tag per il poligono.
|
null |
setVisible(boolean visible)
Consente di impostare la visibilità di questo poligono.
|
null |
setZIndex(float zIndex)
Imposta il valore zIndex di questo poligono.
|
Riepilogo del metodo ereditato
Metodi pubblici
pubblica booleano . uguale a (altro oggetto)
pubblica int . getFillColor ()
Ottiene il colore di riempimento di questo poligono.
Resi
- il colore in formato ARGB.
pubblica Elenco<List<LatLng>> getHoles ()
Restituisce un'istantanea dei fori di questo poligono presenti in quel momento . L'elenco restituito è una copia l'elenco dei fori, per cui le modifiche apportate ai fori del poligono non vengono riportate in questo elenco, né le modifiche all'elenco saranno riflette dal poligono.
pubblica Stringa . getId ()
Ottiene l'ID di questo poligono. L'ID sarà univoco tra tutti i poligoni su una mappa.
pubblica Elenco<LatLng> getPoints ()
Restituisce un'istantanea dei vertici di questo poligono in questo momento . L'elenco restituito è una copia
dell'elenco dei vertici, pertanto le modifiche apportate ai vertici del poligono non verranno applicate
dall'elenco, né le modifiche apportate all'elenco
verranno riportate dal poligono. Per modificare i vertici di
poligono, chiama setPoints(List)
.
pubblica int . getStrokeColor ()
Restituisce il colore del tratto di questo poligono.
Resi
- il colore in formato ARGB.
pubblica int . getStrokeJointType ()
Restituisce il tipo di giunto del tratto utilizzato in tutti i vertici del contorno del poligono. Vedi JointType
per i valori possibili.
Resi
- il tipo di giunzione dello ictus.
pubblica Elenco<PatternItem> getStrokePattern ()
Restituisce il pattern del tratto del contorno di questo poligono.
Resi
- lo schema del tratto.
pubblica in virgola mobile . getStrokeWidth ()
Restituisce lo spessore del tratto di questo poligono.
Resi
- la larghezza in pixel dello schermo.
pubblica Oggetto . getTag ()
Ottiene il tag per il poligono.
Resi
- il tag, se è stato impostato con
setTag
;null
se non è stato impostato alcun tag.
pubblica in virgola mobile . getZIndex ()
Restituisce il valore zIndex di questo poligono.
Resi
- lo zIndex del poligono.
pubblica int . hashCode ()
pubblica booleano . isClickable ()
Restituisce la cliccabilità del poligono. Se è possibile fare clic sul poligono, l'app riceverà
Notifiche alla GoogleMap.OnPolygonClickListener
quando l'utente fa clic sul poligono.
Il listener di eventi è registrato tramite setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
.
Resi
true
se il poligono è cliccabile. altrimenti restituiscefalse
.
pubblica booleano . isGeodesic ()
Riconosce se ogni segmento della linea è stato tracciato come geodetica o meno.
Resi
true
se ogni segmento è disegnato come geodetica;false
se ogni segmento è disegnata come una linea retta sulla proiezione di Mercatore.
pubblica booleano . isVisible ()
Ottiene la visibilità di questo poligono.
Resi
- la visibilità di questo poligono.
pubblica null . rimuovi ()
Rimuove il poligono dalla mappa. Dopo che un poligono è stato rimosso, il comportamento di tutte le sue non è definito.
pubblica null . setClickable (booleano selezionabile)
Consente di impostare la cliccabilità del poligono. Se è possibile fare clic sul poligono, l'app riceverà
Notifiche alla GoogleMap.OnPolygonClickListener
quando l'utente fa clic sul poligono.
Il listener di eventi è registrato tramite setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
.
Parametri
selezionabile | Nuova impostazione di cliccabilità per il poligono. |
---|
pubblica null . setFillColor (colore int)
Imposta il colore di riempimento di questo poligono.
Parametri
colore | il colore in formato ARGB |
---|
pubblica null . setGeodesic (geodetica booleana)
Consente di stabilire se tracciare ogni segmento della linea come geodetica o meno.
Parametri
geodetica | se true , ogni segmento è tracciato come una regione geodetica; se false ,
ciascun segmento è tracciato come una linea retta sulla proiezione di Mercatore.
|
---|
pubblica null . setHoles (List<? estende i punti elenco<LatLng>>)
Imposta i fori di questo poligono. Questo metodo prenderà una copia dei fori, quindi ulteriori mutazioni
a holes
non avrà alcun effetto su questo poligono.
Parametri
buchi | un elenco di buchi, dove un buco è un elenco di LatLng .
|
---|
pubblica null . setPoints (Elenco<LatLng> punti)
Consente di impostare i punti del poligono. Questo metodo utilizza una copia dei punti, quindi
le mutazioni in points
non avranno effetto su questo poligono.
Parametri
punti | un elenco di LatLng che sono i vertici del poligono.
|
---|
pubblica null . setStrokeColor (colore int)
Imposta il colore del tratto di questo poligono.
Parametri
colore | il colore in formato ARGB |
---|
pubblica null . setStrokeJointType (int jointType)
Imposta il tipo di giunto per tutti i vertici del contorno del poligono.
Consulta JointType
per i valori consentiti. Verrà applicato il valore predefinito DEFAULT
da utilizzare se il tipo di giunto non è definito o non è uno dei valori consentiti.
Parametri
jointType | il tipo di giunzione dello ictus. |
---|
pubblica null . setStrokePattern (pattern List<PatternItem>)
Consente di impostare il pattern del tratto del contorno del poligono. Il pattern del tratto predefinito è in tinta unita,
rappresentato da null
.
Parametri
pattern | lo schema del tratto. |
---|
pubblica null . setStrokeWidth (larghezza in virgola mobile)
Imposta lo spessore del tratto di questo poligono.
Parametri
larghezza | la larghezza in pixel di visualizzazione. |
---|
pubblica null . setTag (tag oggetto)
Imposta il tag per il poligono.
Puoi utilizzare questa proprietà per associare un Object
arbitrario a questo poligono. Per
Ad esempio, Object
può contenere dati relativi a ciò che rappresenta il poligono. È più facile
rispetto all'archiviazione di un elemento Map<Polygon, Object>
separato. Per fare un altro esempio, puoi associare una
ID String
corrispondente all'ID di un set di dati. né Google Maps SDK per Android né
legge né scrive questa proprietà. È tua responsabilità chiamare setTag(null)
per risolvere
quando non ti serve più, per evitare fughe di memoria nella tua app.
Parametri
tag | se nullo, il tag viene cancellato. |
---|
pubblica null . setVisible (booleano visibile)
Consente di impostare la visibilità di questo poligono. Quando non è visibile, il poligono non viene disegnato, ma mantiene tutti le sue altre proprietà.
Parametri
visibile | se true , il poligono è visibile. se false , non lo è.
|
---|
pubblica null . setZIndex (zIndex in virgola mobile)
Imposta il valore zIndex di questo poligono. I poligoni con zIndici più alti sono tracciati sopra quelli con indici.
Parametri
zIndex | lo zIndex di questo poligono. |
---|