Marker

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Marker sınıfı

google.maps.Marker sınıf

Bu ders MVCObject tarihine kadar geçerlidir.

v=beta kullanılırken const {Marker} = await google.map.importLibrary("marker") kullanılarak arama yapılabilir. Maps JavaScript API'deki kitaplıklar konusuna bakın.

Marker
Marker([opts])
Parametreler:
  • opts: MarkerOptions 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 oluşturma 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 oynatılan animasyonu indirin.
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 gelindiğinde fare imlecinin 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 öğrenin.
getIcon
getIcon()
Parametreler: Yok
İade Değeri: string|Icon|null|Symbol|undefined
Marker simgesini indirin. Bkz. MarkerOptions.icon.
getLabel
getLabel()
Parametreler: Yok
İade Değeri: MarkerLabel|null|string|undefined
Marker etiketini alın. Bkz. 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 seçeneğinin opaklığını öğrenin.
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 ş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. Bkz. MarkerOptions.title.
getVisible
getVisible()
Parametreler: Yok
İade Değeri: İşaretçi görünürse boolean Doğru.
Marker görünürlüğü elde edin.
getZIndex
getZIndex()
Parametreler: Yok
İade Değeri: İşaretçinin number|null|undefined zEndeksi.
Marker öğesinin zEndeksini alın. Bkz. MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parametreler:
  • animation: Animation optional Animasyonun oynatılacağı animasyon.
Return Değeri: Yok
Bir animasyon başlatın. Devam eden tüm animasyonlar iptal edilecek. Şu anda desteklenen animasyonlar: Animation.BOUNCE, Animation.DROP. null içinde başarılı olmak, animasyonun durmasına neden olur.
setClickable
setClickable(flag)
Parametreler:
  • flag: boolean true ise İşaretçi tıklanabilir.
Return Değeri: Yok
Marker öğesinin tıklanabilir olup olmadığını ayarlayın.
setCursor
setCursor([cursor])
Parametreler:
  • cursorstring optional Fare imleci türü.
Return Değeri: Yok
Fareyle üzerine gelindiğinde gösterilen fare imlecinin türünü ayarlayın.
setDraggable
setDraggable(flag)
Parametreler:
  • flag: boolean optional true ise işaretçi sürüklenebilir.
Return Değeri: Yok
Marker öğesinin sürüklenebilir olup olmadığını belirleyin.
setIcon
setIcon([icon])
Parametreler:
Return Değeri: Yok
Marker simgesini ayarlayın. Bkz. MarkerOptions.icon.
setLabel
setLabel([label])
Parametreler:
Return Değeri: Yok
Marker etiketini ayarlayın. Bkz. MarkerOptions.label.
setMap
setMap(map)
Parametreler:
Return Değeri: Yok
Belirtilen haritada veya panoramada Marker oluşturur. Harita null olarak ayarlanırsa işaretçi kaldırılır.
setOpacity
setOpacity([opacity])
Parametreler:
  • opacity: number optional 0,0, şeffaf ve 1,0, opak bir sayı.
Return Değeri: Yok
Marker seçeneğinin opaklığını ayarlayın.
setOptions
setOptions(options)
Parametreler:
Return Değeri: Yok
Marker ile ilgili seçenekleri belirleyin.
setPosition
setPosition([latlng])
Parametreler:
Return Değeri: Yok
Marker için konumu ayarlayın.
setShape
setShape([shape])
Parametreler:
Return Değeri: Yok
Etkileşim için kullanılan Marker değerini ayarlayın. MarkerOptions.shape ve MarkerShape hükümlerini inceleyin.
setTitle
setTitle([title])
Parametreler:
  • titlestring optional
Return Değeri: Yok
Marker ipucunun başlığını ayarlayın. Bkz. MarkerOptions.title.
setVisible
setVisible(visible)
Parametreler:
  • visibleboolean true ise İşaretçi görünür
Return Değeri: Yok
Marker öğesinin görünür olup olmadığını ayarlayın.
setZIndex
setZIndex([zIndex])
Parametreler:
  • zIndex: number optional
