Keçeli Kalem

herkese açık son sınıf Marker Nesneyi genişletir

Harita yüzeyindeki belirli bir noktaya yerleştirilmiş bir simge. Bir işaretçi simgesi, haritanın yüzeyi yerine cihazın ekranına bakacak şekilde çizilir. Yani, harita döndürme, yatırma veya yakınlaştırma nedeniyle yönü değişmeyebilir.

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

Alfa
İşaretçinin opaklığını ayarlar. Varsayılan olarak 1,0 değerine ayarlanır.
Çapa
Resimde, işaretçinin LatLng konumuna yerleştirilecek nokta. Bu değer, varsayılan olarak resmin solundan ve alt kısmından% 50 oranındadır.
Konum
İşaretçinin haritadaki konumunun LatLng değeri. İşaretçiyi taşımak isterseniz bu değeri istediğiniz zaman değiştirebilirsiniz.
Başlık
Kullanıcı, işaretçiye dokunduğunda bir bilgi penceresinde gösterilen metin dizesi. Bu değeri istediğiniz zaman değiştirebilirsiniz.
Snippet
Başlığın altında görüntülenen ek metin. Bu değeri istediğiniz zaman değiştirebilirsiniz.
Simge
İşaretçi için gösterilen bir bit eşlem. Simge ayarlanmadan bırakılırsa varsayılan bir simge gösterilir. 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. Bu değeri istediğiniz zaman değiştirebilirsiniz. Varsayılan değer: false.
Görünürlük
İşaretçi varsayılan olarak görünürdür. İşaretçiyi görünmez yapmak için bu özelliği false olarak ayarlayın. Bu değeri istediğiniz zaman değiştirebilirsiniz.
Düz veya İlan Tahtası
İşaretçi haritaya göre düz bir şekilde duruyorsa, kamera döndürüldüğünde ve yatırıldığında haritaya takılı kalır, ancak GroundOverlay'dan farklı olarak kameranın zum yapmasıyla aynı boyutta kalır. İşaretçi bir ilan tahtası ise her zaman kameraya doğru çizilir ve kamerayla birlikte döndürülüp eğilir. Varsayılan olarak bir ilan tahtası (false)
Döndürme
İşaretçinin sabitleme noktası hakkında saat yönünde derece cinsinden döndürülmesi. Dönme ekseni işaretçiye diktir. 0 döndürme, işaretçinin varsayılan konumuna karşılık gelir. İşaretçi haritada düz olduğunda, varsayılan konum Kuzeye hizalı olur ve dönme işaretçi harita üzerinde her zaman düz kalacak şekilde yapılır. İşaretçi ilan tahtası olduğunda, varsayılan konum yukarıyı gösterir ve döndürme, işaretçi her zaman kameraya bakacak şekilde olur. Varsayılan değer 0'dır.
zIndex
İşaretçinin çizim sırası. İşaretçiler, en yüksek zIndex işaretçisi en üste çizilecek şekilde, z Endeksine göre çizilir. Her işaretçi için zIndex özelliğini ayarlayarak kullanıcınızın en çok hangi dokunma hedefine ulaşabileceğini kontrol edebilirsiniz. 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 veriler içerebilir. Bu, ayrı bir Map<Marker, 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.

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 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ştirici kılavuzunu okuyun.

İç İçe geçmiş Sınıf Özeti

@arayüzü Marker.CollisionBehavior Diğer işaretçiler veya temel harita etiketleriyle çakışma meydana geldiğinde işaretçinin nasıl ele alınacağını gösterir. 

Herkese Açık Yöntem Özeti

