Marker

Marker sınıfı

google.maps.Marker sınıf

Bu sınıf MVCObject tarihinde uzatılır.

const {Marker} = await google.maps.importLibrary("marker") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.

Marker
Marker([opts])
Parametreler: 
  • optsMarkerOptions optional Adlandırılmış isteğe bağlı bağımsız değişkenler
Belirtilen seçeneklerle bir işaretçi oluşturur. Bir harita belirtilirse, işaretçi inşaat sırasında haritaya eklenir. İşaretleyicinin görüntülenmesi için konumun ayarlanması gerektiğini unutmayın.
getAnimation
getAnimation()
Parametreler: Yok
İade Değeri:  Animation|null|undefined
Şu anda çalışan animasyonu alın.
getClickable
getClickable()
Parametreler: Yok
İade Değeri:  boolean İşaretçi tıklanabilirse doğru değerini alır.
Marker öğesinin tıklanabilir durumunu öğrenin.
getCursor
getCursor()
Parametreler: Yok
İade Değeri:  string|null|undefined
Fareyle üzerine geldiğinizde fare imlecinin türünün gösterilmesini sağlayın.
getDraggable
getDraggable()
Parametreler: Yok
İade Değeri:  boolean İşaretçi sürüklenebilirse doğru değerini döndürür.
Marker öğesinin sürüklenebilir durumunu alın.
getIcon
getIcon()
Parametreler: Yok
İade Değeri:  string|Icon|Symbol|null|undefined
Marker simgesini alın. Şu sayfaya göz atın: MarkerOptions.icon.
getLabel
getLabel()
Parametreler: Yok
İade Değeri:  MarkerLabel|string|null|undefined
Marker etiketini alın. Şu sayfaya göz atın: MarkerOptions.label.
getMap
getMap()
Parametreler: Yok
İade Değeri:  Map|StreetViewPanorama
Marker öğesinin oluşturulduğu haritayı veya panaromayı alın.
getOpacity
getOpacity()
Parametreler: Yok
Dönüş Değeri:  number|null|undefined 0,0 ile 1,0 arasında bir sayı.
Marker uygulamasının opaklığını alın.
getPosition
getPosition()
Parametreler: Yok
İade Değeri:  LatLng|null|undefined
Marker konumunu alın.
getShape
getShape()
Parametreler: Yok
İade Değeri:  MarkerShape|null|undefined
Etkileşim için kullanılan Marker şeklinin şeklini alın. MarkerOptions.shape ve MarkerShape hükümlerini inceleyin.
getTitle
getTitle()
Parametreler: Yok
İade Değeri:  string|null|undefined
Marker ipucunun başlığını alın. Şu sayfaya göz atın: MarkerOptions.title.
getVisible
getVisible()
Parametreler: Yok
İade Değeri:  boolean İşaretçi görünürse Doğru değerini alır.
Marker görünürlüğünüzü elde edin.
getZIndex
getZIndex()
Parametreler: Yok
İade Değeri: İşaretçinin number|null|undefined zIndex'i.
Marker zEndeksini alın. Şu sayfaya göz atın: MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parametreler: 
  • animationAnimation optional Oynatılacak animasyon.
Return Value: Yok
Bir animasyon başlatın. Devam eden tüm animasyonlar iptal edilir. Şu anda desteklenen animasyonlar: Animation.BOUNCE, Animation.DROP. null parametresinde geçiş yaparsanız animasyonun durması gerekir.
setClickable
setClickable(flag)
Parametreler: 
  • flagboolean true ise, İşaretçi tıklanabilir.
Return Value: Yok
Marker öğesinin tıklanabilir olup olmadığını ayarlayın.
setCursor
setCursor([cursor])
Parametreler: 
  • cursorstring optional Fare imleci türü.
Return Value: Yok
Fareyle üzerine gelindiğinde gösterilen fare imleci türünü ayarlayın.
setDraggable
setDraggable(flag)
Parametreler: 
  • flagboolean optional true ise işaretçi sürüklenebilir.
Return Value: Yok
Marker öğesinin sürüklenebilir olup olmadığını ayarlayın.
setIcon
setIcon([icon])
Parametreler: 
Return Value: Yok
Marker simgesini ayarlayın. Şu sayfaya göz atın: MarkerOptions.icon.
setLabel
setLabel([label])
Parametreler: 
Return Value: Yok
Marker etiketini ayarlayın. Şu sayfaya göz atın: MarkerOptions.label.
setMap
setMap(map)
Parametreler: 
Return Value: Yok
Belirtilen haritada veya panoramada Marker oluşturur. Harita null değerine ayarlanırsa işaretçi kaldırılır.
setOpacity
setOpacity([opacity])
Parametreler: 
  • opacitynumber optional 0, 0, şeffaf ve 1, 0 opak bir sayı.
