Poligono

Un poligono sulla superficie terrestre. Un poligono può essere convesso o concavo, può estendersi sui 180 meridiani e può presentare fori che non vengono riempiti. Ha le seguenti proprietà:

Struttura

Il contorno è specificato da un elenco di vertici in senso orario o antiorario. Non è necessario che i punti di inizio e fine coincidano. In caso contrario, il poligono verrà chiuso automaticamente. I segmenti vengono disegnati tra punti consecutivi nelle due direzioni più brevi (est o ovest).

Buchi

Un foro è una regione all'interno del poligono che non è riempita. Un foro viene specificato esattamente nello stesso modo del contorno. Un foro deve essere racchiuso completamente nel contorno. È possibile specificare più fori, anche se i fori sovrapposti non sono supportati.

Larghezza tratto

Larghezza del segmento della linea in pixel dello schermo. La larghezza è costante e indipendente dal livello di zoom della videocamera. Il valore predefinito è 10.

Colore tratto

Colore segmento in formato ARGB, lo stesso formato utilizzato da Color. Il valore predefinito è nero (0xff000000).

Tipo di bracciata

Il tipo di unione definisce la forma da utilizzare quando si uniscono segmenti di linee adiacenti a tutti i vertici del contorno del poligono. Consulta JointType per i tipi di articolazioni supportati. Il valore predefinito è DEFAULT.

Tracciato

Solido (predefinito, rappresentato da null) o una sequenza di oggetti PatternItem da ripetere lungo il contorno del poligono. Tipi di PatternItem disponibili: Gap (definito dalla lunghezza del divario in pixel), Dash (definito dalla larghezza del tratto e dalla lunghezza del trattino in pixel) e Dot (circolare, centrato sul contorno del poligono, diametro definito dal tratto in pixel).

Colore riempimento

Inserisci il colore in formato ARGB, lo stesso formato utilizzato da Color. Il valore predefinito è trasparente (0x00000000). Se la geometria del poligono non è specificata correttamente (vedi sopra per Outline e Fori), non verrà tracciato alcun riempimento.

Z-index

L'ordine in cui viene tracciato questo poligono rispetto agli altri overlay, inclusi Polyline, Circle, GroundOverlay e TileOverlay, ma non Marker. Un overlay con uno z-index più grande viene disegnato su overlay con z-index più piccoli. L'ordine degli overlay con lo stesso valore z-index è arbitrario. Il valore predefinito è 0.

Visibilità

Indica se il poligono è visibile o invisibile, ovvero se è disegnato sulla mappa. Un poligono invisibile non viene tracciato, ma conserva tutte le altre proprietà. Il valore predefinito è true, ovvero visibile.

Stato geodetico

Indica se i segmenti del poligono devono essere disegnati come geodetici, anziché su 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 questa proprietà è impostata su true, la tua app riceverà notifiche per il dominio GoogleMap.OnPolygonClickListener registrato tramite setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Tag

Un Object associato al poligono. Ad esempio, Object può contenere dati su ciò che il poligono rappresenta. Questa operazione è più semplice rispetto all'archiviazione di un Map<Polygon, 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.
 // 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, leggi la guida per gli sviluppatori di Shapes.