Data

Data class

Class google.maps.Data

Lapisan untuk menampilkan data geospasial. Titik, line-string, dan poligon dapat ditampilkan.

Setiap Map memiliki objek Data secara default, sehingga sebagian besar waktu tidak perlu membuat objek. Contoh: 

 var myMap = new google.maps.Map(...);
 myMap.data.addGeoJson(...);
 myMap.data.setStyle(...);
Objek Data adalah kumpulan Features.

Class ini memperluas MVCObject.

Akses dengan memanggil const {Data} = await google.maps.importLibrary("maps").
Lihat Library di Maps JavaScript API.
Data
Data([options])
Parameter: 
Membuat koleksi kosong, dengan DataOptions yang ditentukan.
add
add([feature])
Parameter: 
Nilai yang Ditampilkan:  Data.Feature
Menambahkan fitur ke koleksi, dan menampilkan fitur yang ditambahkan.

Jika fitur memiliki ID, fitur tersebut akan menggantikan fitur yang ada dalam koleksi dengan ID yang sama. Jika tidak ada fitur yang diberikan, fitur baru akan dibuat dengan geometri null dan tanpa properti. Jika FeatureOptions diberikan, fitur baru akan dibuat dengan properti yang ditentukan.

Perhatikan bahwa ID 1234 dan '1234' setara. Menambahkan fitur dengan ID 1234 akan menggantikan fitur dengan ID '1234', dan sebaliknya.
addGeoJson
addGeoJson(geoJson[, options])
Parameter: 
Nilai yang Ditampilkan:  Array<Data.Feature>
Menambahkan fitur GeoJSON ke koleksi. Berikan JSON yang diuraikan ke metode ini. Fitur yang diimpor akan ditampilkan. Menampilkan pengecualian jika GeoJSON tidak dapat diimpor.
contains
contains(feature)
Parameter: 
Nilai yang Ditampilkan:  boolean
Memeriksa apakah fitur yang diberikan ada dalam koleksi.
forEach
forEach(callback)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Berulang kali memanggil fungsi yang diberikan, meneruskan fitur dalam koleksi ke fungsi pada setiap pemanggilan. Urutan iterasi melalui fitur tidak ditentukan.
getControlPosition
getControlPosition()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  ControlPosition
Menampilkan posisi kontrol gambar di peta.
getControls
getControls()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Array<string>
Menampilkan mode gambar yang tersedia untuk dipilih pengguna, dalam urutan yang ditampilkan. Hal ini tidak mencakup mode gambar null, yang ditambahkan secara default. Kemungkinan mode menggambar adalah "Point", "LineString", atau "Polygon".
getDrawingMode
getDrawingMode()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  string|null
Menampilkan mode gambar saat ini dari Lapisan data yang diberikan. Mode gambar null berarti pengguna dapat berinteraksi dengan peta seperti biasa, dan klik tidak akan menggambar apa pun. Kemungkinan mode gambar adalah null, "Point", "LineString", atau "Polygon".
getFeatureById
getFeatureById(id)
Parameter: 
  • id:  number|string
Nilai yang Ditampilkan:  Data.Feature|undefined
Menampilkan fitur dengan ID yang diberikan, jika ada dalam koleksi. Jika tidak, akan menampilkan undefined.

Perhatikan bahwa ID 1234 dan '1234' setara. Keduanya dapat digunakan untuk mencari fitur yang sama.
getMap
getMap()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Map
Menampilkan peta tempat fitur ditampilkan.
getStyle
getStyle()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Data.StylingFunction|Data.StyleOptions
Mendapatkan gaya untuk semua fitur dalam koleksi.
loadGeoJson
loadGeoJson(url[, options, callback])
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Memuat GeoJSON dari URL, dan menambahkan fitur ke koleksi.

CATATAN: GeoJSON diambil menggunakan XHR, dan mungkin tidak berfungsi lintas domain. Jika Anda mengalami masalah, sebaiknya ambil GeoJSON menggunakan library AJAX pilihan Anda, lalu panggil addGeoJson().
overrideStyle
overrideStyle(feature, style)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Mengubah gaya fitur. Perubahan ini diterapkan di atas gaya yang ditentukan oleh setStyle(). Properti gaya yang disetel ke null akan dikembalikan ke nilai yang ditentukan melalui setStyle().
remove
remove(feature)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Menghapus fitur dari koleksi.
revertStyle
revertStyle([feature])
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Menghapus efek panggilan overrideStyle() sebelumnya. Gaya fitur yang diberikan akan dikembalikan ke gaya yang ditentukan oleh setStyle().

