Marker

Marker sınıf

google.maps.Marker sınıf

Bu sınıfın kapsamı MVCObject şeklindedir.

const {Marker} = await google.maps.importLibrary("marker") numaralı telefonu arayarak erişin. Haritalar JavaScript API'sindeki Kitaplıklar başlıklı makaleyi 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. Harita belirtilirse, işaretçi inşaat sırasında haritaya eklenir. İşaretçinin görüntülenmesi için konumun ayarlanması gerektiğini unutmayın.
MAX_ZINDEX API'nin bir işaretçiye atayacağı varsayılan maksimum 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
Şu anda çalışan animasyonu alın.
getClickable
getClickable()
Parametreler: Yok
Döndürme Değeri:  boolean İşaretçi tıklanabilirse doğru değerini alır.
Marker öğesinin tıklanabilir durumunu alın.
getCursor
getCursor()
Parametreler: Yok
Dönüş Değeri:  string|null|undefined
Fareyle üzerine gelindiğinde fare imleci türünün gösterilmesini sağlar.
getDraggable
getDraggable()
Parametreler: Yok
Döndürme Değeri:  boolean İşaretçi sürüklenebiliyorsa 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 öğesinin etiketini alın. Şu sayfaya göz atın: MarkerOptions.label.
getMap
getMap()
Parametreler: Yok
Dönüş Değeri:  Map|StreetViewPanorama
Marker öğesinin oluşturulduğu haritayı veya panoramayı alın.
getOpacity
getOpacity()
Parametreler: Yok
Döndürme Değeri:  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ürme Değeri:  boolean İşaretçi görünürse doğrudur.
Marker ile ilgili ayrıntıları görün.
getZIndex
getZIndex()
Parametreler: Yok
Döndürme Değeri:  number|null|undefined z-İşaretçinin Endeksi.
Marker öğesinin z Index'ini 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 şunlardır: Animation.BOUNCE, Animation.DROP. null öğesinin iletilmesi tüm animasyonların durmasına neden olur.
setClickable
setClickable(flag)
Parametreler: 
  • flagboolean true ise işaretçi tıklanabilir.
Return Value: Yok
Marker öğesi tıklanabilir ise 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 için etiketi ayarlayın. Şu sayfaya göz atın: MarkerOptions.label.
setMap
setMap(map)
Parametreler: 
Return Value: Yok
Belirtilen harita veya panoramada Marker oluşturur. Harita null olarak ayarlanırsa işaretçi kaldırılır.
setOpacity
setOpacity([opacity])
Parametreler: 
  • opacitynumber optional 0,0 (şeffaf) ve 1,0 (opak) arasında bir sayı.
Return Value: Yok
Marker öğesinin opaklığını ayarlayın.
setOptions
setOptions(options)
Parametreler: 
Return Value: Yok
Marker için seçenekleri ayarlayın.
setPosition
setPosition([latlng])
Parametreler: 
Return Value: Yok
Marker için yayını ayarlayın.
setShape
setShape([shape])
Parametreler: 
Return Value: Yok
Etkileşim için kullanılan Marker öğesinin ş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 işaretçi görünür.
Return Value: Yok
Marker öğesinin görünür olup olmadığını ayarlayın.
setZIndex
setZIndex([zIndex])
Parametreler: 
  • zIndexnumber optional
