Çoklu çizgi

herkese açık final sınıfı Polyline Nesneyi genişletir

Ç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) ve CustomCap (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 tekrarlanacak PatternItem nesne dizisi. Kullanılabilir PatternItem 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) ve Dot (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 ve Polygon dahil ancak Marker 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 özellik true olarak ayarlanırsa uygulamanız, setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) üzerinden kaydedilen GoogleMap.OnPolylineClickListener için bildirim alır.
Etiket
Çoklu çizgiyle ilişkili bir Object. Ö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.
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
eşittir(Diğer nesne)
Bu Polyline öğesinin başka bir değere eşit olup olmadığını test eder.
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
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
setEndCap(Cap endCap)
Bu çoklu çizginin son tepe tepesindeki sınırı ayarlar.
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
setPattern(List<PatternItem> desen)
Çoklu çizginin çizgi desenini ayarlar.
void
setPoints(Liste<LatLng> puanı)
Bu çoklu çizginin noktalarını ayarlar.
void
setSpans(Liste<StyleSpan> aralık)
Çoklu çizginin aralıklarını ayarlar.
void
setStartCap(Cap startCap)
Bu çoklu çizginin başlangıç tepe noktasındaki sınırı ayarlar.
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)

Bu Polyline öğesinin başka bir değere eşit olup olmadığını test eder.

Parametreler
diğer bir Object.
İlerlemeler
  • Her iki nesne de aynı nesneyse doğru değerini döndürür, yani bu == 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.

genel Cap getStartCap ()

Bu çoklu çizginin başlangıç tepesindeki sınırı alır.

İlerlemeler
  • belirler.

herkese açık Nesne getTag ()

Çoklu çizginin etiketini alır.

İlerlemeler
  • bir etiket setTag ile ayarlandıysa etiket; hiçbir etiket ayarlanmamışsa null.

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 takdirde false 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şse false.

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)

Başlangıç ve bitiş köşeleri hariç, çoklu çizginin tüm köşeleri için bağlantı türünü ayarlar.

İzin verilen değerler için JointType politikasına bakın. Ortak türü tanımlanmamışsa veya izin verilen değerlerden biri değilse DEFAULT varsayılan değeri kullanılır.

Parametreler
jointType eklem.

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.