Jika tidak ada fitur yang diberikan, semua fitur akan dikembalikan ke gaya aslinya.
setControlPosition
setControlPosition(controlPosition)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan posisi kontrol gambar pada peta.
setControls
setControls(controls)
Parameter: 
  • controls:  Array<string>
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan mode gambar yang tersedia untuk dipilih pengguna, dalam urutan yang ditampilkan. Ini tidak boleh menyertakan mode gambar null, yang ditambahkan secara default. Jika null, kontrol gambar dinonaktifkan dan tidak ditampilkan. Kemungkinan mode menggambar adalah "Point", "LineString", atau "Polygon".
setDrawingMode
setDrawingMode(drawingMode)
Parameter: 
  • drawingMode:  string optional
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan mode gambar saat ini dari Lapisan data yang diberikan. Mode gambar null berarti pengguna dapat berinteraksi dengan peta seperti biasa, dan klik tidak akan menggambar apa pun. Kemungkinan mode gambar adalah null, "Point", "LineString", atau "Polygon".
setMap
setMap(map)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Merender fitur pada peta yang ditentukan. Jika peta disetel ke null, fitur akan dihapus dari peta.
setStyle
setStyle(style)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan gaya untuk semua fitur dalam koleksi. Gaya yang ditentukan per fitur melalui overrideStyle() akan terus diterapkan.

Teruskan objek dengan opsi gaya yang diinginkan, atau fungsi yang menghitung gaya untuk setiap fitur. Fungsi ini akan dipanggil setiap kali properti fitur diperbarui.
toGeoJson
toGeoJson(callback)
Parameter: 
  • callback:  function(Object): void
Nilai yang Ditampilkan:  Tidak Ada
Mengekspor fitur dalam koleksi ke objek GeoJSON.
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
addfeature
function(event)
Argumen: 
Peristiwa ini dipicu saat fitur ditambahkan ke koleksi.
click
function(event)
Argumen: 
Peristiwa ini diaktifkan untuk klik pada geometri.
contextmenu
function(event)
Argumen: 
Peristiwa ini diaktifkan saat peristiwa contextmenu DOM diaktifkan pada geometri.
dblclick
function(event)
Argumen: 
Peristiwa ini diaktifkan untuk klik ganda pada geometri.
mousedown
function(event)
Argumen: 
Peristiwa ini diaktifkan untuk mousedown pada geometri.
mouseout
function(event)
Argumen: 
Peristiwa ini diaktifkan saat kursor mouse keluar dari area geometri.
mouseover
function(event)
Argumen: 
Peristiwa ini diaktifkan saat kursor memasuki area geometri.
mouseup
function(event)
Argumen: 
Peristiwa ini diaktifkan untuk mouseup pada geometri.
removefeature
function(event)
Argumen: 
Peristiwa ini dipicu saat fitur dihapus dari koleksi.
removeproperty
function(event)
Argumen: 
Peristiwa ini dipicu saat properti fitur dihapus.
setgeometry
function(event)
Argumen: 
Peristiwa ini dipicu saat geometri fitur ditetapkan.
setproperty
function(event)
Argumen: 
Peristiwa ini dipicu saat properti fitur ditetapkan.
rightclick
function(event)
Argumen: 
Peristiwa ini diaktifkan untuk klik kanan pada geometri.

Data.DataOptions interface

google.maps.Data.DataOptions interface

Objek DataOptions yang digunakan untuk menentukan properti yang dapat ditetapkan developer pada objek Data.
map
Jenis:  Map
Peta tempat menampilkan fitur dalam koleksi.
controlPosition optional
Jenis:  ControlPosition optional
Default: ControlPosition.TOP_LEFT
Posisi kontrol gambar pada peta.
controls optional
Jenis:  Array<string> optional
Default: null
Menjelaskan mode gambar yang tersedia untuk dipilih pengguna, dalam urutan yang ditampilkan. Ini tidak boleh menyertakan mode gambar null, yang ditambahkan secara default. Jika null, kontrol gambar dinonaktifkan dan tidak ditampilkan. Kemungkinan mode menggambar adalah "Point", "LineString", atau "Polygon".
drawingMode optional
Jenis:  string optional
Default: null
Mode gambar saat ini dari Lapisan data yang diberikan. Mode gambar null berarti pengguna dapat berinteraksi dengan peta seperti biasa, dan klik tidak akan menggambar apa pun. Kemungkinan mode gambar adalah null, "Point", "LineString", atau "Polygon".
featureFactory optional
Jenis:  function(Data.Geometry): Data.Feature optional
Saat penggambaran diaktifkan dan pengguna menggambar Geometri (Titik, String Garis, atau Poligon), fungsi ini dipanggil dengan Geometri tersebut dan harus menampilkan Fitur yang akan ditambahkan ke Lapisan data. Jika featureFactory tidak disediakan, Feature tanpa ID dan tanpa properti akan dibuat dari Geometri tersebut. Default-nya adalah null.
style optional
Gaya untuk semua fitur dalam koleksi. Untuk mengetahui detail selengkapnya, lihat metode setStyle() di atas.

