Keçeli Kalem

herkese açık final dersi İşaretçi
nesnesini genişletir

Harita yüzeyindeki belirli bir noktaya yerleştirilen simge. İşaretçi simgesi doğru şekilde çizilmiş ekranın yüzeyine değil, cihazın ekranına yerleştirin. Yani, bir değişiklik yapmanız gerekmez. (ör. harita döndürme, yatırma veya yakınlaştırmadan kaynaklanan) yönü.

İşaretçi aşağıdaki özelliklere sahiptir:

Alfa
İşaretçinin opaklığını ayarlar. Varsayılan olarak 1.0 değerine ayarlanır.
Bağlayıcı
Resimde, işaretçinin LatLng konumuna yerleştirilecek nokta. Bu değer, resmin solundan ve alt kısmından varsayılan olarak% 50'dir.
Konum
İşaretçinin haritadaki konumu için LatLng değeri. Bu değeri şuradan değiştirebilirsiniz: istediğiniz zaman hareket ettirin.
Başlık
Kullanıcı işaretçiye dokunduğunda bilgi penceresinde gösterilecek metin dizesi. Şunları yapabilirsiniz: bu değeri istediğiniz zaman değiştirebilirsiniz.
Snippet
Başlığın altında gösterilen ek metin. Bu değeri dilediğiniz zaman değiştirebilirsiniz.
Simge
İşaretçi için gösterilen bir bit eşlem. Simge ayarlanmadan bırakılırsa varsayılan simge görüntülenir. defaultMarker(float) kullanarak varsayılan simge için alternatif bir renk belirtebilirsiniz.
Sürükleme Durumu
Kullanıcının işaretçiyi sürüklemesine izin vermek istiyorsanız bu özelliği true olarak ayarlayın. Siz bu değeri istediğiniz zaman değiştirebilirsiniz. Varsayılan değer: false.
Görünürlük
Varsayılan olarak, işaretçi görünür durumdadır. İşaretçiyi görünmez yapmak için bu özelliği false Bu değeri dilediğiniz zaman değiştirebilirsiniz.
Düz veya İlan Tahtası
İşaretçi, harita üzerinde düz bir çizgi üzerinde duruyorsa kamera olarak haritada sabit kalır. döner ve yatar ancak GroundOverlay özelliğinin aksine kameranın yakınlaştırmasıyla aynı boyutta kalır. İşaretçi bir ilan tahtası ise her zaman kameraya doğru çizilir ve kamera ile dönecek ve eğilecek. Varsayılan, ilan tahtasıdır (false)
'nı inceleyin.
Döndürme
İşaretçinin sabitleme noktası hakkında saat yönünde derece cinsinden dönüşü. Eksen yön, işaretçiye diktir. 0 rotasyon varsayılan değere karşılık gelir işaretleyicinin konumuna bakar. İşaretçi harita üzerinde düz olduğunda, varsayılan konum Kuzey'dir ve döndürme, işaretçi harita üzerinde her zaman düz kalacak şekilde olmalıdır. İşaretçi bir ilan tahtasıdır, varsayılan konum yukarıyı gösterir ve döndürme bu şekildedir İşaretçi her zaman kameraya bakıyor. Varsayılan değer 0'dır.
zIndex
İşaretçinin çizim sırası. İşaretçiler z Endeksi sırasına göre, en yüksek Z-Endeksi işaretçisi. Her bir işaretçi için z Endeksi özelliğini ayarlayarak Kullanıcınızın ulaşma olasılığının en yüksek olduğu dokunma hedefini kontrol edin. Varsayılan değer 0'dır.
Etiket
İşaretçiyle ilişkili bir Object. Örneğin, Object işaretçinin neyi temsil ettiğiyle ilgili verileri içerir. Bu işlem, ayrı bir Map<Marker, Object> depolamaktan daha kolaydır. Başka bir örnek olarak, bir String kimliğini bir veri kümesindeki kimliğe karşılık gelir. Android için Google Haritalar SDK'sı ne okumaz ne de bu özelliği yazar.

Bu sınıftaki yöntemler, Android UI iş parçacığında çağrılmalıdır. Aksi takdirde, çalışma zamanında bir IllegalStateException döndürülür.