Return Değeri: Yok
Marker öğesinin zEndeksini ayarlayın. Bkz. MarkerOptions.zIndex.
Devralınan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
MAX_ZINDEX API'nin bir işaretçiye atayacağı maksimum varsayılan Z-endeksi. Önüne bir işaretçi 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 etkinleşir.
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 özellik değiştiğinde etkinleşir.
contextmenu
function(event)
Bağımsız değişkenler:
Bu etkinlik, Marker uygulamasında 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 etkinleşir.
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 mülk değiştiğinde değişir.
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
Marker sabit mülkü değiştiğinde bu etkinlik tetiklenir.
icon_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker simgesi özelliği değiştiğinde etkinleşir.
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 etkinlik, 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 konum özelliği değiştiğinde etkinleşir.
shape_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, Marker şekil özelliği değiştiğinde etkinleşir.
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, görünür Marker ö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 üzerinde sağ tıklama ile tetiklenir.

MarkerOptions arayüzü

google.maps.MarkerOptions arayüz

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

anchorPoint optional
Tür: Point optional
İşaretçinin konumundan sabit olarak açılan bir bilgi penceresinin ucuna olan uzaklık.
animation optional
Tür: Animation optional
Varsayılan: null
İşaretçi 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 sürüklerken işaretçinin altında görünen çapraz çizgiyi devre dışı bırakır.
cursor optional
Tür: string optional
Varsayılan: pointer
Fareyle üzerine gelindiğinde gösterilecek imleç 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 dize url olarak, Icon şeklinde değerlendirilir.
label optional
Tür: string|MarkerLabel optional
Varsayılan: null
İşaretçiye bir etiket ekler. İşaretleyici etiketi, bir işaretçinin içinde görünen harf veya sayıdır. Etiket bir dize veya MarkerLabel nesnesi olabilir. Sağlanır ve MarkerOptions.title sağlanmazsa, sağlanan metnin metniyle birlikte 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ı lütfen unutmayın.
map optional
Tür: Map|StreetViewPanorama optional
İşaretçinin gösterileceği harita. Harita, işaretçiyi göstermek için gereklidir ve işaret oluşturma aşamasında sağlanmazsa Marker.setMap ile sağlanabilir.
opacity optional
Tür: number optional
Varsayılan: 1,0
0,0, şeffaf ve 1,0, opak bir sayı.
optimized optional
Tür: boolean optional
Optimizasyon, tek bir statik öğe olarak çok sayıda işaretçi oluşturarak performansı iyileştirir. 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. Bir işaretçi oluşturulabilir, ancak konumu sağlanana kadar (örneğin, kullanıcının işlemleri veya seçenekleri) görüntülenmeyebilir. İşaretçi oluşturma sırasında belirtilmemişse 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 gelme metni. Sağlanması durumunda, sağlanan değerle birlikte bir erişilebilirlik metni (ör. ekran okuyucularla kullanım için) işaretçiye eklenir. title özelliğinin şu anda yalnızca optimize edilmemiş işaretçiler için erişilebilirlik metni amacıyla kullanıldığını lütfen unutmayın.
visible optional
Tür: boolean optional
Varsayılan: true
İşaret true ise işaretçi görünür olacaktır.
zIndex optional
Tür: number optional
Tüm işaretçiler, zIndex sırasıyla, daha yüksek değerler daha düşük değerlere sahip işaretçilerin önünde olacak şekilde gösterilir. Varsayılan olarak, işaretçiler ekrandaki dikey konumlarına göre görüntülenir. Alttaki işaretçiler ise ekranın daha üst kısmındaki işaretçilerin önünde görünür.

Ortak Çalışma sabitleri

google.maps.CollisionBehavior sabit değer

v=beta kullanılırken const {CollisionBehavior} = await google.map.importLibrary("marker") kullanılarak arama yapılabilir. Maps JavaScript API'deki kitaplıklar konusuna bakın.

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, zEndeksi daha yüksek olan işaretçi gösterilir. Aynı zDizin değerine sahiplerse dikey ekran konumu daha düşük olan dizin gösterilir.
REQUIRED İşaretlemeyi çarpışmadan bağımsız olarak her zaman görüntüleyin. Bu, varsayılan davranıştır.
REQUIRED_AND_HIDES_OPTIONAL Çarpıcı işareti ne olursa olsun, işaretçiyi her zaman göster ve işaretçi ile çakışan tüm OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçileri veya etiketleri gizle.

Simge arayüzü

google.maps.Icon arayüz

İşaretçi simgesi resmini temsil eden yapı.

