İşaretçi sınıfı
google.maps.Marker
sınıf
Bu sınıfın süresi MVCObject tarihinde sona eriyor.
const {Marker} = await google.maps.importLibrary("marker") numaralı telefonu 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şturma sırasında 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
İade Değeri:
Animation|null|undefinedŞu anda çalıştırılan animasyonu alır. |
getClickable |
getClickable()Parametreler: Yok
Dönüş Değeri: İşaretçi tıklanabilirse
boolean Doğru.Marker öğesinin tıklanabilir durumunu alın. |
getCursor |
getCursor()Parametreler: Yok
İade Değeri:
string|null|undefinedFare imleciyle üzerine gelindiğinde gösterilen imleç türünü alır. |
getDraggable |
getDraggable()Parametreler: Yok
Dönüş Değeri:
boolean İşaretçi sürüklenebiliyorsa True (Doğru).Marker öğesinin sürüklenebilir durumunu alın. |
getIcon |
getIcon()Parametreler: Yok
Marker simgesini alın. Şu sayfaya göz atın: MarkerOptions.icon. |
getLabel |
getLabel()Parametreler: Yok
İade Değeri:
MarkerLabel|string|null|undefinedMarker etiketini alın. Şu sayfaya göz atın: MarkerOptions.label. |
getMap |
getMap()Parametreler: Yok
İade Değeri:
Map|StreetViewPanoramaMarker öğ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 opaklığını alın. |
getPosition |
getPosition()Parametreler: Yok
İade Değeri:
LatLng|null|undefinedMarker konumunu alın. |
getShape |
getShape()Parametreler: Yok
İade 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
İade Değeri:
string|null|undefinedMarker ipucunun başlığını alır. Şu sayfaya göz atın: MarkerOptions.title. |
getVisible |
getVisible()Parametreler: Yok
Dönüş Değeri: İşaretçi görünürse
boolean Doğru.Marker görünürlüğünü elde edin. |
getZIndex |
getZIndex()Parametreler: Yok
Döndürülen Değer:
number|null|undefined İşaretçinin zIndex'i.Marker öğesinin zIndex'ini 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 tüm animasyonlar iptal edilir. Şu anda desteklenen animasyonlar: Animation.BOUNCE, Animation.DROP. null iletildiğinde tüm animasyonlar durur. |
setClickable |
setClickable(flag)Parametreler:
Döndürülen Değer: Yok
Marker öğesinin tıklanabilir olup olmadığını ayarlayın. |
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 simge ayarlayın. Şu sayfaya göz atın: MarkerOptions.icon. |
setLabel |
setLabel([label])Parametreler:
Döndürülen Değer: Yok
Marker için etiketi ayarlayın. Şu sayfaya göz atın: MarkerOptions.label. |
setMap |
setMap(map)Parametreler:
Döndürülen Değer: Yok
Belirtilen haritada veya panoramada Marker simgesini 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'ini ayarlayın. Şu sayfaya göz atın: MarkerOptions.zIndex. |
Devralındı:
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 özellik değiştiğinde tetiklenir. |
contextmenu |
function(event)Bağımsız değişkenler:
Bu etkinlik, Marker üzerinde DOM contextmenu 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:
Bu etkinlik, kullanıcı Marker simgesini sürüklerken tekrar tekrar tetiklenir. |
dragend |
function(event)Bağımsız değişkenler:
Bu etkinlik, kullanıcı Marker simgesini sürüklemeyi bıraktığında tetiklenir. |
draggable_changed |
function()Bağımsız değişkenler: Yok
Bu etkinlik, Marker draggable özelliği değiştiğinde tetiklenir. |
dragstart |
function(event)Bağımsız değişkenler:
Bu etkinlik, kullanıcı Marker simgesini 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 mousedown için tetiklenir. |
mouseout |
function(event)Bağımsız değişkenler:
Bu etkinlik, fare Marker simgesinin alanından çıktığı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 mouseup için 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, Markertitle özelliği değiştiğinde tetiklenir. |
visible_changed |
function()Bağımsız değişkenler: Yok
Bu etkinlik, Marker visible ö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 üzerinde sağ tıklama yapıldığında tetiklenir. |
MarkerOptions arayüzü
google.maps.MarkerOptions
arayüz
Bir işaretçide ayarlanabilecek özellikleri tanımlamak için kullanılan MarkerOptions nesnesi.
Özellikler | |
|---|---|
anchorPoint optional |
Tür:
Point optionalİşaretçi konumundan, işaretçiyle tutturulmuş olarak açılan bir bilgi penceresinin ucuna olan uzaklık. |
animation optional |
Tür:
Animation optionalVarsayılan:
nullİşaretçi haritaya eklendiğinde hangi animasyonun oynatılacağı. |
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ışı ayarlayın. |
crossOnDrag optional |
Tür:
boolean optionalVarsayılan:
truefalse ise sürükleme sırasında işaretçinin altında görünen artı 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 ayarlarsanız clickable değeri false olarak ayarlanmış olsa bile işaretçi tıklanabilir hale gelir. |
icon optional |
Ön plan simgesi. Bir dize sağlanırsa dize, url olarak Icon ile birlikte sağlanmış gibi 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 bir dize veya MarkerLabel nesnesi olabilir. Sağlanırsa ve MarkerOptions.title sağlanmazsa, sağlanan etiketin metniyle birlikte işaretçiye erişilebilirlik metni (ör. ekran okuyucularla kullanım için) eklenir. label işaretinin şu anda yalnızca optimize edilmemiş işaretçiler için erişilebilirlik metni olarak kullanıldığını lütfen unutmayın. |
map optional |
Tür:
Map|StreetViewPanorama optionalİşaretçinin görüntüleneceği harita. İşaretçinin gösterilmesi için harita gereklidir ve işaretçi oluşturulurken sağlanmadıysa 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 özellik, ç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 optimizasyon, vektör haritalardaki işaretçiler için geçerli değildir. |
position optional |
Tür:
LatLng|LatLngLiteral optionalİşaretçi konumunu ayarlar. Bir işaretçi oluşturulabilir ancak konumu sağlanana kadar (ör. kullanıcının işlemleri veya seçimleri aracılığıyla) gösterilmeyebilir. İşaretçi oluşturma sırasında sağlanmadıysa Marker.setPosition ile işaretçi konumu 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 erişilebilirlik metni (ör. ekran okuyucularla kullanım için) belirtilen değerle birlikte işaretçiye eklenir. title işaretinin şu anda yalnızca optimize edilmemiş işaretçiler için erişilebilirlik metni olarak kullanıldığını lütfen 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, zIndex değerlerine göre haritada gösterilir. Daha yüksek değerler, daha düşük değerlere sahip işaretçilerin önünde gösterilir. İşaretçiler varsayılan olarak ekrandaki dikey konumlarına göre gösterilir. Daha aşağıda bulunan işaretçiler, ekranın daha üst kısmındaki işaretçilerin önünde görünür. |
CollisionBehavior sabitleri
google.maps.CollisionBehavior
sabitler
const {CollisionBehavior} = await google.maps.importLibrary("marker") numaralı telefonu 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 daha yüksek zIndex değerine sahip olan gösterilir. zIndex değerleri aynıysa 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ışma olup olmadığına bakılmaksızın işaretçiyi her zaman gösterin ve işaretçiyle çakışacak OPTIONAL_AND_HIDES_LOWER_PRIORITY işaretçilerini veya etiketlerini gizleyin. |
Simge arayüzü
google.maps.Icon
arayüz
İşaretçi simgesi resmini temsil eden bir yapı.
Özellikler | |
|---|---|
url |
Tür:
stringResmin veya model sayfası resminin URL'si. |
anchor optional |
Tür:
Point optionalBir görüntünün, haritadaki işaretçinin konumuna göre sabitleneceği yer. Varsayılan olarak, bağlantı noktası resmin alt kısmının orta noktasında bulunur. |
labelOrigin optional |
Tür:
Point optionalİşaretçi tarafından bir etiket sağlanıyorsa 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 optionalVarsa resmin imge içindeki konumu. Varsayılan olarak başlangıç noktası, resmin sol üst köşesinde bulunur (0, 0). |
scaledSize optional |
Tür:
Size optionalVarsa ölçeklendirmeden sonraki resmin tamamının boyutu. 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'ları kullanırken sprite 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ü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.
Özellikler | |
|---|---|
text |
Tür:
stringEtikette gösterilecek metin. |
className optional |
Tür:
string optionalVarsayılan:
'' (boş dize)Etiketin öğesinin className özelliği (öğenin class özelliğine eşdeğer). Aralarında boşluk bırakarak birden çok CSS sınıfı eklenebilir. Yazı tipi rengi, boyutu, ağırlığı ve ailesi yalnızca MarkerLabel öğesinin diğer ö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. çeviriler ve döndürmeler kullanılarak) kullanılmamalıdır. |
color optional |
Tür:
string optionalVarsayılan:
'black'Etiket metninin rengi. |
fontFamily optional |
Tür:
string optionalEtiket metninin yazı tipi ailesi (CSS font-family özelliğiyle eşdeğerdir). |
fontSize optional |
Tür:
string optionalVarsayılan:
'14px'Etiket metninin yazı tipi boyutu (CSS font-size özelliğiyle eşdeğerdir). |
fontWeight optional |
Tür:
string optionalEtiket metninin yazı tipi ağırlığı (CSS font-weight özelliğiyle eşdeğerdir). |
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ı olarak aşağıdaki şekilde belirlenir: - circle: coords, [x1,y1,r] olur. Burada x1,y2, çemberin merkezinin koordinatları, r ise çemberin yarıçapıdır. - poly: coords, [x1,y1,x2,y2...xn,yn] değeridir. Burada her x,y çifti çokgenin bir köşesinin koordinatlarını içerir. - rect: coords, [x1,y1,x2,y2] değeridir. 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 sembolü açıklar. Bir simge, işaretçinin simgesi olarak kullanılabilir veya çoklu çizgiye yerleştirilebilir.
Özellikler | |
|---|---|
path |
Tür:
SymbolPath|stringSembolün yolu (yerleşik bir 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şaretleyiciye veya çoklu çizgiye göre konumu. Sembolün yolunun koordinatları, sırasıyla bağlantı noktasının x ve y koordinatları tarafından sola ve yukarı doğru çevrilir. Konum, sembolün yoluyla 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 varsayılan değer "siyah"tır. Çoklu çizgilerdeki semboller için bu, varsayılan olarak ilgili çoklu çizginin kontur 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 etiketin yolun başlangıcına göre başlangıcı. Başlangıç noktası, sembolün yoluyla 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). IconSequence içindeki bir sembol. Burada fixedRotation, bulunduğu kenarın açısına göre döndürülmüş false'dir. |
scale optional |
Tür:
number optionalSembolün boyutunun ölçeklendiği miktar. Sembol işaretçiler için varsayılan değer 1'dir. Ölçeklendirmeden sonra sembol herhangi bir boyutta olabilir. Çoklu çizgi üzerindeki semboller için bu değer, çoklu çizginin kontur kalınlığı olarak ayarlanır. Ölçeklendirmeden sonra sembol, sembolün tutturma noktasında ortalanmış 22 piksellik bir karenin içinde yer almalı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 varsayılan değer "siyah"tır. Çoklu çizgi üzerindeki semboller için varsayılan olarak çoklu çizginin kontur rengi kullanılır. |
strokeOpacity optional |
Tür:
number optionalSembolün kontur opaklığı. Simge işaretçiler için varsayılan değer 1'dir. Çoklu çizgi üzerindeki semboller için bu değer, çoklu çizginin kontur opaklığı olarak ayarlanır. |
strokeWeight optional |
Tür:
number optionalVarsayılan: Sembolün
Symbol.scale.Sembolün çizgi kalınlığı. |
SymbolPath constants
google.maps.SymbolPath
sabitler
Yerleşik sembol yolları.
const {SymbolPath} = await google.maps.importLibrary("core") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Sabitler | |
|---|---|
BACKWARD_CLOSED_ARROW |
Geriye doğru işaret eden kapalı bir ok. |
BACKWARD_OPEN_ARROW |
Geriye doğru işaret eden açık bir ok. |
CIRCLE |
Daire |
FORWARD_CLOSED_ARROW |
İleri doğru işaret eden kapalı bir ok. |
FORWARD_OPEN_ARROW |
İleriye doğru açık bir ok. |
Animasyon sabitleri
google.maps.Animation
sabitler
İşaretçide oynatılabilen animasyonlar. Animasyonu oynatmak için İşaretleyici'de Marker.setAnimation yöntemini veya MarkerOptions.animation seçeneğini kullanın.
const {Animation} = await google.maps.importLibrary("marker") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Sabitler | |
|---|---|
BOUNCE |
İşaretçi, Marker.setAnimation ile null ç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 simgesi null olarak değişir. Bu tür animasyonlar genellikle işaretçi oluşturulurken belirtilir. |