Return Value: Yok
Marker cihazının opaklığını ayarlayın.
setOptions
setOptions(options)
Parametreler: 
Return Value: Yok
Marker ile ilgili seçenekleri belirleyin.
setPosition
setPosition([latlng])
Parametreler: 
Return Value: Yok
Marker için konumu belirleyin.
setShape
setShape([shape])
Parametreler: 
Return Value: Yok
Etkileşim için kullanılan Marker şeklini ayarlayın. MarkerOptions.shape ve MarkerShape hükümlerini inceleyin.
setTitle
setTitle([title])
Parametreler: 
  • titlestring optional
Return Value: Yok
Marker ipucunun başlığını ayarlayın. Şu sayfaya göz atın: MarkerOptions.title.
setVisible
setVisible(visible)
Parametreler: 
  • visibleboolean true ise İşaretçi görünür
Return Value: Yok
Marker öğesinin görünür olup olmayacağını ayarlayın.
setZIndex
setZIndex([zIndex])
Parametreler: 
  • zIndexnumber optional
Return Value: Yok
Marker için zIndex'i ayarlayın. Şu sayfaya göz atın: MarkerOptions.zIndex.
Devralındı: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
MAX_ZINDEX API'nin bir işaretçiye atayacağı maksimum varsayılan Z-endeksi. Bir işaretçiyi öne getirmek için daha yüksek bir Z-endeksi belirleyebilirsiniz.
animation_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker animasyon özelliği değiştiğinde tetiklenir.
click
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker simgesi tıklandığında tetiklenir.
clickable_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, tıklanabilir Marker özelliği değiştiğinde tetiklenir.
contextmenu
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker tarihinde DOM bağlam menüsü etkinliği tetiklendiğinde tetiklenir
cursor_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker imleci özelliği değiştiğinde tetiklenir.
dblclick
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker simgesi çift tıklandığında tetiklenir.
drag
function(event)
Bağımsız değişkenler: 
Bu etkinlik, kullanıcı Marker öğesini sürüklerken tekrar tekrar tetiklenir.
dragend
function(event)
Bağımsız değişkenler: 
Bu etkinlik, kullanıcı Marker öğesini sürüklemeyi durdurduğunda tetiklenir.
draggable_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker sürüklenebilir özelliği değiştiğinde tetiklenir.
dragstart
function(event)
Bağımsız değişkenler: 
Bu etkinlik, kullanıcı Marker öğesini sürüklemeye başladığında tetiklenir.
flat_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker sabit mülkü değiştiğinde tetiklenir.
icon_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker simgesi özelliği değiştiğinde tetiklenir.
mousedown
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker tarihinde fareyle üzerine gelindiğinde tetiklenir.
mouseout
function(event)
Bağımsız değişkenler: 
Bu etkinlik, fare Marker simgesinin alanından ayrıldığında tetiklenir.
mouseover
function(event)
Bağımsız değişkenler: 
Bu simge, fare Marker simgesinin alanına girdiğinde tetiklenir.
mouseup
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker tarihinde fareyle üzerine gelindiğinde tetiklenir.
position_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker konumu özelliği değiştiğinde tetiklenir.
shape_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker şekil özelliği değiştiğinde tetiklenir.
title_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker başlık özelliği değiştiğinde tetiklenir.
visible_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker görünür özelliği değiştiğinde tetiklenir.
zindex_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker zIndex mülkü değiştiğinde tetiklenir.
rightclick
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker uygulamasında sağ tıklama için tetiklenir.

MarkerOptions arayüzü

google.maps.MarkerOptions arayüz

İşaretçi üzerinde ayarlanabilecek özellikleri tanımlamak için kullanılan MarkerOptions nesnesi.