Antarmuka Data.GeoJsonOptions

google.maps.Data.GeoJsonOptions interface

Parameter opsional untuk mengimpor GeoJSON.
idPropertyName optional
Jenis:  string optional
Nama properti Fitur yang akan digunakan sebagai ID fitur. Jika tidak ditentukan, ID Fitur GeoJSON akan digunakan.

Data.StyleOptions interface

google.maps.Data.StyleOptions interface

Opsi ini menentukan cara Tampilan harus muncul saat ditampilkan di peta.
animation optional
Jenis:  Animation optional
Animasi yang akan diputar saat penanda ditambahkan ke peta. Hanya berlaku untuk geometri titik.
clickable optional
Jenis:  boolean optional
Default: true
Jika true, penanda akan menerima peristiwa mouse dan sentuh.
cursor optional
Jenis:  string optional
Kursor mouse yang akan ditampilkan mengambang. Hanya berlaku untuk geometri titik.
draggable optional
Jenis:  boolean optional
Default: false
Jika true, objek dapat ditarik di seluruh peta dan fitur yang mendasarinya akan diperbarui geometrinya.
editable optional
Jenis:  boolean optional
Default: false
Jika true, objek dapat diedit dengan menarik titik kontrol dan fitur yang mendasarinya akan diperbarui geometrinya. Hanya berlaku untuk geometri LineString dan Polygon.
fillColor optional
Jenis:  string optional
Warna pengisi. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai. Hanya berlaku untuk geometri poligon.
fillOpacity optional
Jenis:  number optional
Opasitas pengisian antara 0,0 dan 1,0. Hanya berlaku untuk geometri poligon.
icon optional
Jenis:  string|Icon|Symbol optional
Ikon untuk latar depan. Jika string diberikan, string tersebut akan diperlakukan seolah-olah merupakan Icon dengan string sebagai url. Hanya berlaku untuk geometri titik.
icons optional
Jenis:  Array<IconSequence> optional
Ikon yang akan dirender di sepanjang polyline. Hanya berlaku untuk geometri garis.
label optional
Jenis:  string|MarkerLabel optional
Menambahkan label ke penanda. Label dapat berupa string, atau objek MarkerLabel. Hanya berlaku untuk geometri titik.
opacity optional
Jenis:  number optional
Opasitas penanda antara 0,0 dan 1,0. Hanya berlaku untuk geometri titik.
shape optional
Jenis:  MarkerShape optional
Mendefinisikan peta gambar yang digunakan untuk deteksi klik mouse. Hanya berlaku untuk geometri titik.
strokeColor optional
Jenis:  string optional
Warna garis luar. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai. Hanya berlaku untuk geometri garis dan poligon.
strokeOpacity optional
Jenis:  number optional
Opasitas garis luar antara 0,0 dan 1,0. Hanya berlaku untuk geometri garis dan poligon.
strokeWeight optional
Jenis:  number optional
Lebar garis luar dalam piksel. Hanya berlaku untuk geometri garis dan poligon.
title optional
Jenis:  string optional
Teks rollover. Hanya berlaku untuk geometri titik.
visible optional
Jenis:  boolean optional
Default: true
Apakah fitur terlihat.
zIndex optional
Jenis:  number optional
Semua fitur ditampilkan di peta menurut urutan zIndex-nya, dengan nilai yang lebih tinggi akan ditampilkan di depan fitur yang nilainya lebih rendah. Marker selalu ditampilkan di depan line-string dan poligon.

Data.StylingFunction typedef

google.maps.Data.StylingFunction typedef

Fungsi yang menghitung tampilan fitur.

