Data

Veri sınıfı

google.maps.Data sınıf

Coğrafi verileri görüntülemek için kullanılan bir katman. Noktalar, çizgi dizileri ve poligonlar görüntülenebilir.

Her Map varsayılan olarak bir Data nesnesine sahiptir. Bu nedenle, çoğu zaman bir nesne oluşturmaya gerek yoktur. Örneğin: 

 var myMap = new google.maps.Map(...);
 myMap.data.addGeoJson(...);
 myMap.data.setStyle(...);
Data nesnesi, Features koleksiyonudur.

Bu sınıfın süresi MVCObject tarihinde sona eriyor.

const {Data} = await google.maps.importLibrary("maps") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Data
Data([options])
Parametreler: 
Belirtilen DataOptions ile boş bir koleksiyon oluşturur.
add
add([feature])
Parametreler: 
İade Değeri:  Data.Feature
Koleksiyona bir özellik ekler ve eklenen özelliği döndürür.

Özelliğin kimliği varsa koleksiyondaki aynı kimliğe sahip mevcut özelliklerin yerini alır. Özellik verilmezse boş geometriye sahip ve özelliği olmayan yeni bir özellik oluşturulur. FeatureOptions değerleri verilirse belirtilen özelliklere sahip yeni bir öğe oluşturulur.

1234 ve '1234' kimliklerinin eşdeğer olduğunu unutmayın. 1234 kimlikli bir özellik eklemek, '1234' kimlikli bir özelliği değiştirir ve bunun tersi de geçerlidir.
addGeoJson
addGeoJson(geoJson[, options])
Parametreler: 
İade Değeri:  Array<Data.Feature>
Koleksiyona GeoJSON özellikleri ekler. Bu yönteme ayrıştırılmış bir JSON verin. İçe aktarılan özellikler döndürülür. GeoJSON içe aktarılamazsa istisna oluşturur.
contains
contains(feature)
Parametreler: 
İade Değeri:  boolean
Belirtilen özelliğin koleksiyonda olup olmadığını kontrol eder.
forEach
forEach(callback)
Parametreler: 
Döndürülen Değer: Yok
Belirtilen işlevi tekrar tekrar çağırır ve her çağrıda koleksiyondaki bir özelliği işleve geçirir. Özellikler arasında yineleme sırası tanımlanmamıştır.
getControlPosition
getControlPosition()
Parametreler: Yok
İade Değeri:  ControlPosition
Çizim kontrollerinin haritadaki konumunu döndürür.
getControls
getControls()
Parametreler: Yok
İade Değeri:  Array<string>
Kullanıcının seçebileceği çizim modlarını, gösterildikleri sırayla döndürür. Varsayılan olarak eklenen null çizim modu bu kapsamda değildir. Olası çizim modları "Point", "LineString" veya "Polygon"'dir.
getDrawingMode
getDrawingMode()
Parametreler: Yok
İade Değeri:  string|null
Belirtilen veri katmanının geçerli çizim modunu döndürür. null çizim modu, kullanıcının haritayla normal şekilde etkileşim kurabileceği ve tıklamaların herhangi bir şey çizmeyeceği anlamına gelir. Olası çizim modları null, "Point", "LineString" veya "Polygon"'dir.
getFeatureById
getFeatureById(id)
Parametreler: 
  • id:  number|string
İade Değeri:  Data.Feature|undefined
Koleksiyonda varsa belirtilen kimliğe sahip özelliği döndürür. Aksi takdirde undefined değerini döndürür.

1234 ve '1234' kimliklerinin eşdeğer olduğunu unutmayın. Aynı özelliği aramak için her ikisi de kullanılabilir.
getMap
getMap()
Parametreler: Yok
İade Değeri:  Map
Özelliklerin gösterildiği haritayı döndürür.
getStyle
getStyle()
Parametreler: Yok
İade Değeri:  Data.StylingFunction|Data.StyleOptions
Koleksiyondaki tüm özelliklerin stilini alır.
loadGeoJson
loadGeoJson(url[, options, callback])
Parametreler: 
Döndürülen Değer: Yok
Bir URL'den GeoJSON yükler ve özellikleri koleksiyona ekler.