anchorPoint optional
Tür:  Point optional
İşaretçinin konumundan sabit olarak açılan Bilgi Penceresinin ucuna olan uzaklık.
animation optional
Tür:  Animation optional
Varsayılan: null
İşaretçi bir haritaya eklendiğinde oynatılacak animasyon.
clickable optional
Tür:  boolean optional
Varsayılan: true
true ise işaretçi, fare ve dokunma etkinliklerini alır.
BetacollisionBehavior optional
Tür:  string|CollisionBehavior optional
Varsayılan: null
Vektör haritalarındaki işaretçiler için bir çarpışma davranışı ayarlayın.
crossOnDrag optional
Tür:  boolean optional
Varsayılan: true
false ise işaretçiyi sürüklerken işaretçinin altında görünen çarpı işaretini devre dışı bırakır.
cursor optional
Tür:  string optional
Varsayılan: pointer
Fareyle üzerine gelindiğinde gösterilecek fare imleci türü.
draggable optional
Tür:  boolean optional
Varsayılan: false
true ise işaretçi sürüklenebilir.
icon optional
Tür:  string|Icon|Symbol optional
Ön plan simgesi. Bir dize sağlanmışsa url gibi bir dizeye sahipmiş gibi değerlendirilir.Icon
label optional
Tür:  string|MarkerLabel optional
Varsayılan: null
İşaretçiye bir etiket ekler. İşaretçi etiketi, bir işaretçinin içinde görünen harf veya sayıdır. Etiket bir dize veya MarkerLabel nesnesi olabilir. Sağlanırsa ve MarkerOptions.title sağlanmazsa işaretçiye sağlanan etiketin metnini içeren bir erişilebilirlik metni (ör. ekran okuyucularla kullanım) eklenir. label şu anda yalnızca optimize edilmemiş işaretçilerdeki erişilebilirlik metinleri için kullanılmaktadır.
map optional
Tür:  Map|StreetViewPanorama optional
İşaretçinin gösterileceği harita. Harita, işaretleyicinin görüntülenmesi için gereklidir ve işaretçi oluşturma sırasında sağlanmazsa Marker.setMap ile sağlanabilir.
opacity optional
Tür:  number optional
Varsayılan: 1,0
0, 0, şeffaf ve 1, 0 arasında opak bir sayı.
optimized optional
Tür:  boolean optional
Optimizasyon, birçok işaretçiyi tek bir statik öğe olarak oluşturarak performansı artırır. Bu seçenek, çok sayıda işaretçinin gerekli olduğu durumlarda yararlıdır. İşaretçi optimizasyonu hakkında daha fazla bilgi edinin.
position optional
Tür:  LatLng|LatLngLiteral optional
İşaretçi konumunu ayarlar. İşaretçi oluşturulabilir ancak konumu sağlanana kadar (örneğin, kullanıcının işlemleri veya seçimleri tarafından) görüntülenemeyebilir. İşaretçi oluşturmasında belirtilmezse Marker.setPosition ile bir işaretçi konumu sağlanabilir.
shape optional
Tür:  MarkerShape optional
Sürüklemek/tıklamak için kullanılan resim haritası bölge tanımı.
title optional
Tür:  string optional
Varsayılan: undefined
Fareyle üzerine gelindiğinde görünen metin. Sağlanırsa işaretçiye sağlanan değerle birlikte bir erişilebilirlik metni (ör. ekran okuyucularla kullanım için) eklenir. title şu anda yalnızca optimize edilmemiş işaretçilerdeki erişilebilirlik metinleri için kullanılmaktadır.
visible optional
Tür:  boolean optional
Varsayılan: true
true ise işaretçi görünür.
zIndex optional
Tür:  number optional
Tüm işaretçiler, zIndex sırasına göre gösterilir. Yüksek değerler, daha düşük değerlere sahip işaretçilerin önünde gösterilir. Varsayılan olarak, işaretçiler ekrandaki dikey konumlarına göre görüntülenir. İşaretçiler ekranın üst kısmındaki işaretçilerin önünde görünür.

CollisionBehavior sabit değerleri

google.maps.CollisionBehavior sabit değer

const {CollisionBehavior} = await google.maps.importLibrary("marker") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.

OPTIONAL_AND_HIDES_LOWER_PRIORITY İşaretçiyi yalnızca diğer işaretçilerle çakışmadığında görüntüleyin. Bu türden iki işaretçi çakışırsa yüksek zEndeksine sahip olan gösterilir. Aynı zEndeksine sahipse düşük dikey ekran konumuna sahip olan dizin gösterilir.
REQUIRED Çarpışma olayından bağımsız olarak her zaman işaretçiyi göster. Bu, varsayılan davranıştır.
REQUIRED_AND_HIDES_OPTIONAL Çarpışma işaretlerinden bağımsız olarak her zaman işaretçiyi görüntüleyin ve işaretçiyle çakışan tüm OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçilerini veya etiketlerini gizleyin.

