Marker (legacy)

Marker sınıfı

google.maps.Marker sınıf

Bu sınıf, MVCObject sınıfını genişletir.

const {Marker} = await google.maps.importLibrary("marker") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

Marker
Marker([opts])
Parametreler: 
Belirtilen seçeneklerle bir işaretçi oluşturur. Bir harita belirtilirse işaretçi, oluşturulduktan sonra haritaya eklenir. İşaretçinin gösterilmesi için konumun ayarlanması gerektiğini unutmayın.
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 ayarlayabilirsiniz.
getAnimation
getAnimation()
Parametreler:  Yok
Dönüş Değeri:  Animation|null|undefined
Çalışmakta olan animasyonu alır.
getClickable
getClickable()
Parametreler:  Yok
Dönüş Değeri:  boolean İşaretçi tıklanabilirse True.
Marker öğesinin tıklanabilir durumunu öğrenin.
getCursor
getCursor()
Parametreler:  Yok
Dönüş Değeri:  string|null|undefined
Fareyle üzerine gelindiğinde gösterilen fare imleci türünü alın.
getDraggable
getDraggable()
Parametreler:  Yok
Dönüş Değeri:  boolean İşaretçi sürüklenebiliyorsa True (Doğru) değerini döndürür.
Marker öğesinin sürüklenebilir durumunu öğrenin.
getIcon
getIcon()
Parametreler:  Yok
Dönüş Değeri:  string|Icon|Symbol|null|undefined
Marker simgesini alın. Şu sayfaya göz atın: MarkerOptions.icon.
getLabel
getLabel()
Parametreler:  Yok
Dönüş Değeri:  MarkerLabel|string|null|undefined
Marker etiketini alın. Şu sayfaya göz atın: MarkerOptions.label.
getMap
getMap()
Parametreler:  Yok
Dönüş Değeri:  Map|StreetViewPanorama|null
Marker öğesinin oluşturulduğu haritayı veya panoramayı alın.
getOpacity
getOpacity()
Parametreler:  Yok
Döndürülen değer:  number|null|undefined 0,0 ile 1,0 arasında bir sayı.
Marker öğesinin opaklığını alın.
getPosition
getPosition()
Parametreler:  Yok
Dönüş Değeri:  LatLng|null|undefined
Marker öğesinin konumunu alın.
getShape
getShape()
Parametreler:  Yok
Dönüş Değeri:  MarkerShape|null|undefined
Etkileşim için kullanılan Marker şeklini alın. MarkerOptions.shape ve MarkerShape hükümlerini inceleyin.
getTitle
getTitle()
Parametreler:  Yok
Dönüş Değeri:  string|null|undefined
Marker ipucunun başlığını alın. Şu sayfaya göz atın: MarkerOptions.title.
getVisible
getVisible()
Parametreler:  Yok
Döndürülen Değer:  boolean İşaretçi görünürse True.
Marker görünürlüğünü elde edin.
getZIndex
getZIndex()
Parametreler:  Yok
Döndürülen Değer:  number|null|undefined İşaretçinin zIndex değeri.
Marker öğesinin zIndex değerini alın. Şu sayfaya göz atın: MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parametreler: 
  • animation:  Animation optional Oynatılacak animasyon.
Döndürülen değer:  Yok
Animasyon başlatma Devam eden animasyonlar iptal edilir. Şu anda desteklenen animasyonlar: Animation.BOUNCE, Animation.DROP. null değerinin iletilmesi, animasyonun durmasına neden olur.
setClickable
setClickable(flag)
Parametreler: 
  • flag:  boolean true ise işaretçi tıklanabilir.
Döndürülen değer:  Yok
Marker öğesinin tıklanabilir olup olmadığını belirleyin.
setCursor
setCursor([cursor])
Parametreler: 
  • cursor:  string optional Fare imleci türü.
Döndürülen değer:  Yok
Fareyle üzerine gelindiğinde gösterilen fare imleci türünü ayarlayın.
setDraggable
setDraggable(flag)
Parametreler: 
  • flag:  boolean optional true ise işaretçi sürüklenebilir.
Döndürülen değer:  Yok
Marker öğesinin sürüklenebilir olup olmadığını ayarlayın.
setIcon
setIcon([icon])
Parametreler: 
Döndürülen değer:  Yok
Marker için simgeyi ayarlayın. Şu sayfaya göz atın: MarkerOptions.icon.
setLabel
setLabel([label])
Parametreler: 
Döndürülen değer:  Yok
Marker için etiket ayarlayın. Şu sayfaya göz atın: MarkerOptions.label.
setMap
setMap(map)
Parametreler: 
Döndürülen değer:  Yok
Belirtilen harita veya panoramada Marker öğesini oluşturur. Harita null olarak ayarlanırsa işaretçi kaldırılır.
setOpacity
setOpacity([opacity])
Parametreler: 
  • opacity:  number optional 0,0 (şeffaf) ile 1,0 (opak) arasında bir sayı.
