Marker sınıfı
google.maps.Marker
sınıfı
MVCObject
kitaplığını "marker"genişletir
const {Marker} = await google.maps.importLibrary("marker");
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: İşaretçinin
number|null|undefined 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
isteğe bağlı |
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
isteğe bağlı |
Tür:
Animation optionalVarsayılan:
nullHaritaya işaretçi eklendiğinde oynatılacak animasyon. |
clickable
isteğe bağlı |
Tür:
boolean optionalVarsayılan:
truetrue ise işaretçi, fare ve dokunma etkinliklerini alır. |
isteğe bağlı |
Tür:
string|CollisionBehavior optionalVarsayılan:
nullVektör haritalardaki işaretçiler için çakışma davranışı ayarlama |
crossOnDrag
isteğe bağlı |
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
isteğe bağlı |
Tür:
string optionalVarsayılan:
pointerFareyle üzerine gelindiğinde gösterilecek fare imleci türü. |
draggable
isteğe bağlı |
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
isteğe bağlı |
Ön plan simgesi. Dize sağlanırsa dize url olacak şekilde Icon olarak değerlendirilir. |
label
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
Tür:
number optionalVarsayılan: 1.0
0,0 (şeffaf) ile 1,0 (opak) arasında bir sayı. |
optimized
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
Tür:
MarkerShape optionalSürükleme/tıklama için kullanılan resim haritası bölge tanımı. |
title
isteğe bağlı |
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
isteğe bağlı |
Tür:
boolean optionalVarsayılan:
truetrue ise işaretçi görünür. |
zIndex
isteğe bağlı |
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
sabitleri
kitaplığı "marker"
Bu sabitler dize olarak da kullanılabilir. TypeScript'te dize sabit değerleri CollisionBehaviorString türüyle tanımlanır.
const {CollisionBehavior} = await google.maps.importLibrary("marker");
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
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
Tür:
Point optionalResmin bir sprite içindeki konumu (varsa). Varsayılan olarak başlangıç noktası, resmin sol üst köşesindedir (0, 0). |
scaledSize
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
Tür:
string optionalVarsayılan:
'black'Etiket metninin rengi. |
fontFamily
isteğe bağlı |
Tür:
string optionalEtiket metninin yazı tipi ailesi (CSS font-family mülküne eşdeğer). |
fontSize
isteğe bağlı |
Tür:
string optionalVarsayılan:
'14px'Etiket metninin yazı tipi boyutu (CSS font-size özelliğine eşdeğer). |
fontWeight
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
Tür:
number optionalVarsayılan:
0Sembolün dolgu opaklığı. |
labelOrigin
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
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
isteğe bağlı |
Tür:
number optionalVarsayılan: Sembolün
Symbol.scale.Sembolün çizgi kalınlığı. |
SymbolPath sabitleri
google.maps.SymbolPath
sabitleri
kitaplığı "core"
Yerleşik sembol yolları.
const {SymbolPath} = await google.maps.importLibrary("core");
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
sabitleri
kitaplığı "marker"
İş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");
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. |