NOT: GeoJSON, XHR kullanılarak getirilir ve alanlar arası çalışmayabilir. Sorun yaşıyorsanız GeoJSON'u tercih ettiğiniz AJAX kitaplığını kullanarak getirmenizi ve ardından addGeoJson() işlevini çağırmanızı öneririz.
overrideStyle
overrideStyle(feature, style)
Parametreler: 
Döndürülen Değer: Yok
Bir özelliğin stilini değiştirir. Bu değişiklikler, setStyle() tarafından belirtilen stilin üzerine uygulanır. null olarak ayarlanan stil özellikleri, setStyle() ile belirtilen değere geri döner.
remove
remove(feature)
Parametreler: 
Döndürülen Değer: Yok
Koleksiyondan bir özelliği kaldırır.
revertStyle
revertStyle([feature])
Parametreler: 
Döndürülen Değer: Yok
Önceki overrideStyle() aramalarının etkisini kaldırır. Belirtilen özelliğin stili, setStyle() tarafından belirtilen stile geri döner.

Özellik belirtilmezse tüm özelliklerin stili geri döndürülür.
setControlPosition
setControlPosition(controlPosition)
Parametreler: 
Döndürülen Değer: Yok
Çizim kontrollerinin haritadaki konumunu ayarlar.
setControls
setControls(controls)
Parametreler: 
  • controls:  Array<string>
Döndürülen Değer: Yok
Kullanıcının seçebileceği çizim modlarını, gösterildikleri sırayla ayarlar. Varsayılan olarak eklenen null çizim modu bu kapsamda değildir. null ise çizim kontrolleri devre dışı bırakılır ve gösterilmez. Olası çizim modları "Point", "LineString" veya "Polygon"'dir.
setDrawingMode
setDrawingMode(drawingMode)
Parametreler: 
  • drawingMode:  string optional
Döndürülen Değer: Yok
Belirtilen veri katmanının geçerli çizim modunu ayarlar. null çizim modu, kullanıcının haritayla normal şekilde etkileşim kurabileceği ve tıklamaların herhangi bir şey çizmeyeceği anlamına gelir. Olası çizim modları null, "Point", "LineString" veya "Polygon"'dir.
setMap
setMap(map)
Parametreler: 
Döndürülen Değer: Yok
Belirtilen haritadaki özellikleri oluşturur. Harita null olarak ayarlanırsa özellikler haritadan kaldırılır.
setStyle
setStyle(style)
Parametreler: 
Döndürülen Değer: Yok
Koleksiyondaki tüm özelliklerin stilini ayarlar. overrideStyle() aracılığıyla özellik bazında belirtilen stiller uygulanmaya devam eder.

İstediğiniz stil seçeneklerini içeren bir nesne veya her özelliğin stilini hesaplayan bir işlev iletin. İşlev, bir özelliğin özellikleri her güncellendiğinde çağrılır.
toGeoJson
toGeoJson(callback)
Parametreler: 
  • callback:  function(Object): void
Döndürülen Değer: Yok
Koleksiyondaki özellikleri bir GeoJSON nesnesine aktarır.
Devralındı: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
addfeature
function(event)
Bağımsız değişkenler: 
Bu etkinlik, koleksiyona bir özellik eklendiğinde tetiklenir.
click
function(event)
Bağımsız değişkenler: 
Bu etkinlik, geometrinin tıklanmasıyla tetiklenir.
contextmenu
function(event)
Bağımsız değişkenler: 
Bu etkinlik, DOM contextmenu etkinliği geometride tetiklendiğinde tetiklenir.
dblclick
function(event)
Bağımsız değişkenler: 
Bu etkinlik, geometri üzerinde çift tıklama yapıldığında tetiklenir.
mousedown
function(event)
Bağımsız değişkenler: 
Bu etkinlik, geometrideki bir mousedown için tetiklenir.
mouseout
function(event)
Bağımsız değişkenler: 
Bu etkinlik, fare geometrinin alanından çıktığında tetiklenir.
mouseover
function(event)
Bağımsız değişkenler: 
Bu etkinlik, fare geometrinin alanına girdiğinde tetiklenir.
mouseup
function(event)
Bağımsız değişkenler: 
Bu etkinlik, geometrideki bir mouseup için tetiklenir.
removefeature
function(event)
Bağımsız değişkenler: 
Bu etkinlik, bir özellik koleksiyondan kaldırıldığında tetiklenir.
removeproperty
function(event)
Bağımsız değişkenler: 
Bu etkinlik, bir özelliğin mülkü kaldırıldığında tetiklenir.
setgeometry
function(event)
Bağımsız değişkenler: 
Bu etkinlik, bir özelliğin geometrisi ayarlandığında tetiklenir.
setproperty
function(event)
Bağımsız değişkenler: 
Bu etkinlik, bir özelliğin mülkü ayarlandığında tetiklenir.
rightclick
function(event)
Bağımsız değişkenler: 
Bu etkinlik, geometride sağ tıklama yapıldığında tetiklenir.