Metode Data.setStyle() dapat menerima fungsi gaya. Gunakan ini saat fitur harus ditampilkan secara berbeda bergantung pada propertinya. Anda dapat menemukan informasi selengkapnya tentang fitur gaya visual di panduan developer.

function(Data.Feature): Data.StyleOptions

Data.Feature class

Class google.maps.Data.Feature

Fitur memiliki geometri, ID, dan serangkaian properti.

Akses dengan memanggil const {Data} = await google.maps.importLibrary("maps").
Lihat Library di Maps JavaScript API.
Data.Feature
Data.Feature([options])
Parameter: 
Membangun Fitur dengan opsi yang diberikan.
forEachProperty
forEachProperty(callback)
Parameter: 
  • callback:  function(*, string): void
Nilai yang Ditampilkan:  Tidak Ada
Berulang kali memanggil fungsi yang diberikan, meneruskan nilai dan nama properti pada setiap pemanggilan. Urutan iterasi melalui properti tidak ditentukan.
getGeometry
getGeometry()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Data.Geometry
Menampilkan geometri fitur.
getId
getId()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  number|string|undefined
Menampilkan ID fitur.
getProperty
getProperty(name)
Parameter: 
  • name:  string
Nilai yang Ditampilkan:  *
Menampilkan nilai properti yang diminta, atau undefined jika properti tidak ada.
removeProperty
removeProperty(name)
Parameter: 
  • name:  string
Nilai yang Ditampilkan:  Tidak Ada
Menghapus properti dengan nama yang diberikan.
setGeometry
setGeometry(newGeometry)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan geometri fitur.
setProperty
setProperty(name, newValue)
Parameter: 
  • name:  string
  • newValue:  *
Nilai yang Ditampilkan:  Tidak Ada
Menetapkan nilai properti yang ditentukan. Jika newValue adalah undefined, ini sama dengan memanggil removeProperty.
toGeoJson
toGeoJson(callback)
Parameter: 
  • callback:  function(Object): void
Nilai yang Ditampilkan:  Tidak Ada
Mengekspor fitur ke objek GeoJSON.
removeproperty
function(event)
Argumen: 
Peristiwa ini dipicu saat properti fitur dihapus.
setgeometry
function(event)
Argumen: 
Peristiwa ini dipicu saat geometri fitur ditetapkan.
setproperty
function(event)
Argumen: 
Peristiwa ini dipicu saat properti fitur ditetapkan.

Data.FeatureOptions interface

google.maps.Data.FeatureOptions interface

Parameter opsional untuk membuat objek Data.Feature.
geometry optional
Geometri fitur. Jika tidak ada yang ditentukan saat fitur dibuat, geometri fitur akan menjadi null. Jika objek LatLng atau LatLngLiteral diberikan, objek tersebut akan dikonversi menjadi geometri Data.Point.
id optional
Jenis:  number|string optional
ID fitur bersifat opsional. Jika disediakan, ID ini dapat digunakan untuk mencari fitur dalam objek Data menggunakan metode getFeatureById(). Perhatikan bahwa ID fitur tidak dapat diubah setelahnya.
properties optional
Jenis:  Object optional
Properti fitur. Ini adalah pemetaan nama properti ke nilai yang bersifat arbitrer.

Antarmuka Data.Geometry

google.maps.Data.Geometry interface

Superclass untuk berbagai objek geometri.
forEachLatLng
forEachLatLng(callback)
Parameter: 
  • callback:  function(LatLng): void
Nilai yang Ditampilkan:  Tidak Ada
Berulang kali memanggil fungsi yang diberikan, meneruskan titik dari geometri ke fungsi pada setiap pemanggilan.
getType
getType()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  string
Menampilkan jenis objek geometri. Kemungkinannya adalah "Point", "MultiPoint", "LineString", "MultiLineString", "LinearRing", "Polygon", "MultiPolygon", atau "GeometryCollection".

Data.Point class

Class google.maps.Data.Point

Geometri Titik berisi satu LatLng.

Class ini mengimplementasikan Data.Geometry.

Akses dengan memanggil const {Data} = await google.maps.importLibrary("maps").
Lihat Library di Maps JavaScript API.
Data.Point
Data.Point(latLng)
Parameter: 
Membuat Data.Point dari LatLng atau LatLngLiteral yang diberikan.
forEachLatLng
forEachLatLng(callback)
Parameter: 
  • callback:  function(