Çoklu çizgi, noktaların ardışık noktalar arasında çizildiği noktalardan oluşan bir listedir. Çoklu çizginin özellikleri şu şekildedir:
- Puan
- Çizginin köşeleri. Çizgi segmentleri, ardışık noktalar arasında çizilir. Bir çoklu çizgi varsayılan olarak kapatılmaz; kapalı bir çoklu çizgi oluşturmak için başlangıç ve bitiş noktaları aynı olmalıdır.
- Genişlik
- Ekran pikseli cinsinden çizgi segmenti genişliği. Genişlik sabittir ve kameranın yakınlaştırma düzeyinden bağımsızdır. Varsayılan değer 10'dur.
- Renk
- ARGB biçiminde çizgi segmenti rengi (
Color
tarafından kullanılan biçim). Varsayılan değer siyahtır (0xff000000
). - Başlangıç/bitiş sınırı
- Bir çoklu çizginin başında veya sonunda kullanılacak şekli tanımlar. Desteklenen başlık türleri:
ButtCap
,SquareCap
,RoundCap
(düz çizgi deseni için geçerlidir) veCustomCap
(tüm çizgi desenleri için geçerlidir). Hem başlangıç hem de bitiş için varsayılan değer:ButtCap
. - Eklem türü
- Birleştirme türü, başlangıç ve bitiş köşeleri hariç çoklu çizginin tüm köşelerinde bitişik çizgi segmentleri birleştirilirken kullanılacak şekli tanımlar. Desteklenen bağlantı türleri için
JointType
adresini inceleyin. Varsayılan değer:DEFAULT
. - Çizgi deseni
- Düz (varsayılan,
null
ile temsil edilir) veya çizgi boyunca tekrarlanacakPatternItem
nesne dizisi. KullanılabilirPatternItem
türleri:Gap
(piksel cinsinden boşluk uzunluğuyla tanımlanır),Dash
(çizgi genişliği ve piksel cinsinden tire uzunluğuyla tanımlanır) veDot
(dairesel, çizgiye ortalanmış, çapı piksel cinsinden çizgi genişliğiyle tanımlanır). - Z-Endeksi
- Bu karo yer paylaşımının diğer yer paylaşımlarına göre çizilme sırası (
GroundOverlay
,TileOverlay
,Circle
vePolygon
dahil ancakMarker
değil). Daha büyük Z-endeksine sahip bir bindirme, daha küçük z endekslerine sahip bindirmelerin üzerinde çizilir. Aynı Z-endeksine sahip yer paylaşımlarının sıralaması rastgeledir. Varsayılan zEndeksi 0'dır. - Görünürlük
- Çoklu çizginin görünür olup olmadığını (harita üzerinde çizilip çizilmediğini) belirtir. Görünmez çoklu çizgi çizilmez ancak diğer tüm özellikleri korunur. Varsayılan değer,
true
(yani görünür) değeridir. - Jeodezik durum
- Çoklu çizginin segmentlerinin, Merkatör projeksiyonunda düz çizgiler yerine jeodezik olarak çizilip çizilmeyeceğini belirtir. Jeodezik, Dünya yüzeyindeki iki nokta arasındaki en kısa yoldur. Jeodezik eğri, Dünya'nın küre olduğu varsayılarak oluşturulur
- Tıklanabilirlik
- Kullanıcı çoklu çizgiyi tıkladığında tetiklenen etkinlikleri işlemek istiyorsanız bu özelliği
true
olarak ayarlayın. Bu değeri istediğiniz zaman değiştirebilirsiniz. Varsayılan değer:false
. Bu özelliktrue
olarak ayarlanırsa uygulamanız,setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
üzerinden kaydedilenGoogleMap.OnPolylineClickListener
için bildirim alır. - Etiket
- Çoklu çizgiyle ilişkili bir
Object
. ÖrneğinObject
, çoklu çizginin neyi temsil ettiğine dair veriler içerebilir. Bu, ayrı birMap<Polyline, Object>
depolamaktan daha kolaydır. Başka bir örnek olarak, veri kümesindeki kimliğe karşılık gelen birString
kimliğini ilişkilendirebilirsiniz. Android için Google Haritalar SDK'sı bu özelliği okumaz veya yazmaz. - Aralıklar
- Bu çoklu çizgiyi oluşturmak için kullanılan farklı stillere sahip aralıkları tanımlar. Çoklu çizginin farklı segmentlerinde farklı
StrokeStyle
değerine sahip bir çoklu çizgi oluşturmak için bu özelliği kullanabilirsiniz.
Bu sınıftaki yöntemler Android kullanıcı arayüzü iş parçacığında çağrılmalıdır. Aksi takdirde, çalışma zamanında bir IllegalStateException
atılır.
Örnek
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));
Geliştirici Kılavuzu
Daha fazla bilgi için Şekiller geliştirici kılavuzunu okuyun.
Herkese Açık Yöntem Özeti
boolean | |
int |
getColor()
Bu çoklu çizginin rengini alır.
|
Sınır |
getEndCap()
Bu çoklu çizginin son tepe tepesindeki sınırı alır.
|
Dize |
getId()
Bu çoklu çizginin kimliğini alır.
|
int |
getJointType()
Başlangıç ve bitiş köşeleri hariç çoklu çizginin tüm köşelerinde kullanılan birleştirme türünü alır.
|
List<PatternItem> |
getPattern()
Bu çoklu çizginin çizgi desenini alır.
|
List<LatLng> |
getPoints()
Bu çoklu çizginin şu anki köşelerinin anlık görüntüsünü döndürür .
|
Sınır |
getStartCap()
Bu çoklu çizginin başlangıç tepesindeki sınırı alır.
|
Nesne |
getTag()
Çoklu çizginin etiketini alır.
|
float |
getWidth()
Bu çoklu çizginin genişliğini alır.
|
float |
getZIndex()
Bu çoklu çizginin z-endeksini alır.
|
int |
hashCode()
|
boolean |
isClickable()
Çoklu çizginin tıklanabilirliğini sağlar.
|
boolean |
isGeodesic()
Çizginin her bir parçasının jeodezik olarak çizilip çizilmediğini alır.
|
boolean |
isVisible()
Bu çoklu çizginin görünürlüğünü sağlar.
|
void |
remove()
Bu çoklu çizgiyi haritadan kaldırır.
|
void |
setClickable(tıklanabilir boole)
Çoklu çizginin tıklanabilirliğini ayarlar.
|
void |
setColor(int rengi)
Bu çoklu çizginin rengini ayarlar.
|
void | |
void |
setGeodesic(boole jeodezik)
Çizginin her bir parçasının jeodezik olarak çizilip çizilmeyeceğini belirler.
|
void |
setJointType(intjointType)
Başlangıç ve bitiş köşeleri hariç, çoklu çizginin tüm köşeleri için bağlantı türünü ayarlar.
|
void | |
void | |
void | |
void | |
void |
setTag(Nesne etiketi)
Çoklu çizginin etiketini ayarlar.
|
void |
setVisible(boole görülebilir)
Bu çoklu çizginin görünürlüğünü ayarlar.
|
void |
setWidth(kayan genişlik)
Bu çoklu çizginin genişliğini ayarlar.
|
void |
setZIndex(kayan zIndex)
Bu çoklu çizginin z Endeksi'ni ayarlar.
|
Devralınan Yöntem Özeti
Herkese Açık Yöntemler
genel boole eşittir (Nesne diğer)
genel int getColor ()
Bu çoklu çizginin rengini alır.
İlerlemeler
- rengi ARGB biçiminde girin.
genel Cap getEndCap ()
Bu çoklu çizginin son tepe tepesindeki sınırı alır.
İlerlemeler
- başlık türünü seçin.
herkese açık Dize getId ()
Bu çoklu çizginin kimliğini alır. Kimlik, bir haritadaki tüm Çoklu Çizgiler arasında benzersiz olacaktır.
İlerlemeler
- bu çoklu çizginin kimliğini belirtin.
genel int getJointType ()
Başlangıç ve bitiş köşeleri hariç çoklu çizginin tüm köşelerinde kullanılan birleştirme türünü alır. Olası değerler için JointType
sayfasını inceleyin.
İlerlemeler
- eklem.
genel Liste<PatternItem> getPattern ()
Bu çoklu çizginin çizgi desenini alır.
İlerlemeler
- çizgisidir.
genel Liste<LatLng> getPoints ()
Bu çoklu çizginin şu anki köşelerinin anlık görüntüsünü döndürür . Döndürülen liste, köşeler listesinin bir kopyasıdır. Dolayısıyla çoklu çizginin köşelerinde yapılan değişiklikler bu liste tarafından yansıtılmaz ve bu listede yapılan değişiklikler çoklu çizgi tarafından da yansıtılmaz. Çoklu çizginin köşelerini değiştirmek için setPoints(List)
çağrısı yapın.
herkese açık Nesne getTag ()
Çoklu çizginin etiketini alır.
İlerlemeler
- bir etiket
setTag
ile ayarlandıysa etiket; hiçbir etiket ayarlanmamışsanull
.
herkese açık float getWidth ()
Bu çoklu çizginin genişliğini alır.
İlerlemeler
- ekran pikseli cinsinden genişliği
herkese açık float getZIndex ()
Bu çoklu çizginin z-endeksini alır.
İlerlemeler
- Çoklu çizginin z-endeksi.
genel int hashCode ()
herkese açık boole isClickable ()
Çoklu çizginin tıklanabilirliğini sağlar. Çoklu çizgi tıklanabilirse kullanıcı çoklu çizgiyi tıkladığında uygulamanız GoogleMap.OnPolylineClickListener
için bildirim alır. Etkinlik işleyici setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
aracılığıyla kaydedildi.
İlerlemeler
- Çoklu çizgi tıklanabilirse
true
; aksi takdirdefalse
değerini döndürür.
herkese açık boole isGeodesic ()
Çizginin her bir parçasının jeodezik olarak çizilip çizilmediğini alır.
İlerlemeler
- her bir segment jeodezik olarak çizilmişse
true
; her bir segment Merkatör projeksiyonu üzerinde düz bir çizgi olarak çizilmişsefalse
.
herkese açık boole isVisible ()
Bu çoklu çizginin görünürlüğünü sağlar.
İlerlemeler
- görünmesini engelleyebilirsiniz.
herkese açık void kaldır ()
Bu çoklu çizgiyi haritadan kaldırır. Bir çoklu çizgi kaldırıldıktan sonra tüm yöntemlerinin davranışı tanımlanmaz.
herkese açık void setClickable (boole tıklanabilir)
Çoklu çizginin tıklanabilirliğini ayarlar. Çoklu çizgi tıklanabilirse kullanıcı çoklu çizgiyi tıkladığında uygulamanız GoogleMap.OnPolylineClickListener
için bildirim alır. Etkinlik işleyici setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
aracılığıyla kaydedildi.
Parametreler
tıklanabilir | Çoklu çizgi için yeni tıklanabilirlik ayarı. |
---|
herkese açık geçersiz setColor (int color)
Bu çoklu çizginin rengini ayarlar.
Parametreler
renk | ARGB biçiminde renk |
---|
herkese açık void setEndCap (Cap endCap)
Bu çoklu çizginin son tepe tepesindeki sınırı ayarlar. Varsayılan bitiş sınırı: ButtCap
.
Parametreler
endCap | bitiş sınırı. null olmamalıdır.
|
---|
herkese açık geçersiz setGeodesic (boolean geodesic)
Çizginin her bir parçasının jeodezik olarak çizilip çizilmeyeceğini belirler.
Parametreler
jeodezik | true ise her segment jeodezik olarak çizilir. false ise, her bir segment Merkatör projeksiyonu üzerinde düz bir çizgi olarak çizilir.
|
---|
herkese açık void setJointType (intjointType)
herkese açık void setPattern (List<PatternItem> desen)
Çoklu çizginin çizgi desenini ayarlar. Varsayılan çizgi deseni düz ve null
ile temsil ediliyor.
Parametreler
desen | çizgisidir. |
---|
herkese açık void setPoints (List<LatLng> puan)
Bu çoklu çizginin noktalarını ayarlar. Bu yöntemde noktaların kopyası alınır. Bu nedenle, points
üzerinde yapılacak başka mutasyonların bu çoklu çizgi üzerinde bir etkisi olmaz.
Parametreler
puan | çoklu çizginin köşeleri olan LatLng noktalarının listesi.
|
---|
herkese açık void setSpans (List<StyleSpan> spans)
Çoklu çizginin aralıklarını ayarlar.
Parametreler
aralık |
---|
herkese açık void setStartCap (Cap startCap)
Bu çoklu çizginin başlangıç tepe noktasındaki sınırı ayarlar. Varsayılan başlangıç sınırı: ButtCap
.
Parametreler
startCap | başlangıç sınırı. null olmamalıdır.
|
---|
herkese açık void setTag (Nesne etiketi)
Çoklu çizginin etiketini ayarlar.
Rastgele bir Object
öğesini bu çoklu çizgiyle ilişkilendirmek için bu özelliği kullanabilirsiniz. Örneğin Object
, çoklu çizginin neyi temsil ettiğine dair veriler içerebilir. Bu, ayrı bir Map<Polyline, Object>
depolamaktan daha kolaydır. Başka bir örnek olarak, veri kümesindeki kimliğe karşılık gelen bir String
kimliğini ilişkilendirebilirsiniz. Android için Google Haritalar SDK'sı bu özelliği okumaz veya yazmaz. Uygulamanızdaki bellek sızıntılarını önlemek üzere artık ihtiyacınız kalmadığında etiketi temizlemek için setTag(null)
öğesini çağırmak sizin sorumluluğunuzdadır.
Parametreler
etiket | null ise etiket temizlenir. |
---|
herkese açık void setVisible (boolean visible)
Bu çoklu çizginin görünürlüğünü ayarlar. Çoklu çizgi, görünür olmadığında çizilmez ancak diğer tüm özelliklerini korur.
Parametreler
görünür | true ise çoklu çizgi görünür, false ise görünmez.
|
---|
herkese açık void setWidth (kayan genişlik)
Bu çoklu çizginin genişliğini ayarlar.
Parametreler
genişlik | ekran pikseli cinsinden genişlik |
---|
herkese açık void setZIndex (float zIndex)
Bu çoklu çizginin z Endeksi'ni ayarlar. Yüksek zendeksi olan çoklu çizgiler, daha düşük dizinleri olanların üzerine çizilir.
Parametreler
zIndex | bu çoklu çizginin z-endeksi. |
---|