Simge arayüzü

google.maps.Icon arayüz

İşaretçi simge resmini temsil eden bir yapı.

url
Tür:  string
Resmin veya model sayfasının URL'si.
anchor optional
Tür:  Point optional
Haritadaki işaretleyicinin konumuna karşılık olarak bir resmin hangi konuma sabitleneceği. Varsayılan olarak, sabit resim, resmin alt kısmının merkezinde yer alır.
labelOrigin optional
Tür:  Point optional
İşaretçi tarafından bir etiket sağlandıysa simge resminin sol üst köşesine göre etiketin kaynağı. Varsayılan olarak, kaynak resmin orta noktasında yer alır.
origin optional
Tür:  Point optional
Varsa resmin bir imge içindeki konumu. Varsayılan olarak, kaynak (0, 0) resminin sol üst köşesinde bulunur.
scaledSize optional
Tür:  Size optional
Ölçeklendirme yapıldıktan sonra resmin tamamının boyutu (varsa). Bir görüntüyü veya imgeyi uzatmak/küçültmek için bu özelliği kullanın.
size optional
Tür:  Size optional
İmge veya resmin görüntülenme boyutu. İmgeleri kullanırken imge boyutunu belirtmelisiniz. Boyut sağlanmazsa resim yüklendiğinde ayarlanır.

MarkerLabel arayüzü

google.maps.MarkerLabel arayüz

Bu seçenekler bir işaretçi etiketinin görünümünü belirtir. İşaretçi etiketi, işaretçinin içinde görünecek bir dizedir (genellikle tek bir karakterdir). Özel işaretçi ile kullanıyorsanız Icon sınıfındaki labelOrigin özelliğiyle yeniden konumlandırabilirsiniz.

text
Tür:  string
Etikette gösterilecek metin.
className optional
Tür:  string optional
Varsayılan: '' (boş dize)
Etiket öğesinin className özelliği (öğenin sınıf özelliğine eşdeğerdir). Birden fazla boşlukla ayrılmış CSS sınıfı eklenebilir. Yazı tipi rengi, boyutu, ağırlığı ve aile özellikleri yalnızca MarkerLabel ürününün diğer özellikleri aracılığıyla ayarlanabilir. İşaretçi çarpışma yönetimi kullanılıyorsa CSS sınıfları, etiketin konumunu veya yönünü değiştirmek için (ör. çeviriler ve rotasyonlar kullanılarak) kullanılmamalıdır.
color optional
Tür:  string optional
Varsayılan: 'black'
Etiket metninin rengi.
fontFamily optional
Tür:  string optional
Etiket metninin yazı tipi ailesi (CSS font-family özelliğine eşdeğerdir).
fontSize optional
Tür:  string optional
Varsayılan: '14px'
Etiket metninin yazı tipi boyutu (CSS yazı tipi boyutu özelliğine eşdeğerdir).
fontWeight optional
Tür:  string optional
Etiket metninin yazı tipi ağırlığı (CSS yazı tipi ağırlığı özelliğine eşdeğerdir).

MarkerShape arayüzü

google.maps.MarkerShape arayüz

Bu nesne, bir işaretçi resmin tıklanabilir bölgesini tanımlar. Şekil, bir resmin şeffaf olmayan bölgesini tanımlayan iki özellikten (type ve coord) oluşur.

coords
Tür:  Array<number>
Bu özelliğin biçimi type değerine bağlıdır ve http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords adresindeki w3 AREA coords spesifikasyonuna uygundur.
coords özelliği, hedef resmin sol üst köşesine göre şeklin piksel konumunu belirten bir tam sayı dizisidir. Koordinatlar type değerine şu şekilde bağlıdır:
-- circle: koordinatlar [x1,y1,r], x1,y2 çemberin orta noktasıdır ve r, çemberin yarıçapıdır.
- poly: Koordinatlar [x1,y1,x2,y2...xn,yn] şeklindedir. Her x,y çifti, poligonun bir tepe noktasının koordinatlarını içerir.
- rect: Koordinatlar [x1,y1,x2,y2]. koordinatlar x1,y1, dikdörtgenin sol üst köşesinin koordinatı, x2,y2 ise dikdörtgenin sağ alt koordinatlarının koordinatlarıdır.
type
Tür:  string
Şeklin türünü açıklar ve circle, poly ya da rect olabilir.

Sembol arayüzü