Data.DataOptions arayüzü

google.maps.Data.DataOptions arayüz

Geliştiricinin bir Data nesnesinde ayarlayabileceği özellikleri tanımlamak için kullanılan DataOptions nesnesi.
map
Tür:  Map
Koleksiyondaki özelliklerin gösterileceği harita.
controlPosition optional
Tür:  ControlPosition optional
Varsayılan: ControlPosition.TOP_LEFT
Çizim kontrollerinin haritadaki konumu.
controls optional
Tür:  Array<string> optional
Varsayılan: null
Kullanıcının seçebileceği çizim modlarını, gösterildikleri sırayla açıklar. Varsayılan olarak eklenen null çizim modu bu kapsamda değildir. null ise çizim kontrolleri devre dışı bırakılır ve gösterilmez. Olası çizim modları "Point", "LineString" veya "Polygon"'dir.
drawingMode optional
Tür:  string optional
Varsayılan: null
Belirli veri katmanının mevcut çizim modu. null çizim modu, kullanıcının haritayla normal şekilde etkileşim kurabileceği ve tıklamaların herhangi bir şey çizmeyeceği anlamına gelir. Olası çizim modları null, "Point", "LineString" veya "Polygon"'dir.
featureFactory optional
Tür:  function(Data.Geometry): Data.Feature optional
Çizim etkinleştirildiğinde ve bir kullanıcı Geometri (Nokta, Çizgi Dizisi veya Poligon) çizdiğinde bu işlev, söz konusu Geometri ile çağrılır ve veri katmanına eklenecek bir Özellik döndürmelidir. Bir featureFactory sağlanmazsa bunun yerine kimliği ve özellikleri olmayan bir Feature oluşturulur. Varsayılan olarak null değerine ayarlanır.
style optional
Koleksiyondaki tüm özelliklerin stili. Daha fazla bilgi için yukarıdaki setStyle() yöntemine bakın.

Data.GeoJsonOptions arayüzü

google.maps.Data.GeoJsonOptions arayüz

GeoJSON'u içe aktarmak için isteğe bağlı parametreler.
idPropertyName optional
Tür:  string optional
Özellik kimliği olarak kullanılacak Özellik mülkünün adı. Belirtilmezse GeoJSON özelliği kimliği kullanılır.

Data.StyleOptions arayüzü

google.maps.Data.StyleOptions arayüz

