Polilinea

Una polilinea è un elenco di punti in cui i segmenti vengono tracciati tra punti consecutivi. R polilinea ha le seguenti proprietà:

Punti

I vertici della linea. I segmenti di linea vengono tracciati tra punti consecutivi. Una polilinea è non chiuso per impostazione predefinita; per formare una polilinea chiusa, i punti iniziale e finale devono essere allo stesso modo.

Larghezza

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

Colore

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

.

Immagine statica iniziale/finale

Definisce la forma da utilizzare all'inizio o alla fine di una polilinea. Tipi di limiti supportati: ButtCap, SquareCap, RoundCap (applicabile per pattern tratto in tinta unita) e CustomCap (applicabile per qualsiasi motivo del tratto). Valore predefinito sia per l'inizio che per la fine: ButtCap.

Tipo di giunzione

Il tipo di giunzione definisce la forma da utilizzare per unire segmenti di linea adiacenti vertici della polilinea, ad eccezione dei vertici iniziale e finale. Vedi JointType per tipi di giunti supportati. Il valore predefinito è DEFAULT.

Sequenza tratto

Solido (predefinito, rappresentato da null) o una sequenza di PatternItem oggetti da ripetere lungo la riga. Tipi di PatternItem disponibili: Gap (definiti da lunghezza intervallo in pixel), Dash (definito da larghezza della linea e lunghezza del trattino in pixel) e Dot (circolare, centrato sulla linea, diametro definito dallo spessore della linea in pixel).

Z-index

L'ordine in cui viene disegnato l'overlay dei riquadri rispetto agli altri overlay (inclusi GroundOverlay, TileOverlay s, Circle e Polygon s 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 z-index è arbitrario. Il valore predefinito di zIndex è 0.

Visibilità

Indica se la polilinea è visibile o invisibile, ovvero se è disegnata sulla mappa. Un la polilinea invisibile non viene tracciata, ma conserva tutte le altre proprietà. L'impostazione predefinita è true, ovvero visibile.

Stato geodetica

Indica se i segmenti della polilinea 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 sulla polilinea, 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.OnPolylineClickListener registrato tramite setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Tag

Un Object associato alla polilinea. Ad esempio, Object può contenere i dati relativi a ciò che rappresenta la polilinea. È più semplice che archiviare un file Map<Polyline, 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à.

Intervalli

definisce le sezioni con stili diversi utilizzati per visualizzare questa polilinea. Puoi utilizzare questo per creare una polilinea con StrokeStyle diversi su segmenti diversi di la polilinea.

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 thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));
 

Guida per gli sviluppatori

Per ulteriori informazioni, consulta lo sviluppatore Shapes guida.