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) eCustomCap
(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 diPatternItem
oggetti da ripetere lungo la linea. Tipi diPatternItem
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) eDot
(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
ePolygon
ma nonMarker
). 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 sutrue
, la tua app riceverà notifiche alGoogleMap.OnPolylineClickListener
registrato tramitesetOnPolylineClickListener(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 unMap<Polyline, Object>
separato. Come ulteriore esempio, puoi associare un IDString
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 | |
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 |
hashCode()
|
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 | |
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 | |
void | |
void | |
void | |
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)
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, restituiscefalse
.
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. |
---|