Bu seçenekler, bir öğenin haritada gösterildiğinde nasıl görüneceğini belirtir.
animation optional
Tür:  Animation optional
İşaretçi haritaya eklendiğinde oynatılacak animasyon. Yalnızca nokta geometrileri için geçerlidir.
clickable optional
Tür:  boolean optional
Varsayılan: true
true ise işaretçi, fare ve dokunma etkinliklerini alır.
cursor optional
Tür:  string optional
Fareyle üzerine gelindiğinde gösterilecek fare imleci. Yalnızca nokta geometrileri için geçerlidir.
draggable optional
Tür:  boolean optional
Varsayılan: false
Bu özellik true değerine ayarlanmışsa nesne harita üzerinde sürüklenebilir ve temel alınan özelliğin geometrisi güncellenir.
editable optional
Tür:  boolean optional
Varsayılan: false
Bu özellik true değerine ayarlanmışsa nesne, kontrol noktaları sürüklenerek düzenlenebilir ve temel alınan özelliğin geometrisi güncellenir. Yalnızca LineString ve Polygon geometrileri için geçerlidir.
fillColor optional
Tür:  string optional
Dolgu rengi. Genişletilmiş adlandırılmış renkler hariç tüm CSS3 renkleri desteklenir. Yalnızca çokgen geometrileri için geçerlidir.
fillOpacity optional
Tür:  number optional
0,0 ile 1,0 arasında dolgu opaklığı. Yalnızca çokgen geometrileri için geçerlidir.
icon optional
Tür:  string|Icon|Symbol optional
Ön plan simgesi. Bir dize sağlanırsa dize, url olarak Icon ile birlikte sağlanmış gibi değerlendirilir. Yalnızca nokta geometrileri için geçerlidir.
icons optional
Tür:  Array<IconSequence> optional
Çoklu çizgi boyunca oluşturulacak simgeler. Yalnızca çizgi geometrileri için geçerlidir.
label optional
Tür:  string|MarkerLabel optional
İşaretçiye etiket ekler. Etiket bir dize veya MarkerLabel nesnesi olabilir. Yalnızca nokta geometrileri için geçerlidir.
opacity optional
Tür:  number optional
İşaretçinin 0,0 ile 1,0 arasındaki opaklığı. Yalnızca nokta geometrileri için geçerlidir.
shape optional
Tür:  MarkerShape optional
İsabet algılama için kullanılan resim haritasını tanımlar. Yalnızca nokta geometrileri için geçerlidir.
strokeColor optional
Tür:  string optional
Çizgi rengi. Genişletilmiş adlandırılmış renkler hariç tüm CSS3 renkleri desteklenir. Yalnızca çizgi ve poligon geometrileri için geçerlidir.
strokeOpacity optional
Tür:  number optional
Kontur opaklığı 0,0 ile 1,0 arasında olmalıdır. Yalnızca çizgi ve poligon geometrileri için geçerlidir.
strokeWeight optional
Tür:  number optional
Kontur genişliği (piksel cinsinden). Yalnızca çizgi ve poligon geometrileri için geçerlidir.
title optional
Tür:  string optional
Fareyle üzerine gelindiğinde gösterilen metin. Yalnızca nokta geometrileri için geçerlidir.
visible optional
Tür:  boolean optional
Varsayılan: true
Özelliğin görünür olup olmadığı.
zIndex optional
Tür:  number optional
Tüm özellikler, zIndex değerlerine göre haritada gösterilir. Daha yüksek değerler, daha düşük değerlere sahip özelliklerin önünde gösterilir. İşaretçiler her zaman çizgi dizilerinin ve poligonların önünde gösterilir.

Data.StylingFunction typedef

google.maps.Data.StylingFunction typedef

Bir özelliğin görünümünü hesaplayan işlev.

Data.setStyle() yöntemi, stil işlevini kabul edebilir. Özelliklerin, özelliklerine bağlı olarak farklı görünmesi gerektiğinde bu işlevi kullanın. Stil özellikleriyle ilgili daha fazla bilgiyi Geliştirici Kılavuzu'nda bulabilirsiniz.

function(Data.Feature): Data.StyleOptions

Data.Feature class

google.maps.Data.Feature sınıf

Bir detayın geometrisi, kimliği ve bir dizi özelliği vardır.

const {Data} = await google.maps.importLibrary("maps") numaralı telefonu arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.
Data.Feature
Data.Feature([options])
Parametreler: 
Belirtilen seçeneklerle bir özellik oluşturur.
forEachProperty
forEachProperty(callback)
Parametreler: 
  • callback:  function(*, string): void
Döndürülen Değer: Yok
Belirtilen işlevi tekrar tekrar çağırarak her çağırmada bir özellik değeri ve adı iletir. Özellikler arasında yineleme sırası tanımlanmamıştır.
getGeometry
getGeometry()
Parametreler: Yok
İade Değeri:  Data.Geometry
Özelliğin geometrisini döndürür.
getId
getId()
Parametreler: Yok
İade Değeri:  number|string|undefined
Özellik kimliğini döndürür.
getProperty
getProperty(name)
Parametreler: 
  • name:  string
İade Değeri:  *
İstenen özelliğin değerini veya özellik yoksa undefined değerini döndürür.
removeProperty
removeProperty(name)
Parametreler: 
  • name:  string
Döndürülen Değer: Yok
Belirtilen ada sahip mülkü kaldırır.
setGeometry
setGeometry(newGeometry)
Parametreler: 
Döndürülen Değer: Yok
Özelliğin geometrisini ayarlar.
setProperty
setProperty(name, newValue)
Parametreler: 
  • name:  string
  • newValue:  *
Döndürülen Değer: Yok
Belirtilen özelliğin değerini ayarlar. newValue, undefined ise bu, removeProperty'ı çağırmaya eş değerdir.
toGeoJson
toGeoJson(callback)
Parametreler: 
  • callback:  function(Object): void
Döndürülen Değer: Yok
Özelliği GeoJSON nesnesine aktarır.
removeproperty
function(event)
Bağımsız değişkenler: 
Bu etkinlik, bir özelliğin mülkü kaldırıldığında tetiklenir.