Poligono

lezione finale pubblica Poligono estende l'oggetto

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 di PatternItem oggetti da ripetere lungo il contorno del poligono. Tipi di PatternItem disponibili: Gap (definito dalla lunghezza dell'intervallo in pixel), Dash (definito dalla larghezza del tratto e dal trattino). lunghezza in pixel) e Dot (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 e TileOverlay, ma non Marker 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 su true, la tua app riceverà notifiche per il GoogleMap.OnPolygonClickListener registrato tramite setOnPolygonClickListener(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 file Map<Polygon, Object> separato. Per fare un altro esempio, puoi associare un ID String 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
uguale a(altro oggetto)
Verifica se questo valore di Polygon è uguale a un altro.
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
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
setHoles(List<? estende i fori List<LatLng>>)
Imposta i fori di questo poligono.
null
setPoints(Elenco<LatLng> punti)
Consente di impostare i punti del poligono.
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)

Verifica se questo valore di Polygon è uguale a un altro.

Parametri
altro Object.
Resi
  • true se entrambi gli oggetti sono lo stesso oggetto, ovvero questo == altro.

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 restituisce false.

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.