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.
Marka | |
|---|---|
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. |
Sabitler | |
|---|---|
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. |
Yöntemler | |
|---|---|
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|undefinedFareyle ü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
Marker simgesini alın. Şu sayfaya göz atın: MarkerOptions.icon. |
getLabel |
getLabel()Parametreler: Yok
Dönüş Değeri:
MarkerLabel|string|null|undefinedMarker etiketini alın. Şu sayfaya göz atın: MarkerOptions.label. |
getMap |
getMap()Parametreler: Yok
Dönüş Değeri:
Map|StreetViewPanorama|nullMarker öğ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|undefinedMarker öğesinin konumunu alın. |
getShape |
getShape()Parametreler: Yok
Dönüş Değeri:
MarkerShape|null|undefinedEtkileş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|undefinedMarker 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:
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:
Döndürülen değer: Yok
Marker öğesinin tıklanabilir olup olmadığını belirleyin. |
setCursor |
setCursor([cursor])Parametreler:
Döndürülen değer: Yok
Fareyle üzerine gelindiğinde gösterilen fare imleci türünü ayarlayın. |
setDraggable |
setDraggable(flag)Parametreler:
Döndürülen değer: Yok
Marker öğesinin sürüklenebilir olup olmadığını ayarlayın. |
setIcon |
setIcon([icon])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:
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:
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:
Döndürülen değer: Yok
Marker öğesinin görünür olup olmayacağını ayarlayın. |
setZIndex |
setZIndex([zIndex])Parametreler:
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
| |
Etkinlikler | |
|---|---|
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. |
|
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.
Özellikler | |
|---|---|
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 optionalVarsayılan:
nullHaritaya işaretçi eklendiğinde oynatılacak animasyon. |
clickable optional |
Tür:
boolean optionalVarsayılan:
truetrue ise işaretçi, fare ve dokunma etkinliklerini alır. |
|
Tür:
string|CollisionBehavior optionalVarsayılan:
nullVektör haritalardaki işaretçiler için çakışma davranışı ayarlama |
crossOnDrag optional |
Tür:
boolean optionalVarsayılan:
truefalse 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 optionalVarsayılan:
pointerFareyle üzerine gelindiğinde gösterilecek fare imleci türü. |
draggable optional |
Tür:
boolean optionalVarsayılan:
falsetrue 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 |
Ön plan simgesi. Dize sağlanırsa dize url olacak şekilde Icon olarak değerlendirilir. |
label optional |
Tür:
string|MarkerLabel optionalVarsayı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 optionalVarsayılan: 1.0
0,0 (şeffaf) ile 1,0 (opak) arasında bir sayı. |
optimized optional |
Tür:
boolean optionalOptimizasyon, 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 optionalSürükleme/tıklama için kullanılan resim haritası bölge tanımı. |
title optional |
Tür:
string optionalVarsayılan:
undefinedFareyle ü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 optionalVarsayılan:
truetrue ise işaretçi görünür. |
zIndex optional |
Tür:
number optionalTü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.
Sabitler | |
|---|---|
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ı.
Özellikler | |
|---|---|
url |
Tür:
stringResmin veya model sayfasının URL'si. |
anchor optional |
Tür:
Point optionalHaritadaki 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 optionalResmin 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 optionalSprite'ı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.
Özellikler | |
|---|---|
text |
Tür:
stringEtikette gösterilecek metin. |
className optional |
Tür:
string optionalVarsayı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 optionalVarsayılan:
'black'Etiket metninin rengi. |
fontFamily optional |
Tür:
string optionalEtiket metninin yazı tipi ailesi (CSS font-family mülküne eşdeğer). |
fontSize optional |
Tür:
string optionalVarsayılan:
'14px'Etiket metninin yazı tipi boyutu (CSS font-size özelliğine eşdeğer). |
fontWeight optional |
Tür:
string optionalEtiket 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.
Özellikler | |
|---|---|
type |
Tür:
stringŞeklin türünü açıklar ve circle, poly veya rect olabilir. |
coords optional |
Tür:
Array<number> optionalBu ö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.
Özellikler | |
|---|---|
path |
Tür:
SymbolPath|stringYerleş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 optionalVarsayı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 optionalSembolü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 optionalVarsayılan:
0Sembolün dolgu opaklığı. |
labelOrigin optional |
Tür:
Point optionalVarsayı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 optionalVarsayılan:
0Sembolü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 optionalSembolü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 optionalSembolü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 optionalSembolü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 optionalVarsayı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.
Sabitler | |
|---|---|
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.
Sabitler | |
|---|---|
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. |