Döndürülen değer:  Yok
Marker opaklığını ayarlayın.
setOptions
setOptions(options)
Parametreler: 
Döndürülen değer:  Yok
Marker için seçenekleri ayarlayın.
setPosition
setPosition([latlng])
Parametreler: 
Döndürülen değer:  Yok
Marker için konumu ayarlayın.
setShape
setShape([shape])
Parametreler: 
Döndürülen değer:  Yok
Etkileşim için kullanılan Marker şeklini ayarlayın. MarkerOptions.shape ve MarkerShape hükümlerini inceleyin.
setTitle
setTitle([title])
Parametreler: 
  • title:  string optional
Döndürülen değer:  Yok
Marker ipucunun başlığını ayarlayın. Şu sayfaya göz atın: MarkerOptions.title.
setVisible
setVisible(visible)
Parametreler: 
  • visible:  boolean true ise işaretçi görünür.
Döndürülen değer:  Yok
Marker öğesinin görünür olup olmayacağını ayarlayın.
setZIndex
setZIndex([zIndex])
Parametreler: 
  • zIndex:  number optional
Döndürülen değer:  Yok
Marker öğesinin zIndex değerini ayarlayın. Şu sayfaya göz atın: MarkerOptions.zIndex.
Devralınan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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, Marker tıklanabilir özelliği değiştiğinde tetiklenir.
contextmenu
function(event)
Bağımsız değişkenler: 
Bu etkinlik, DOM contextmenu etkinliği Marker üzerinde tetiklendiğinde tetiklenir.
cursor_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker imleç ö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 bıraktığında 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 düz özelliği değiştiğinde tetiklenir.
icon_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker simge özelliği değiştiğinde tetiklenir.
mousedown
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker üzerinde fare düğmesine basıldığında 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 etkinlik, fare Marker simgesinin bulunduğu alana girdiğinde tetiklenir.
mouseup
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker üzerinde fare düğmesi bırakıldığında tetiklenir.
position_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker konum ö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ürlük özelliği değiştiğinde tetiklenir.
zindex_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker zIndex özelliği değiştiğinde tetiklenir.
rightclick
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker sağ tıklandığında tetiklenir.

MarkerOptions arayüzü

google.maps.MarkerOptions arayüz

MarkerOptions nesnesi, bir işaretçide ayarlanabilecek özellikleri tanımlamak için kullanılır.

anchorPoint optional
Tür:  Point optional
İşaretçinin konumundan, işaretçi sabit nokta olarak kullanılarak açılan bir InfoWindow'un ucuna olan uzaklık.
animation optional
Tür:  Animation optional
Varsayılan: null
Haritaya işaretçi 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 haritalardaki işaretçiler için çakışma davranışı ayarlama
crossOnDrag optional
Tür:  boolean optional
Varsayılan: true
false ise sürükleme sırasında 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. Not: Bu ayarı true olarak belirlediğinizde, clickable ayarı false olarak belirlenmiş olsa bile işaretçi tıklanabilir olur.
icon optional
Tür:  string|Icon|Symbol optional
Ön plan simgesi. Dize sağlanırsa dize url olacak şekilde Icon olarak değerlendirilir.
label optional
Tür:  string|MarkerLabel optional
Varsayılan: null
İşaretçiye etiket ekler. İşaretçi etiketi, işaretçinin içinde görünen bir harf veya sayıdır. Etiket, dize veya MarkerLabel nesnesi olabilir. Bu parametre sağlanır ve MarkerOptions.title sağlanmazsa işaretçiye, sağlanan etiketin metnini içeren bir erişilebilirlik metni (ör. ekran okuyucularla kullanım için) eklenir. label özelliğinin şu anda yalnızca optimize edilmemiş işaretçiler için erişilebilirlik metni amacıyla kullanıldığını unutmayın.
map optional
Tür:  Map|StreetViewPanorama optional
İşaretçinin gösterileceği harita. Harita, işaretçiyi görüntülemek için gereklidir ve işaretçi oluşturulurken sağlanmazsa Marker.setMap ile sağlanabilir.
opacity optional
Tür:  number optional
Varsayılan: 1.0
0,0 (şeffaf) ile 1,0 (opak) arasında 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, çok sayıda işaretçinin gerekli olduğu durumlarda kullanışlıdır. İşaretçi optimizasyonu hakkında daha fazla bilgi edinin. Not: Bu optimizasyonun vektör haritalardaki işaretçiler üzerinde herhangi bir etkisi yoktur.
position optional
Tür:  LatLng|LatLngLiteral optional
İşaretçi konumunu ayarlar. İşaretçi oluşturulabilir ancak konumu sağlanana kadar (ör. kullanıcının işlemleri veya seçimleri aracılığıyla) gösterilmez. İşaretçi oluşturulurken sağlanmadıysa işaretçi konumu Marker.setPosition ile sağlanabilir.
shape optional
Tür:  MarkerShape optional
Sürükleme/tıklama için kullanılan resim haritası bölge tanımı.
title optional
Tür:  string optional
Varsayılan: undefined
Fareyle üzerine gelindiğinde gösterilen 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 özelliğinin şu anda yalnızca optimize edilmemiş işaretçiler için erişilebilirlik metni amacıyla kullanıldığını unutmayın.
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, haritada zIndex değerlerine göre sıralanır. Daha yüksek değerlere sahip işaretçiler, 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österilir. Daha alçak işaretçiler, ekranın daha yukarısındaki işaretçilerin önünde görünür.