Örnek

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));

Geliştirici Kılavuzu

Daha fazla bilgi için İşaretçiler geliştiricisini okuyun rehberini inceleyin.

İç İçe Yerleştirilmiş Sınıf Özeti

@interface Marker.CollisionBehavior İşaretçinin başka bir işaretçiyle veya tabanla çarpışması durumunda nasıl ele alınacağını gösterir harita etiketleri kullanabilirsiniz.

Genel Yöntem Özeti

boolean
eşittir(Diğer nesnesi)
Bu Marker öğesinin başka bir değere eşit olup olmadığını test eder.
kayan noktalı
getAlpha()
İşaretçinin alfa sürümünü alır.
Dize
getId()
Bu işaretçinin kimliğini alır.
LatLng
getPosition()
İşaretçinin konumunu döndürür.
kayan noktalı
getRotation()
İşaretçinin dönüşünü alır.
Dize
getSnippet()
İşaretçinin snippet'ini alır.
Nesne
getTag()
İşaretçi için etiketi alır.
Dize
getTitle()
İşaretçinin başlığını alır.
kayan noktalı
getZIndex()
İşaretçinin z Endeksi'ni döndürür.
int
hashCode()
geçersiz
hideInfoWindow()
Bu işaretçiden gösteriliyorsa bilgi penceresini gizler.
boolean
isDraggable()
İşaretçinin sürüklenebilirliğini alır.
boolean
isFlat()
İşaretçinin düz ayarını alır.
boolean
isInfoWindowShown()
Bilgi penceresinin hâlihazırda bu işaretçinin üzerinde gösterilip gösterilmeyeceğini döndürür.
boolean
isVisible()
Bu işaretçinin görünürlük ayarını alır.
geçersiz
remove()
Bu işaretçiyi haritadan kaldırır.
geçersiz
setAlpha(kayan noktalı alfa)
İşaretçinin alfa değerini (opaklık) ayarlar.
geçersiz
setAnchor(float anchorU, kayan anchorV)
İşaretçi için sabitleme noktasını ayarlar.
geçersiz
setDraggable(boolean draggable)
İşaretçinin sürüklenebilirliğini ayarlar.
geçersiz
setFlat(boole sabit)
Bu işaretçinin, true haritasına mı yoksa kamera false.
geçersiz
setIcon(BitmapDescriptor simgesi Açıklayıcı)
İşaretçinin simgesini ayarlar.
geçersiz
setInfoWindowAnchor(float anchorU, kayan anchorV)
İşaretçi resminde, konumlandığında bilgi penceresinin sabitleneceği noktayı belirtir. görüntülenir.
geçersiz
setPosition(LatLng EnlBoy)
İşaretçinin konumunu ayarlar.
geçersiz
setRotation(kayan rotasyon)
İşaretçinin sabitleme noktası hakkında saat yönünde derece cinsinden dönüşü ayarlar.
geçersiz
setSnippet(Dize snippet'i)
İşaretçinin snippet'ini ayarlar.
geçersiz
setTag(Nesne etiketi)
İşaretçi için etiketi ayarlar.
geçersiz
setTitle(Dize başlığı)
İşaretçinin başlığını ayarlar.
geçersiz
setVisible(boolean visible)
Bu işaretçinin görünürlüğünü ayarlar.
geçersiz
setZIndex(float zIndex)
İşaretçinin z Endeksi'ni ayarlar.
geçersiz
showInfoWindow()
Bu işaretçi isVisible() ise, haritada bu işaretçinin bilgi penceresini gösterir.

Devralınan Yöntem Özeti

Herkese Açık Yöntemler

herkese açık Boole 'nı inceleyin. eşittir (Diğer nesne)

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

Parametreler
diğer Object.
İadeler
  • Her iki nesne de aynı nesneyse true (doğru) değerini alır, yani bu == diğerini ifade eder.

herkese açık kayan 'nı inceleyin. getAlpha ()

İşaretçinin alfa sürümünü alır.

İadeler
  • [0, 1] aralığındaki işaretçinin alfasına

herkese açık İp 'nı inceleyin. getId ()

Bu işaretçinin kimliğini alır. Kimlik, bir haritadaki tüm İşaretçiler arasında benzersiz olacaktır.

İadeler
  • bu işaretçinin kimliğini girin.

herkese açık LatLng getPosition ()

İşaretçinin konumunu döndürür.

İadeler
  • İşaretçinin mevcut konumunu belirten LatLng nesnesi.

herkese açık kayan 'nı inceleyin. getRotation ()

İşaretçinin dönüşünü alır.

İadeler
  • saat yönünde, varsayılan konumdan derece dönüşü.

herkese açık İp 'nı inceleyin. getSnippet ()

İşaretçinin snippet'ini alır.

İadeler
  • İşaretçinin snippet'ini içeren bir dize.

herkese açık Nesne 'nı inceleyin. getTag ()

İşaretçi için etiketi alır.

İadeler
  • setTag ile ayarlanmışsa etiketi; Etiket ayarlanmamışsa null.

herkese açık İp 'nı inceleyin. getTitle ()

İşaretçinin başlığını alır.

İadeler
  • İşaretçinin başlığını içeren bir dize.

herkese açık kayan 'nı inceleyin. getZIndex ()

İşaretçinin z Endeksi'ni döndürür.

İadeler
  • bu işaretçinin z Endeksi'ne bakalım.

herkese açık tamsayı 'nı inceleyin. hashCode ()

herkese açık geçersiz 'nı inceleyin. hideInfoWindow ()

Bu işaretçiden gösteriliyorsa bilgi penceresini gizler.

Bu işaretçi görünür değilse bu yöntemin hiçbir etkisi yoktur.

herkese açık Boole 'nı inceleyin. isDraggable ()

İşaretçinin sürüklenebilirliğini alır. Sürüklenebilir olan işaretçiler kullanıcı tarafından sürüklenebilir. daha uzun süre basılı tutun.

İadeler
  • İşaretçi sürüklenebiliyorsa true; aksi takdirde false değerini döndürür.

herkese açık Boole 'nı inceleyin. isFlat ()

İşaretçinin düz ayarını alır.

İadeler
  • İşaretçi haritada düzse true; false yüz yüze görüşün.

herkese açık Boole 'nı inceleyin. isInfoWindowShown ()

Bilgi penceresinin hâlihazırda bu işaretçinin üzerinde gösterilip gösterilmeyeceğini döndürür. Burada dikkate alınmaz bilgi penceresinin ekranda gerçekten görünür olup olmadığı.

herkese açık Boole 'nı inceleyin. isVisible ()

Bu işaretçinin görünürlük ayarını alır. Bunun işaretçinin ekranın görüntü alanı içinde olduğundan emin olun. Bu, işaretçinin yer alır.

İadeler
  • görünürlük.

herkese açık geçersiz 'nı inceleyin. kaldır ()

Bu işaretçiyi haritadan kaldırır. Bir işaretçi kaldırıldıktan sonra, işaretçisinin tüm işlevlerinin yöntem tanımlanmadı.

herkese açık geçersiz 'nı inceleyin. setAlpha (kayan alfa)

İşaretçinin alfa değerini (opaklık) ayarlar. Bu, 0 ile 1 arasındaki bir değerdir; burada 0, işaretçi anlamına gelir tamamen şeffaftır ve 1, işaretçinin tamamen opak olduğu anlamına gelir.

Parametreler
alfa

herkese açık geçersiz 'nı inceleyin. setAnchor (float anchorU, kayan sabit V)

İşaretçi için sabitleme noktasını ayarlar.

Sabitleme, simge resminde işaretçinin konumuna sabitlenen noktayı belirtir bir sürü resim var.

Sabitleme noktası [0,0, 1,0] x [0,0, 1,0] sürekli alanında belirtilir; burada (0, 0) resmin sol üst köşesi ve (1, 1) sağ alt köşesidir. Sabitleme noktası G x Y boyutunda, (G + 1) x aralığındaki en yakın tekerlekli ızgara noktasıdır (H + 1) ızgarası; ardından yuvarlama ölçeklendirilerek elde edilir. Örneğin, 4x2 boyutlu bir resimde sabitleme noktası (0,7, 0,6) (3, 1) konumundaki ızgara noktasına çözümlenir. 

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*
.

Parametreler
anchorU resim genişliğine oranı olarak sabit öğenin u koordinatı ([0, 1] aralığında).
anchorV resim yüksekliğinin oranı olarak çapanın v koordinatı ([0, 1]).

herkese açık geçersiz 'nı inceleyin. setDraggable (boole sürüklenebilir)

İşaretçinin sürüklenebilirliğini ayarlar. Sürüklenebilir olan işaretçiler kullanıcı tarafından sürüklenebilir. daha uzun süre basılı tutun.

Parametreler
sürüklenebilir

herkese açık geçersiz 'nı inceleyin. setFlat (boole sabit)

Bu işaretçinin, true haritasına mı yoksa kamera false.

Parametreler
düz

herkese açık geçersiz 'nı inceleyin. setIcon (BitmapDescriptor simgesi Açıklayıcı)

İşaretçinin simgesini ayarlar.

Parametreler
iconDescriptor null ise varsayılan işaretçi kullanılır.

herkese açık geçersiz 'nı inceleyin. setInfoWindowAnchor (float anchorU, kayan sabit V)

İşaretçi resminde, konumdayken bilgi penceresinin sabitleneceği noktayı belirtir. görüntülenir. Bu, çapayla aynı koordinat sisteminde belirtilir. Ayrıntılı bilgi için setAnchor(float, float) sayfasını inceleyin. Varsayılan değer, resmin üst orta kısmıdır.

Parametreler
anchorU resim genişliğinin oranı olarak bilgi penceresi bağlantısının u koordinatı ( [0, 1] aralığı) içerir.
anchorV resim yüksekliğinin oranı olarak bilgi penceresi bağlantısının v koordinatı ( [0, 1] aralığı) içerir.

herkese açık geçersiz 'nı inceleyin. setPosition (LatLng EnlBoy)

İşaretçinin konumunu ayarlar.

Parametreler
Enlgt

herkese açık geçersiz 'nı inceleyin. setRotation (kayan dönüş)

İşaretçinin sabitleme noktası hakkında saat yönünde derece cinsinden dönüşü ayarlar. Eksen yön, işaretçiye diktir. 0 dönüşü varsayılan konuma karşılık gelir tıklayın.

Parametreler
rotasyon

herkese açık geçersiz 'nı inceleyin. setSnippet (Dize snippet'i)