Return Value: Yok
Marker öğesinin z Endeksini 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, Marker üzerinde DOM içerik menüsü etkinliği 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: 
Kullanıcı Marker öğesini sürüklerken bu etkinlik 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 sabit özelliği 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 öğesinde fare aşağı çekilmesi için tetiklenir.
mouseout
function(event)
Bağımsız değişkenler: 
Bu etkinlik, fare Marker simge alanındaki alandan ayrıldığında tetiklenir.
mouseover
function(event)
Bağımsız değişkenler: 
Bu etkinlik, fare Marker simgesinin alanına girdiğinde tetiklenir.
mouseup
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker üzerinde fareyle üzerine gelme eylemi için 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 özelliği değiştiğinde tetiklenir.
rightclick
function(event)
Bağımsız değişkenler: 
Bu etkinlik, Marker öğesi sağ tıklandığında 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, işaretçiyle açılmış bir InfoWindow'un ucuna kadar olan ofset.
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ışı belirleyin.
crossOnDrag optional
Tür:  boolean optional
Varsayılan: true
false ise sürüklerken işaretçinin altında görünen artı 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ğlandığında url dizesine sahip bir Icon olduğu kabul edilir.
label optional
Tür:  string|MarkerLabel optional
Varsayılan: null
İşaretçiye bir etiket ekler. İşaretçi etiketi, işaretçinin içinde görünen bir harf veya sayıdır. Etiket bir dize veya MarkerLabel nesnesi olabilir. Sağlanmışsa ve MarkerOptions.title sağlanmazsa bir erişilebilirlik metni (ör. ekran okuyucularla kullanım için) sağlanan etiketin metniyle birlikte işaretçiye eklenir. label öğesinin şu anda yalnızca optimize edilmemiş işaretçilere ilişkin erişilebilirlik metni için kullanıldığını lütfen unutmayın.
map optional
Tür:  Map|StreetViewPanorama optional
İşaretçinin görüntüleneceği harita. Harita, işaretçiyi görüntülemek için gereklidir ve işaretçi oluşturulurken Marker.setMap ile sağlanabilir.
opacity optional
Tür:  number optional
Varsayılan: 1,0
0,0 (şeffaf) ve 1,0 (opak) arasında bir sayı.
optimized optional
Tür:  boolean optional
Optimizasyon, çok sayıda 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 yararlıdır. İşaretçi optimizasyonu hakkında daha fazla bilgi edinin.
position optional
Tür:  LatLng|LatLngLiteral optional
İşaretçinin konumunu ayarlar. İşaretçiler oluşturulabilir ancak, konumu sağlanana kadar (ör. kullanıcının eylemleri veya seçimleri aracılığıyla) gösterilemez. İşaretçi oluşturma sırasında sağlanmazsa Marker.setPosition ile bir işaretçi konumu 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örünen metin. Sağlandığında, belirtilen değerle birlikte işaretçiye bir erişilebilirlik metni (ör. ekran okuyucularla kullanım için) eklenir. title öğesinin şu anda yalnızca optimize edilmemiş işaretçilere ilişkin erişilebilirlik metni için kullanıldığını lütfen 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, harita üzerinde z Endeksi sırasıyla görüntülenir. Yüksek değerler, daha düşük değerlere sahip işaretçilerin önünde görüntülenir. Varsayılan olarak, işaretçiler ekrandaki dikey konumlarına göre görüntülenir. Alttaki işaretçiler, ekranın daha üst kısmındaki işaretçilerin önünde görünür.

CollisionBehavior sabitleri

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ı makaleyi inceleyin.

OPTIONAL_AND_HIDES_LOWER_PRIORITY İşaretçiyi yalnızca diğer işaretçilerle çakışmadığında görüntüleyin. Bu türdeki iki işaretçi çakışırsa, daha yüksek zEndeksine sahip olan işaretçi gösterilir. Aynı z Endeksine sahiplerse, dikey ekran konumu daha aşağıda olan öğe gösterilir.
REQUIRED Çarpışmalardan bağımsız olarak işaretçiyi her zaman görüntüle. Bu, varsayılan davranıştır.
REQUIRED_AND_HIDES_OPTIONAL İşaretçiyi çarpışmadan bağımsız olarak her zaman görüntüleyin ve işaretçiyle çakışan OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçileri veya etiketleri gizleyin.

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
Bir resmin, haritadaki işaretçinin konumuna karşılık gelecek şekilde demirleneceği konum. Varsayılan olarak sabit nokta, resmin alt kısmının merkez noktası boyunca bulunur.
labelOrigin optional
Tür:  Point optional
İşaretçi tarafından bir etiket sağlanmışsa, etiketin simge görüntüsünün sol üst köşesine göre kaynağı. Başlangıç noktası, varsayılan olarak resmin merkez noktasında bulunur.
origin optional
Tür:  Point optional
Varsa, resmin bir imge içindeki konumu. Varsayılan olarak kaynak, (0, 0) görüntüsünün sol üst köşesinde bulunur.
scaledSize optional
Tür:  Size optional
Varsa ölçeklendirmeden sonra resmin tamamının boyutu. Bir resmi veya imgeyi genişletmek/daraltmak için bu özelliği kullanın.
size optional
Tür:  Size optional
İmge veya resmin görüntü boyutu. İmge boyutunu kullanırken imge 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ünen bir dizedir (genellikle tek bir karakter). Özel bir işaretçiyle 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 class özelliğine eşdeğerdir). Birden fazla boşlukla ayrılmış CSS sınıfı eklenebilir. Yazı tipi rengi, boyutu, ağırlığı ve ailesi yalnızca diğer MarkerLabel özellikleri aracılığıyla ayarlanabilir. İşaretçi çakışma yönetimi de kullanılıyorsa CSS sınıfları etiketin konumunu veya yönünü değiştirmek için (ör. çevirme ve döndürme kullanma) 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 yazı tipi ailesi ö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 karşılık gelir).
fontWeight optional
Tür:  string optional
Etiket metninin yazı tipi ağırlığı (CSS yazı tipi ağırlığı özelliğine karşılık gelir).

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 alanını 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 adresinde bulunan w3 REGION coords spesifikasyonuna uygundur.
coords özelliği, şeklin hedef resmin sol üst köşesine göre piksel konumunu belirten tam sayı dizisidir. Koordinatlar type değerine bağlıdır:
- circle: Koordinatlar [x1,y1,r] şeklindedir; burada x1,y2, dairenin merkezinin koordinatlarını, r ise çemberin yarıçapını ifade eder.
- poly: Koordinatlar [x1,y1,x2,y2...xn,yn]'dir. Burada her x,y çifti, poligonun bir köşe noktasının koordinatlarını içerir.
- rect: Koordinatlar [x1,y1,x2,y2]'dir; burada x1,y1 dikdörtgenin sol üst köşesinin koordinatlarını, x2,y2 ise dikdörtgenin sağ alt koordinatlarının koordinatlarını ifade eder.
type
Tür:  string
Şeklin türünü açıklar ve circle, poly veya rect olabilir.