boolean
eşittir(Diğer nesne)
Bu Marker öğesinin başka bir değere eşit olup olmadığını test eder.
float
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.
float
getRotation()
İşaretçinin dönüşünü sağlar.
Dize
getSnippet()
İşaretçinin snippet'ini alır.
Nesne
getTag()
İşaretçinin etiketini alır.
Dize
getTitle()
İşaretçinin başlığını alır.
float
getZIndex()
İşaretçinin zEndeksi değerini döndürür.
int
hashCode()
void
hideInfoWindow()
Bu işaretçiden gösteriliyorsa bilgi penceresini gizler.
boolean
isDraggable()
İşaretçinin sürüklenebilirliğini sağlar.
boolean
isFlat()
İşaretçinin sabit ayarını alır.
boolean
isInfoWindowShown()
Bilgi penceresinin şu anda bu işaretçinin üzerinde gösterilip gösterilmediğini döndürür.
boolean
isVisible()
Bu işaretçinin görünürlük ayarını alır.
void
remove()
Bu işaretçiyi haritadan kaldırır.
void
setAlpha(kayan alfa)
İşaretçinin alfasını (opaklığını) ayarlar.
void
setAnchor(kayan bağlantıU, kayan bağlayıcıV)
İşaretçinin sabitleme noktasını ayarlar.
void
setDraggable(boole sürüklenebilir)
İşaretçinin sürüklenebilirliğini ayarlar.
void
setFlat(boole düz)
Bu işaretçinin true haritasına göre mi yoksa false adlı kameraya bakan bir ilan tahtasına mı karşı düz durması gerektiğini ayarlar.
void
setIcon(BitmapDescriptor simgesi Açıklayıcı)
İşaretçinin simgesini ayarlar.
void
setInfoWindowAnchor(kayan bağlantıU, kayan bağlayıcıV)
İşaretçi resminde, gösterildiğinde bilgi penceresinin sabitleneceği noktayı belirtir.
void
setPosition(LatLng latlng)
İşaretçinin konumunu ayarlar.
void
setRotation(kayan rotasyonu)
İşaretçinin dönüşünü, sabitleme noktası hakkında saat yönünde derece cinsinden ayarlar.
void
setSnippet(Dize snippet'i)
İşaretçinin snippet'ini ayarlar.
void
setTag(Nesne etiketi)
İşaretçinin etiketini ayarlar.
void
setTitle(Dize başlığı)
İşaretçinin başlığını ayarlar.
void
setVisible(boole görülebilir)
Bu işaretçinin görünürlüğünü ayarlar.
void
setZIndex(kayan zIndex)
İşaretçinin zEndeksi'ni ayarlar.
void
showInfoWindow()
Bu işaretçi isVisible() ise, harita üzerinde bu işaretçinin bilgi penceresini gösterir.

Devralınan Yöntem Özeti

Herkese Açık Yöntemler

genel boole eşittir (Nesne diğer)

Bu Marker öğ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.

herkese açık float getAlpha ()

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

İlerlemeler
  • işaretleyicinin alfa harfini gösterir.

herkese açık Dize getId ()

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

İlerlemeler
  • bu işaretçinin kimliğini açıkla.

herkese açık LatLng getPosition ()

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

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

herkese açık float getRotation ()

İşaretçinin dönüşünü sağlar.

İlerlemeler
  • işaretçinin varsayılan konumdan saat yönünde derece cinsinden döndürülmesini sağlar.

herkese açık Dize getSnippet ()

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

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

herkese açık Nesne getTag ()

İşaretçinin etiketini alır.

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

herkese açık Dize getTitle ()

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

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

herkese açık float getZIndex ()

İşaretçinin zEndeksi değerini döndürür.

İlerlemeler
  • bu işaretçinin z Endeksi.

genel int hashCode ()

herkese açık void hideInfoWindow ()

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

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

herkese açık boole isDraggable ()

İşaretçinin sürüklenebilirliğini sağlar. Bir işaretçi sürüklenebilir olduğunda, kullanıcı tarafından işaretçiye uzun basılarak hareket ettirilebilir.

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

herkese açık boole isFlat ()

İşaretçinin sabit ayarını alır.

İlerlemeler
  • true. İşaretçi haritaya bakacak şekilde düzse false.

herkese açık boole isInfoWindowShown ()

Bilgi penceresinin şu anda bu işaretçinin üzerinde gösterilip gösterilmediğini döndürür. Bu, bilgi penceresinin gerçekten ekranda görünüp görünmediğini dikkate almaz.

herkese açık boole 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 olup olmadığını göstermediğini unutmayın. İşaretçinin, ekranın görüntü alanında yer alıyorsa çizilip çizilmeyeceğini belirtir.

İlerlemeler
  • görünür.

herkese açık void kaldır ()

Bu işaretçiyi haritadan kaldırır. Bir işaretçi kaldırıldıktan sonra tüm yöntemlerinin davranışı tanımsız hale gelir.

herkese açık void setAlpha (kayan alfa)

İşaretçinin alfasını (opaklığını) ayarlar. Bu, 0 ile 1 arasında bir değerdir. 0 değeri işaretçinin tamamen şeffaf, 1 değeri ise tamamen opak anlamına gelir.

Parametreler
alfa

herkese açık void setAnchor (float anchorU, float anchorV)

İşaretçinin sabitleme noktasını ayarlar.

Sabitleme, simge resminde işaretçinin Dünya yüzeyindeki konumuna sabitlenmiş olan noktayı belirtir.

Sabitleme noktası, (0, 0) resmin sol üst köşesi ve (1, 1) sağ alt köşe olmak üzere [0,0, 1,0] x [0,0, 1,0] şeklinde belirtilen sürekli alanda belirtilir. G x Y resmindeki sabitleme noktası, (G + 1) x (Y + 1) ızgaradaki en yakın ayrık ızgara noktasıdır. Ardından yuvarlamanın ölçeklendirilmesiyle elde edilir. Örneğin, 4 x 2 boyutundaki 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ğinin oranı olarak, çapanın u koordinatı ([0, 1] aralığında).
anchorV Resim yüksekliğinin oranı olarak, çapanın v koordinatı ([0, 1] aralığında).

herkese açık void setDraggable (boolean draggable)

İşaretçinin sürüklenebilirliğini ayarlar. Bir işaretçi sürüklenebilir olduğunda, kullanıcı tarafından işaretçiye uzun basılarak hareket ettirilebilir.

Parametreler
sürüklenebilir

herkese açık void setFlat (boole düz)

Bu işaretçinin true haritasına göre mi yoksa false adlı kameraya bakan bir ilan tahtasına mı karşı düz durması gerektiğini ayarlar.

Parametreler
düz

herkese açık void 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 void setInfoWindowAnchor (float anchorU, float anchorV)

İşaretçi resminde, gösterildiğinde bilgi penceresinin sabitleneceği noktayı belirtir. Bu değer, çapa ile aynı koordinat sisteminde belirtilir. Ayrıntılı bilgi için setAnchor(float, float) belgesine göz atın. Varsayılan değer, resmin üst orta kısmıdır.

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

herkese açık void setPosition (LatLng latlng)

İşaretçinin konumunu ayarlar.

Parametreler
enlng

herkese açık geçersiz setRotation (kayan Rotasyon)

İşaretçinin dönüşünü, sabitleme noktası hakkında saat yönünde derece cinsinden ayarlar. Dönme ekseni işaretçiye diktir. 0 döndürme, işaretçinin varsayılan konumuna karşılık gelir.

Parametreler
döndürme

herkese açık void setSnippet (Dize snippet'i)

İşaretçinin snippet'ini ayarlar.

Parametreler
snippet null ise snippet temizlenir.

herkese açık void setTag (Nesne etiketi)

İşaretçinin etiketini ayarlar.

İsteğe bağlı bir Object öğesini bu işaretçiyle ilişkilendirmek için bu özelliği kullanabilirsiniz. Örneğin Object, işaretçinin neyi temsil ettiğiyle ilgili veriler içerebilir. Bu, ayrı bir Map<Marker, 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 setTitle (Dize başlığı)

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

Parametreler
başlık boşsa başlık temizlenir.

herkese açık void setVisible (boolean visible)

Bu işaretçinin görünürlüğünü ayarlar. false olarak ayarlandıysa ve bu işaretçi için şu anda bir bilgi penceresi gösteriliyorsa bilgi penceresi gizlenir.

Parametreler
görünür

herkese açık void setZIndex (float zIndex)

İşaretçinin zEndeksi'ni ayarlar.

Parametreler
zIndex

herkese açık void showInfoWindow ()

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

Dekoratif yastıklar
IllegalArgumentException marker bu haritada yoksa