CollisionBehavior sabitleri

google.maps.CollisionBehavior sabitler

const {CollisionBehavior} = await google.maps.importLibrary("marker") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

OPTIONAL_AND_HIDES_LOWER_PRIORITY İşaretçiyi yalnızca diğer işaretçilerle çakışmıyorsa gösterin. Bu türden iki işaretçi çakışırsa zIndex değeri daha yüksek olan gösterilir. Aynı zIndex değerine sahiplerse dikey ekran konumu daha düşük olan gösterilir.
REQUIRED Çakışmadan bağımsız olarak işaretçiyi her zaman gösterir. Bu varsayılan davranıştır.
REQUIRED_AND_HIDES_OPTIONAL Çakışmadan bağımsız olarak işaretçiyi her zaman gösterir ve işaretçiyle çakışacak OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçilerini veya etiketlerini gizler.

Simge arayüzü

google.maps.Icon arayüz

İşaretçi simgesi 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şaretçinin konumuna karşılık gelen bir resmin sabitleneceği konum. Varsayılan olarak sabitleme noktası, resmin alt kısmının orta noktasında bulunur.
labelOrigin optional
Tür:  Point optional
İşaretçi tarafından bir etiket sağlanmışsa etiketin simge resminin sol üst köşesine göre başlangıç noktası. Varsayılan olarak başlangıç noktası, resmin merkez noktasında bulunur.
origin optional
Tür:  Point optional
Resmin bir sprite içindeki konumu (varsa). Varsayılan olarak başlangıç noktası, resmin sol üst köşesindedir (0, 0).
scaledSize optional
Tür:  Size optional
Ölçeklendirmeden sonraki tüm resmin boyutu (varsa). Bir resmi veya sprite'ı uzatmak/küçültmek için bu özelliği kullanın.
size optional
Tür:  Size optional
Sprite'ın veya resmin görüntüleme boyutu. Sprite kullanırken sprite boyutunu belirtmeniz gerekir. Boyut belirtilmezse resim yüklendiğinde ayarlanır.

MarkerLabel arayüzü

google.maps.MarkerLabel arayüz

Bu seçenekler, 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 karakter). Özel bir işaretçiyle kullanıyorsanız Icon sınıfındaki labelOrigin özelliğini kullanarak 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 class özelliğiyle eşdeğerdir). Boşlukla ayrılmış birden fazla CSS sınıfı eklenebilir. Yazı tipi rengi, boyutu, kalınlığı ve ailesi yalnızca MarkerLabel öğesinin diğer özellikleri aracılığıyla ayarlanabilir. İşaretçi çakışma yönetimi de kullanılıyorsa etiketin konumunu veya yönünü değiştirmek için CSS sınıfları kullanılmamalıdır (ör. çeviriler ve rotasyonlar kullanılarak).
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 mülküne eşdeğer).
fontSize optional
Tür:  string optional
Varsayılan: '14px'
Etiket metninin yazı tipi boyutu (CSS font-size özelliğine eşdeğer).
fontWeight optional
Tür:  string optional
Etiket metninin yazı tipi kalınlığı (CSS font-weight özelliğine eşdeğer).

MarkerShape arayüzü

google.maps.MarkerShape arayüz

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