url
Tür: string
Resmin veya model sayfasının URL'si.
anchor optional
Tür: Point optional
Haritadaki işaretleyicinin konumuyla ilişkili olarak bir resmin sabitleneceği konum. Varsayılan olarak, sabit resim resmin alt kısmının ortasında yer alır.
labelOrigin optional
Tür: Point optional
İşaretçi tarafından bir etiket sağlanmışsa, simge resminin sol üst köşesine göre etiketin kaynağı. Varsayılan olarak kaynak, resmin odak noktasında yer alır.
origin optional
Tür: Point optional
Varsa resmin imgedeki konumu. Varsayılan olarak kaynak, görüntünün (0, 0) sol üst köşesinde bulunur.
scaledSize optional
Tür: Size optional
Varsa ölçeklendirildikten sonra tüm resmin boyutu. Bir görüntüyü veya imgeyi genişletmek/küçültmek için bu özelliği kullanın.
size optional
Tür: Size optional
İmge veya resmin görüntü boyutu. İmgeleri kullanırken imge boyutunu belirtmeniz gerekir. Boyut sağlanmazsa, 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 karakterdir). Özel işaretçi ile birlikte kullanıyorsanız Icon sınıfındaki labelOrigin özelliğiyle yeniden konumlandırabilirsiniz.

text
Tür: string
Etikette görüntülenecek metin.
className optional
Tür: string optional
Varsayılan: '' (boş dize)
Etiketin 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 ailesi yalnızca MarkerLabel ürününün diğer özellikleri aracılığıyla ayarlanabilir. İşaretleme çakışmaları yönetimi de kullanıyorsanız CSS sınıfları, etiketin konumunu veya yönünü değiştirmek için 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üyle eşdeğerdir).
fontSize optional
Tür: string optional
Varsayılan: '14px'
Etiket metninin yazı tipi boyutu (CSS yazı tipi boyutu özelliğiyle 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 resminin tıklanabilir bölgesini tanımlar. Şekil, bir resmin şeffaf olmayan bölgesini tanımlayan iki özellik (type ve coord) oluşur.

coords
Tür: Array<number>
Bu özelliğin biçimi type öğesinin değerine bağlıdır ve http://www.w3.org/TR/REC-html40/stone/objects.html#adef-coords adresinde bulunan w3 ALAN coords spesifikasyonunu uygular.
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] şeklindedir. Burada x1,y2 çemberin merkezi, r ise dairenin yarıçapıdır.
- poly: Koordinatlar [x1,y1,x2,y2...xn,yn]. Her x,y çifti, çokgenin bir köşe noktasının koordinatlarını içerir.
- rect: Koordinatlar [x1,y1,x2,y2]. Kohortlar x1,y1, dikdörtgenin sol üst köşelerinin x2,y2, dikdörtgenin sağ alt 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

Stili olan bir vektör yolundan oluşan sembolü açıklar. Bir simge, simge 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 yol koordinatları, sırasıyla çapa işaretinin 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. Simge işaretçileri için varsayılan olarak "siyah" kullanılır. Ç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ğlanmışsa etiketin kaynağı ile göreli kaynak. Kaynak, simgenin 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çı (derece cinsinden saat cinsinden). IconSequence öğesindeki bir fixedRotation simgesi false, uzandığı kenarın açısına göre döndürülür.
scale optional
Tür: number optional
Sembolün ölçeklendirildiği miktar. Sembol işaretçileri için varsayılan olarak 1'dir; ölçeklendirmeden sonra simge herhangi bir boyutta olabilir. Bir çoklu çizgideki simgeler için varsayılan olarak çoklu çizginin fırça ağırlığı kullanılır. Ölçeklendirmeden sonra simgenin, merkezinde logonun çapasının merkezindeki 22 piksel boyutunda bir kare içinde yer almalı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. Simge işaretçileri için varsayılan olarak "siyah" kullanılır. Ç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 varsayılan olarak 1'dir. Bir çoklu çizgideki simgeler için varsayılan olarak bu çizginin fırça opaklığı ayarlanır.
strokeWeight optional
Tür: number optional
Varsayılan: Sembolün Symbol.scale.
Simgenin fırça ağırlığı.

SymbolPath sabit değerleri

google.maps.SymbolPath sabit değer

Yerleşik simge yolları.

v=beta kullanılırken const {SymbolPath} = await google.map.importLibrary("core") kullanılarak arama yapılabilir. Maps JavaScript API'deki kitaplıklar konusuna bakın.

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 İleriye dönük kapalı ok.
FORWARD_OPEN_ARROW İleriye dönük açık ok.

Animasyon sabitleri

google.maps.Animation sabit değer

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

v=beta kullanılırken const {Animation} = await google.map.importLibrary("marker") kullanılarak arama yapılabilir. Maps JavaScript API'deki kitaplıklar konusuna bakın.

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