İşaretçinin snippet'ini ayarlar.

Parametreler
snippet null ise snippet temizlenir.

herkese açık geçersiz 'nı inceleyin. setTag (Nesne etiketi)

İşaretçi için etiketi ayarlar.

Bu özelliği, rastgele bir Object öğesini bu işaretçiyle ilişkilendirmek için kullanabilirsiniz. Örneğin, Örneğin, Object, işaretçinin neyi temsil ettiğiyle ilgili veriler içerebilir. Bu daha kolay ayrı bir Map<Marker, Object> Başka bir örnek olarak, String kimliği, veri kümesindeki kimliğe karşılık gelir. Android için Google Haritalar SDK'sı ikisi de bu özelliği okur veya yazar. Hesapla ilgili gerekli düzenlemeleri yapmak için setTag(null) şirketini aramak sizin sorumluluğunuzdadır artık ihtiyaç duymadığınızda etiketi otomatik olarak kullanabilirsiniz.

Parametreler
etiket null ise etiket temizlenir.

herkese açık geçersiz 'nı inceleyin. setTitle (Dize başlığı)

İşaretçinin başlığını ayarlar.

Parametreler
title null ise başlık temizlenir.

herkese açık geçersiz 'nı inceleyin. setVisible (boole görünür)

Bu işaretçinin görünürlüğünü ayarlar. false olarak ayarlanırsa ve şu anda bir bilgi penceresi gösterildiğinde, bilgi penceresi gizlenir.

Parametreler
görünür

herkese açık geçersiz 'nı inceleyin. setZIndex (kayan Z-Endeksi)

İşaretçinin z Endeksi'ni ayarlar.

Parametreler
zIndex

herkese açık geçersiz 'nı inceleyin. showInfoWindow ()

Bu işaretçi isVisible() ise, haritada bu işaretçinin bilgi penceresini gösterir.

Fırlatma
IllegalArgumentException marker bu haritada yoksa