google.maps.Symbol arayüz

Stil içeren bir vektör yolundan oluşan sembolü açıklar. Sembol, bir işaretçinin simgesi olarak kullanılabilir veya çoklu çizgiye yerleştirilebilir.

path
Tür:  SymbolPath|string
Sembolün yerleşik bir yol olan yolu veya SVG yolu gösterimi kullanılarak ifade edilen özel bir yol. Zorunlu.
anchor optional
Tür:  Point optional
Varsayılan: google.maps.Point(0,0)
Simgenin işaretçiye veya çoklu çizgiye göre konumu. Sembolün yolunun koordinatları, çapanın x ve y koordinatlarıyla sola ve yukarıya doğru çevrilir. Konum, simgenin yolu ile aynı koordinat sisteminde ifade edilir.
fillColor optional
Tür:  string optional
Simgenin dolgu rengi. Genişletilmiş adlandırılmış renkler hariç tüm CSS3 renkleri desteklenir. Sembol işaretçileri için bu ayar varsayılan olarak "siyah" olur. Çoklu çizgilerdeki simgeler için varsayılan olarak ilgili çoklu çizginin fırça rengi kullanılır.
fillOpacity optional
Tür:  number optional
Varsayılan: 0
Simgenin dolgu opaklığı.
labelOrigin optional
Tür:  Point optional
Varsayılan: google.maps.Point(0,0)
Etiket, işaretçi tarafından sağlanıyorsa yolun kaynağına göre etiketin kaynağı. Kaynak, sembolün yolu ile aynı koordinat sisteminde ifade edilir. Bu özellik, çoklu çizgilerdeki simgeler için kullanılmaz.
rotation optional
Tür:  number optional
Varsayılan: 0
Simgenin döndürüleceği açı; saat yönünde derece cinsinden belirtilir. IconSequence işaretindeki fixedRotation simgesi, yattığı kenarın açısına göre false döndürülür.
scale optional
Tür:  number optional
Sembolün ölçeklendiği miktar. Sembol işaretçileri için bu değer varsayılan olarak 1'dir; ölçeklendirmeden sonra, simge herhangi bir boyutta olabilir. Çoklu çizgideki semboller için varsayılan olarak çoklu çizginin fırça ağırlığı belirlenir. Ölçeklendirme sonrasında simgenin çapası, merkezinde 22 piksel boyutunda bir kare içinde olmalıdır.
strokeColor optional
Tür:  string optional
Simgenin fırça rengi. Genişletilmiş adlandırılmış renkler hariç tüm CSS3 renkleri desteklenir. Sembol işaretçileri için bu ayar varsayılan olarak "siyah" olur. Çoklu çizgideki simgeler için varsayılan olarak çoklu çizginin fırça rengi kullanılır.
strokeOpacity optional
Tür:  number optional
Simgenin fırça opaklığı. Sembol işaretçileri için bu değer varsayılan olarak 1'dir. Çoklu çizgideki simgeler için varsayılan olarak çoklu çizginin fırça opaklığı kullanılır.
strokeWeight optional
Tür:  number optional
Varsayılan: Simgenin Symbol.scale simgesi.
Simgenin fırça ağırlığı.

SymbolPath sabit değerleri

google.maps.SymbolPath sabit değer

Yerleşik simge yolları.

const {SymbolPath} = await google.maps.importLibrary("core") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.

BACKWARD_CLOSED_ARROW Geriye dönük kapalı ok.
BACKWARD_OPEN_ARROW Geriye dönük açık ok.
CIRCLE Bir daire.
FORWARD_CLOSED_ARROW İleri dönük kapalı ok.
FORWARD_OPEN_ARROW İleri dönük açık ok.

Animasyon sabitleri

google.maps.Animation sabit değer

İşaretçi üzerinde oynatılabilecek animasyonlar. Animasyon oynatmak için İşaretçi'deki Marker.setAnimation yöntemini veya MarkerOptions.animation seçeneğini kullanın.

const {Animation} = await google.maps.importLibrary("marker") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki kitaplıklar başlıklı bölümü inceleyin.

BOUNCE İşaretçi, null ile Marker.setAnimation çağrılıp animasyon durdurulana kadar geri dönüyor.
DROP İşaretçi, haritanın üst kısmından son konumuna düşer. İşaretçi dinlenmeye geçtiğinde animasyon durur ve Marker.getAnimation, null değerini döndürür. Bu animasyon türü genellikle işaretçinin oluşturulması sırasında belirtilir.