Polilinea

classe pubblica finale Polyline estende Object

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

Punti
I vertici della linea. I segmenti di linea vengono tracciati tra punti consecutivi. Una polilinea non è chiusa per impostazione predefinita; per formare una polilinea chiusa, i punti iniziale e finale devono essere uguali.
Larghezza
Larghezza del segmento in pixel dello schermo. La larghezza è costante e indipendente dal livello di zoom della fotocamera. Il valore predefinito è 10.
Colore
Colore del segmento della linea in formato ARGB, lo stesso formato utilizzato da Color. Il valore predefinito è nero (0xff000000).
Limite di inizio/fine
Definisce la forma da utilizzare all'inizio o alla fine di una polilinea. Tipi di cappello supportati: ButtCap, SquareCap, RoundCap (applicabile per pattern del tratto continuo) e CustomCap (applicabile per qualsiasi pattern del tratto). Valore predefinito sia per l'inizio che per la fine: ButtCap.
Tipo di giunto
Il tipo di giunto definisce la forma da utilizzare quando unisci segmenti di linee adiacenti su tutti i vertici della polilinea, ad eccezione dei vertici di inizio e fine. Consulta JointType per i tipi di giunti supportati. Il valore predefinito è DEFAULT.
Sequenza del tratto
Solido (predefinito, rappresentato da null) o una sequenza di PatternItem oggetti da ripetere lungo la linea. Tipi di PatternItem disponibili: Gap (definito in base alla lunghezza dell'intervallo in pixel), Dash (definito in base alla larghezza della linea e alla lunghezza del trattino in pixel) e Dot (circolare, centrato sulla linea, il diametro definito dallo spessore della linea in pixel).
Z-index
L'ordine in cui l'overlay riquadro viene disegnato rispetto ad altri overlay (inclusi GroundOverlay, TileOverlay, Circle e Polygon ma non Marker). Un overlay con uno z-index più grande viene disegnato sopra gli overlay con indici z più piccoli. L'ordine delle sovrapposizioni 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. Una polilinea invisibile non viene disegnata, ma conserva tutte le altre proprietà. Il valore predefinito è true, ovvero visibile.
Stato geodetico
Indica se i segmenti della polilinea devono essere tracciati come geodetici, anziché come linee rette sulla proiezione di Mercatore. Una geodetica è il percorso più breve tra due punti sulla superficie terrestre. La curva geodetica viene creata 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 questa proprietà viene impostata su true, la tua app riceverà notifiche al GoogleMap.OnPolylineClickListener registrato tramite setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
Tag
Un elemento Object associato alla polilinea. Ad esempio, Object può contenere dati relativi a ciò che rappresenta la polilinea. Questa operazione è più semplice rispetto all'archiviazione di un Map<Polyline, Object> separato. Come ulteriore esempio, puoi associare un ID String corrispondente all'ID di un set di dati. L'SDK Google Maps for Android non legge né scrive questa proprietà.
Intervalli
Definisce gli intervalli con stili diversi utilizzati per il rendering di questa polilinea. Puoi utilizzare questa proprietà per creare una polilinea con StrokeStyle diverso su segmenti diversi della polilinea.

I metodi di questa classe devono essere chiamati nel thread dell'interfaccia utente Android. In caso contrario, verrà generato un IllegalStateException in fase di runtime.

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 maggiori informazioni, leggi la guida per gli sviluppatori di Forme.

Riepilogo del metodo pubblico

boolean
uguale a(oggetto altro)
Verifica se questo Polyline è uguale a un altro.
int
getColor()
Consente di acquisire il colore di questa polilinea.
Cappello
getEndCap()
Restituisce il limite al vertice finale di questa polilinea.
Stringa
getId()
Recupera l'ID di questa polilinea.
int
getJointType()
Restituisce il tipo di giunto utilizzato in tutti i vertici della polilinea, ad eccezione dei vertici di inizio e fine.
List<PatternItem>
getPattern()
Restituisce lo schema del tratto di questa polilinea.
List<LatLng>
getPoints()
Restituisce un'istantanea dei vertici di questa polilinea in questo momento .
Cappello
getStartCap()
Ottieni il limite nel vertice iniziale di questa polilinea.
Oggetto
getTag()
Restituisce il tag per la polilinea.
float
getWidth()
Restituisce la larghezza di questa polilinea.
float
getZIndex()
Restituisce lo zIndex di questa polilinea.
int
boolean
isClickable()
Restituisce la cliccabilità della polilinea.
boolean
isGeodesic()
Riconosce se ogni segmento della linea è tracciato come geodetico o meno.
boolean
isVisible()
Restituisce la visibilità di questa polilinea.
void
remove()
Rimuove questa polilinea dalla mappa.
void
setClickable(cliccabile booleano)
Imposta la cliccabilità della polilinea.
void
setColor(colore interno)
Imposta il colore della polilinea.
void
setEndCap(Cap endCap)
Imposta il limite al vertice finale di questa polilinea.
void
setGeodesic(geodetica booleana)
Consente di impostare se tracciare ogni segmento della linea come geodetico o meno.
void
setJointType(int jointType)
Imposta il tipo di giunto per tutti i vertici della polilinea, ad eccezione dei vertici di inizio e fine.
void
setPattern(Pattern List<PatternItem>)
Imposta il pattern del tratto della polilinea.
void
setPoints(Elenco<LatLng> punti)
Imposta i punti di questa polilinea.
void
setSpans(Intervalli List<StyleSpan>)
Imposta le sezioni della polilinea.
void
setStartCap(Cap startCap)
Imposta il limite nel vertice iniziale di questa polilinea.
void
setTag(tag oggetto)
Imposta il tag per la polilinea.
void
setVisible(boolean visibile)
Imposta la visibilità di questa polilinea.
void
setWidth(larghezza virgola mobile)
Imposta la larghezza di questa polilinea.
void
setZIndex(zIndex in virgola mobile)
Imposta il valore zIndex di questa polilinea.

Riepilogo del metodo ereditato

Metodi pubblici

Public booleano uguale a (Object other)

Verifica se questo Polyline è uguale a un altro.

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

Public int getColor ()

Consente di acquisire il colore di questa polilinea.

Ritorni
  • il colore nel formato ARGB.

pubblico Cap getEndCap ()

Restituisce il limite al vertice finale di questa polilinea.

Ritorni
  • il tipo di creatività finale.

Stringa pubblica getId ()

Recupera l'ID di questa polilinea. L'ID sarà univoco tra tutte le polilinee su una mappa.

Ritorni
  • l'ID di questa polilinea.

Public int getJointType ()

Restituisce il tipo di giunto utilizzato in tutti i vertici della polilinea, ad eccezione dei vertici di inizio e fine. Consulta JointType per i valori possibili.

Ritorni
  • il tipo di giunto.

Public List<PatternItem> getPattern ()

Restituisce lo schema del tratto di questa polilinea.

Ritorni
  • lo schema del tratto.

Public List<LatLng> getPoints ()

Restituisce un'istantanea dei vertici di questa polilinea in questo momento . L'elenco restituito è una copia dell'elenco dei vertici. Pertanto, le modifiche ai vertici della polilinea non verranno applicate dall'elenco né alla polilinea. Per modificare i vertici della polilinea, chiama setPoints(List).

pubblico Cap getStartCap ()

Ottieni il limite nel vertice iniziale di questa polilinea.

Ritorni
  • il limite iniziale.

pubblico Oggetto getTag ()

Restituisce il tag per la polilinea.

Ritorni
  • il tag se un tag è stato impostato con setTag; null se non è stato impostato alcun tag.

numero in virgola mobile pubblico getWidth ()

Restituisce la larghezza di questa polilinea.

Ritorni
  • la larghezza in pixel dello schermo.

numero in virgola mobile getZIndex ()

Restituisce lo zIndex di questa polilinea.

Ritorni
  • l'indice z della polilinea.

pubblici int hashCode ()

pubblico booleano isClickable ()

Restituisce la cliccabilità della polilinea. Se la polilinea è cliccabile, l'app riceverà notifiche a GoogleMap.OnPolylineClickListener quando l'utente fa clic sulla polilinea. Il listener di eventi è registrato tramite setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Ritorni
  • true se la polilinea è cliccabile; in caso contrario, restituisce false.

pubblico booleano isGeodesic ()

Riconosce se ogni segmento della linea è tracciato come geodetico o meno.

Ritorni
  • true se ogni segmento è tracciato come una geodetica; false se ogni segmento è disegnato come una linea retta sulla proiezione di Mercatore.

pubblici booleano isVisible ()

Restituisce la visibilità di questa polilinea.

Ritorni
  • la visibilità di questa polilinea.

Public void remove ()

Rimuove questa polilinea dalla mappa. Dopo la rimozione di una polilinea, il comportamento di tutti i suoi metodi non è definito.

Public void setClickable (booleano cliccabile)

Imposta la cliccabilità della polilinea. Se la polilinea è cliccabile, l'app riceverà notifiche a GoogleMap.OnPolylineClickListener quando l'utente fa clic sulla polilinea. Il listener di eventi è registrato tramite setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Parametri
cliccabile Nuova impostazione di cliccabilità per la polilinea.

Public void setColor (int color)

Imposta il colore della polilinea.

Parametri
colore Il colore nel formato ARGB

Public void setEndCap (Cap endCap)

Imposta il limite al vertice finale di questa polilinea. L'immagine statica finale predefinita è ButtCap.

Parametri
endCap l'immagine statica finale. Non deve essere null.

Public void setGeodesic (boolean geodesic)

Consente di impostare se tracciare ogni segmento della linea come geodetico o meno.

Parametri
geodetico Se true, ogni segmento viene disegnato come geodetica; se false, ogni segmento viene tracciato come una linea retta sulla proiezione di Mercatore.

Public void setJointType (int jointType)

Imposta il tipo di giunto per tutti i vertici della polilinea, ad eccezione dei vertici di inizio e fine.

Consulta JointType per i valori consentiti. Verrà utilizzato il valore predefinito DEFAULT se il tipo di giunto non è definito o non è uno dei valori consentiti.

Parametri
jointType il tipo di giunto.

Public void setPattern (Pattern List<PatternItem>)

Imposta il pattern del tratto della polilinea. Il modello di tratto predefinito è continuo, rappresentato da null.

Parametri
pattern lo schema del tratto.

pubblici void setPoints (List<LatLng> punti)

Imposta i punti di questa polilinea. Questo metodo acquisirà una copia dei punti, quindi ulteriori mutazioni in points non avranno effetto su questa polilinea.

Parametri
punti un elenco di LatLng che rappresentano i vertici della polilinea.

Public void setSpans (Intervalli List<StyleSpan>)

Imposta le sezioni della polilinea.

Parametri
intervalli

Public void setStartCap (Cap startCap)

Imposta il limite nel vertice iniziale di questa polilinea. La quota limite predefinita è ButtCap.

Parametri
startCap limite iniziale. Non deve essere null.

Public void setTag (Tag oggetto)

Imposta il tag per la polilinea.

Puoi utilizzare questa proprietà per associare un valore Object arbitrario a questa polilinea. Ad esempio, Object può contenere dati relativi a ciò che rappresenta la polilinea. Questa operazione è più semplice rispetto all'archiviazione di un Map<Polyline, Object> separato. Come ulteriore esempio, puoi associare un ID String corrispondente all'ID di un set di dati. L'SDK Google Maps for Android non legge né scrive questa proprietà. È tua responsabilità chiamare setTag(null) per cancellare il tag quando non ti serve più, al fine di evitare perdite di memoria nella tua app.

Parametri
tag (m.) Se null, il tag viene cancellato.

Public void setVisible (boolean visible)

Imposta la visibilità di questa polilinea. Quando non è visibile, non viene tracciata una polilinea, ma mantiene tutte le altre proprietà.

Parametri
visibile se true, la polilinea è visibile; se false, non lo è.

Public void setWidth (larghezza virgola mobile)

Imposta la larghezza di questa polilinea.

Parametri
width la larghezza in pixel dello schermo

Public void setZIndex (zIndex in virgola mobile)

Imposta il valore zIndex di questa polilinea. Le polilinee con indici z più alti vengono disegnate sopra quelle con indici più bassi.

Parametri
zIndex lo zIndex di questa polilinea.