type
Tür:  string
Şeklin türünü açıklar ve circle, poly veya rect olabilir.
coords optional
Tür:  Array<number> optional
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 adresinde bulunan w3 AREA coords spesifikasyonuna uygundur.
coords özelliği, şeklin hedef resmin sol üst köşesine göre piksel konumunu belirten bir tam sayı dizisidir. Koordinatlar, type değerine bağlıdır:
  - circle: coords, [x1,y1,r] şeklindedir. Burada x1,y2 dairenin merkezinin koordinatları, r ise dairenin yarıçapıdır.
  - poly: coords, her x,y çiftinin çokgenin bir köşesinin koordinatlarını içerdiği [x1,y1,x2,y2...xn,yn] değeridir.
  - rect: coords, [x1,y1,x2,y2] şeklindedir. Burada x1,y1 dikdörtgenin sol üst köşesinin koordinatları, x2,y2 ise dikdörtgenin sağ alt köşesinin koordinatlarıdır.

Symbol arayüzü

google.maps.Symbol arayüz

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

path
Tür:  SymbolPath|string
Yerleşik bir sembol yolu olan sembol 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)
Sembolün işaretçiye veya çoklu çizgiye göre konumu. Sembol yolunun koordinatları, sırasıyla sabitleyicinin x ve y koordinatlarına göre sola ve yukarı çevrilir. Konum, sembolün yolu ile aynı koordinat sisteminde ifade edilir.
fillColor optional
Tür:  string optional
Sembolün dolgu rengi. Genişletilmiş adlandırılmış renkler hariç tüm CSS3 renkleri desteklenir. Sembol işaretçiler için bu değer varsayılan olarak "black" (siyah) olarak ayarlanır. Çoklu çizgilerdeki semboller için bu, varsayılan olarak ilgili çoklu çizginin çizgi rengine ayarlanır.
fillOpacity optional
Tür:  number optional
Varsayılan: 0
Sembolün 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ğı. Başlangıç noktası, sembolün yolu ile aynı koordinat sisteminde ifade edilir. Bu özellik, çoklu çizgilerdeki semboller için kullanılmaz.
rotation optional
Tür:  number optional
Varsayılan: 0
Sembolün döndürüleceği açı (saat yönünde derece cinsinden ifade edilir). fixedRotation'in false olduğu bir IconSequence içindeki sembol, üzerinde bulunduğu kenarın açısına göre döndürülür.
scale optional
Tür:  number optional
Sembolün boyutunun ölçeklendirildiği miktar. Sembol işaretçiler için bu değer varsayılan olarak 1'dir. Ölçeklendirmeden sonra sembol herhangi bir boyutta olabilir. Çoklu çizgi üzerindeki semboller için bu değer varsayılan olarak çoklu çizginin çizgi kalınlığına ayarlanır. Ölçeklendirmeden sonra sembol, sembolün bağlantı noktasını ortalayan 22 piksel boyutunda bir karenin içinde olmalıdır.
strokeColor optional
Tür:  string optional
Sembolün çizgi rengi. Genişletilmiş adlandırılmış renkler hariç tüm CSS3 renkleri desteklenir. Sembol işaretçiler için bu değer varsayılan olarak "black" (siyah) olarak ayarlanır. Çoklu çizgi üzerindeki semboller için bu, varsayılan olarak çoklu çizginin kontur rengine ayarlanır.
strokeOpacity optional
Tür:  number optional
Sembolün kontur opaklığı. Sembol işaretçiler için bu değer varsayılan olarak 1'dir. Çoklu çizgi üzerindeki semboller için bu değer, varsayılan olarak çoklu çizginin çizgi opaklığına ayarlanır.
strokeWeight optional
Tür:  number optional
Varsayılan: Sembolün Symbol.scale.
Sembolün çizgi kalınlığı.

SymbolPath sabitleri

google.maps.SymbolPath sabitler

Yerleşik sembol yolları.

const {SymbolPath} = await google.maps.importLibrary("core") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

BACKWARD_CLOSED_ARROW Geriye doğru bakan kapalı bir ok.
BACKWARD_OPEN_ARROW Geriye doğru bakan açık bir ok.
CIRCLE Daire.
FORWARD_CLOSED_ARROW İleriye dönük kapalı bir ok.
FORWARD_OPEN_ARROW İleriye dönük açık ok.

Animasyon sabitleri

google.maps.Animation sabitler

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

const {Animation} = await google.maps.importLibrary("marker") numarasını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

BOUNCE İşaretçi, Marker.setAnimation null ile çağrılarak animasyon durdurulana kadar zıplar.
DROP İşaretçi, haritanın üst kısmından son konumuna düşer. İşaretçi durduğunda animasyon sona erer ve Marker.getAnimation, null değerini döndürür. Bu tür animasyonlar genellikle işaretçi oluşturulurken belirtilir.