Sembol arayüz

google.maps.Symbol arayüz

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

path
Tür:  SymbolPath|string
Yerleşik bir simge yolu veya SVG yol gösterimi kullanılarak ifade edilen özel bir yol olan simge yolu. Zorunlu.
anchor optional
Tür:  Point optional
Varsayılan: google.maps.Point(0,0)
Simgenin işaretçiye veya çoklu çizgiye göre konumu. Simgenin yolunun koordinatları, çapanın x ve y koordinatlarına göre sırasıyla sola ve yukarıya çevrilir. Konum, simgenin yoluyla aynı koordinat sisteminde ifade edilir.
fillColor optional
Tür:  string optional
Simgenin dolgu rengi. Genişletilmiş adlandırılmış renkler dışında tüm CSS3 renkleri desteklenir. Sembol işaretçileri için bu değer varsayılan olarak "siyah" olur. Çoklu çizgilerdeki simgeler için bu ayar, varsayılan olarak ilgili çoklu çizginin fırça rengine ayarlanı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ğlandıysa, yolun kaynağına göre etiketin kaynağı. Başlangıç noktası, simgenin yolu ile aynı koordinat sisteminde ifade edilir. Bu özellik, çoklu çizgilerdeki simgeler için kullanılmıyor.
rotation optional
Tür:  number optional
Varsayılan: 0
Simgenin döndürüleceği açı. Saat yönünde derece cinsinden ifade edilir. IconSequence öğesinde, fixedRotation değerinin false olduğu bir simge, üzerinde yer aldığı kenarın açısına göre döndürülür.
scale optional
Tür:  number optional
Simgenin boyut olarak ölçeklenme miktarı. Simge işaretçileri için bu değer varsayılan olarak 1'dir. Ölçeklendirmeden sonra simge herhangi bir boyutta olabilir. Çoklu çizgi üzerindeki simgeler için bu ayar varsayılan olarak çoklu çizginin fırça ağırlığına göre ayarlanır. Ölçeklendirmeden sonra, simge, simgenin sabitlendiği noktada ortalanmış olarak 22 piksel boyutunda bir karenin içinde olmalıdır.
strokeColor optional
Tür:  string optional
Simgenin fırça rengi. Genişletilmiş adlandırılmış renkler dışında tüm CSS3 renkleri desteklenir. Sembol işaretçileri için bu değer varsayılan olarak "siyah" olur. Çoklu çizgi üzerindeki simgeler için bu ayar varsayılan olarak çoklu çizginin fırça rengine ayarlanı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 çizgi üzerindeki simgeler için bu ayar, varsayılan olarak çoklu çizginin çizgi opaklığına ayarlanır.
strokeWeight optional
Tür:  number optional
Varsayılan: Simgenin Symbol.scale değeri.
Simgenin fırça ağırlığı.

SymbolPath sabitleri

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ı makaleyi inceleyin.

BACKWARD_CLOSED_ARROW Geriye bakan kapalı ok.
BACKWARD_OPEN_ARROW Geriye dönük açık ok.
CIRCLE Çevre.
FORWARD_CLOSED_ARROW Öneyi gösteren kapalı ok.
FORWARD_OPEN_ARROW İleriyi gösteren açık ok.

Animasyon sabitleri

google.maps.Animation sabit değer

İşaretçi üzerinde oynatılabilen animasyonlar. Bir animasyonu oynatmak için İşaretçi'de 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ı makaleyi inceleyin.

BOUNCE İşaretçi null ile Marker.setAnimation çağırılarak animasyon durdurulana kadar geri sekiyor.
DROP İşaretçi, haritanın tepesinden nihai konumuna düşer. İşaretçi etkinleştiğinde animasyon sonlandırılır ve Marker.getAnimation, null değerini döndürür. Bu tür animasyonlar genellikle işaretçi oluşturulurken belirtilir.