Class Map
Class
google.maps.Map
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {Map} = await google.maps.importLibrary("maps")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
Map |
Map(mapDiv[, opts]) Parameter:
Membuat peta baru dalam penampung HTML tertentu, yang biasanya merupakan elemen DIV . |
Properti | |
---|---|
controls |
Jenis:
Array<MVCArray<HTMLElement>> Kontrol tambahan untuk dilampirkan ke peta. Untuk menambahkan kontrol ke peta, tambahkan <div> kontrol ke MVCArray yang sesuai dengan ControlPosition tempat kontrol seharusnya dirender. |
data |
Jenis:
Data Instance Data , yang terikat dengan peta. Tambahkan fitur ke objek Data ini untuk menampilkannya dengan mudah di peta ini. |
mapTypes |
Jenis:
MapTypeRegistry Registry instance MapType berdasarkan ID string. |
overlayMapTypes |
Jenis peta tambahan untuk overlay. Jenis peta overlay akan ditampilkan sebagai tambahan atas peta dasar tempatnya dilampirkan, sesuai dengan urutan kemunculannya dalam array overlayMapTypes (overlay dengan nilai indeks yang lebih tinggi ditampilkan di depan overlay dengan nilai indeks yang lebih rendah). |
Metode | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Parameter:
Nilai Hasil: Tidak ada
Menetapkan area pandang agar berisi batas yang diberikan. Catatan: Jika peta disetel ke display: none , fungsi fitBounds akan membaca ukuran peta sebagai 0x0, sehingga tidak melakukan apa pun. Untuk mengubah area pandang saat peta disembunyikan, setel peta ke visibility: hidden , untuk memastikan ukuran div peta sebenarnya. Untuk peta vektor, metode ini menyetel kemiringan dan arah peta ke nilai nol default-nya. Memanggil metode ini dapat menyebabkan animasi yang halus saat peta digeser dan di-zoom agar sesuai dengan batas. Apakah metode ini dianimasikan bergantung pada heuristik internal. |
getBounds |
getBounds() Parameter: Tidak ada
Nilai yang Ditampilkan:
LatLngBounds|undefined Batas lintang/bujur area pandang saat ini.Menampilkan batas lintang/bujur area pandang saat ini. Jika terlihat lebih dari satu salinan dunia, batas dalam rentang bujur antara -180 hingga 180 derajat. Jika peta belum diinisialisasi atau berada di tengah dan zoom belum ditetapkan, hasilnya adalah undefined . Untuk peta vektor dengan kemiringan atau arah bukan nol, batas lintang/bujur yang ditampilkan mewakili kotak pembatas terkecil yang menyertakan wilayah yang terlihat di area pandang peta. Lihat MapCanvasProjection.getVisibleRegion untuk mendapatkan wilayah yang terlihat persis di area pandang peta. |
getCenter |
getCenter() Parameter: Tidak ada
Nilai Hasil:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parameter: Tidak ada
Nilai Hasil:
boolean|undefined Menampilkan kemampuan diklik ikon peta. Ikon peta mewakili lokasi menarik, yang juga dikenal sebagai POI. Jika nilai yang ditampilkan adalah true , ikon dapat diklik di peta. |
|
getDatasetFeatureLayer(datasetId) Parameter:
Nilai Hasil:
FeatureLayer Menampilkan FeatureLayer untuk datasetId yang ditentukan. ID set data harus dikonfigurasi di Google Cloud Console. Jika ID set data tidak terkait dengan gaya peta peta, atau jika Gaya visual berbasis data tidak tersedia (tidak ada ID peta, tidak ada ubin vektor, tidak ada lapisan fitur Gaya Data Berbasis Data, atau Set data yang dikonfigurasi di Gaya Peta), error ini akan dicatat di log, dan FeatureLayer.isAvailable yang dihasilkan akan salah. |
getDiv |
getDiv() Parameter: Tidak ada
Nilai Hasil:
HTMLElement MapDiv untuk peta. |
getFeatureLayer |
getFeatureLayer(featureType) Parameter:
Nilai Hasil:
FeatureLayer Menampilkan FeatureLayer dari FeatureType tertentu. FeatureLayer harus diaktifkan di Google Cloud Console. Jika FeatureLayer dari FeatureType yang ditentukan tidak ada pada peta ini, atau jika Gaya visual berbasis data tidak tersedia (tidak ada ID peta, tidak ada ubin vektor, dan tidak ada FeatureLayer yang diaktifkan dalam gaya peta), ini akan mencatat error, dan FeatureLayer.isAvailable yang dihasilkan akan salah. |
getHeading |
getHeading() Parameter: Tidak ada
Nilai Hasil:
number|undefined Menampilkan arah kompas pada peta. Nilai arah tujuan diukur dalam derajat (searah jarum jam) dari arah mata angin Utara. Jika peta belum diinisialisasi, hasilnya adalah undefined . |
getMapCapabilities |
getMapCapabilities() Parameter: Tidak ada
Nilai Hasil:
MapCapabilities Memberi tahu pemanggil tentang kemampuan saat ini yang tersedia untuk peta berdasarkan ID Peta yang diberikan. |
getMapTypeId |
getMapTypeId() Parameter: Tidak ada
Nilai Hasil:
MapTypeId|string|undefined |
getProjection |
getProjection() Parameter: Tidak ada
Nilai Hasil:
Projection|undefined Menampilkan Projection saat ini. Jika peta belum diinisialisasi, hasilnya adalah undefined . Proses peristiwa projection_changed dan periksa nilainya untuk memastikan bahwa peristiwa tersebut bukan undefined . |
getRenderingType |
getRenderingType() Parameter: Tidak ada
Nilai Hasil:
RenderingType Menampilkan RenderingType saat ini dari peta. |
getStreetView |
getStreetView() Parameter: Tidak ada
Nilai yang Ditampilkan:
StreetViewPanorama Panorama yang terikat dengan peta.Menampilkan StreetViewPanorama default yang terikat ke peta, yang mungkin merupakan panorama default yang disematkan dalam peta, atau panorama yang ditetapkan menggunakan setStreetView() . Perubahan pada streetViewControl peta akan ditampilkan dalam tampilan panorama terikat tersebut. |
getTilt |
getTilt() Parameter: Tidak ada
Nilai Hasil:
number|undefined Menampilkan sudut insiden peta saat ini, dalam derajat dari bidang area pandang ke bidang peta. Untuk peta raster, hasilnya adalah 0 untuk gambar yang diambil langsung dari atas atau 45 untuk gambar 45°. Metode ini tidak menampilkan nilai yang ditetapkan oleh setTilt . Untuk lebih detailnya, lihat setTilt . |
getZoom |
getZoom() Parameter: Tidak ada
Nilai Hasil:
number|undefined Menampilkan zoom peta. Jika zoom belum ditetapkan, hasilnya adalah undefined . |
moveCamera |
moveCamera(cameraOptions) Parameter:
Nilai Hasil: Tidak ada
Segera tetapkan kamera peta ke opsi kamera target, tanpa animasi. |
panBy |
panBy(x, y) Parameter:
Nilai Hasil: Tidak ada
Mengubah bagian tengah peta berdasarkan jarak yang ditetapkan dalam piksel. Jika jaraknya kurang dari lebar dan tinggi peta, transisi akan dianimasikan dengan lancar. Perhatikan bahwa sistem koordinat peta bertambah dari barat ke timur (untuk nilai x) dan utara ke selatan (untuk nilai y). |
panTo |
panTo(latLng) Parameter:
Nilai Hasil: Tidak ada
Mengubah bagian tengah peta menjadi LatLng yang ditentukan. Jika perubahannya kurang dari lebar dan tinggi peta, transisi akan dianimasikan dengan lancar. |
panToBounds |
panToBounds(latLngBounds[, padding]) Parameter:
Nilai Hasil: Tidak ada
Menggeser peta berdasarkan jumlah minimum yang diperlukan untuk memuat LatLngBounds yang ditentukan. Tidak ada jaminan letak batas pada peta, kecuali peta akan digeser untuk menampilkan batas sebanyak mungkin dalam {currentMapSizeInPx} - {padding} . Untuk peta raster dan vektor, zoom, kemiringan, dan arah tujuan peta tidak akan diubah. |
setCenter |
setCenter(latlng) Parameter:
Nilai Hasil: Tidak ada
|
setClickableIcons |
setClickableIcons(value) Parameter:
Nilai Hasil: Tidak ada
Mengontrol apakah ikon peta dapat diklik atau tidak. Ikon peta mewakili lokasi menarik, yang juga dikenal sebagai POI. Untuk menonaktifkan kemampuan diklik ikon peta, teruskan nilai false ke metode ini. |
setHeading |
setHeading(heading) Parameter:
Nilai Hasil: Tidak ada
Menetapkan arah kompas untuk peta yang diukur dalam derajat dari arah mata angin Utara. Untuk peta raster, metode ini hanya berlaku pada citra udara. |
setMapTypeId |
setMapTypeId(mapTypeId) Parameter:
Nilai Hasil: Tidak ada
|
setOptions |
setOptions(options) Parameter:
Nilai Hasil: Tidak ada
|
setStreetView |
setStreetView(panorama) Parameter:
Nilai Hasil: Tidak ada
Mengikat StreetViewPanorama ke peta. Panorama ini mengganti StreetViewPanorama default, sehingga peta dapat diikat ke panorama eksternal di luar peta. Menetapkan panorama ke null akan mengikat kembali panorama tersemat default ke peta. |
setTilt |
setTilt(tilt) Parameter:
Nilai Hasil: Tidak ada
Untuk peta vektor, menetapkan sudut insiden peta. Nilai yang diizinkan dibatasi bergantung pada tingkat zoom peta. Untuk peta raster, mengontrol perilaku peralihan otomatis untuk sudut insiden peta. Satu-satunya nilai yang diizinkan adalah 0 dan 45 . setTilt(0) menyebabkan peta selalu menggunakan tampilan overhead 0°, terlepas dari tingkat zoom dan area pandang. setTilt(45) menyebabkan sudut kemiringan beralih secara otomatis ke 45 setiap kali gambar 45° tersedia untuk tingkat zoom dan area pandang saat ini, dan beralih kembali ke 0 setiap kali gambar 45° tidak tersedia (ini adalah perilaku default). Gambar 45° hanya tersedia untuk jenis peta satellite dan hybrid , dalam beberapa lokasi, dan pada beberapa tingkat zoom. Catatan: getTilt menampilkan sudut kemiringan saat ini, bukan nilai yang ditetapkan oleh setTilt . Karena getTilt dan setTilt merujuk pada hal yang berbeda, jangan bind() buat properti tilt ; melakukannya dapat menghasilkan efek yang tidak dapat diprediksi. |
setZoom |
setZoom(zoom) Parameter:
Nilai Hasil: Tidak ada
Menetapkan zoom peta. |
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Konstanta | |
---|---|
DEMO_MAP_ID |
ID Peta yang dapat digunakan untuk contoh kode yang memerlukan ID Peta. ID Peta ini tidak dimaksudkan untuk digunakan dalam aplikasi produksi dan tidak dapat digunakan untuk fitur yang memerlukan konfigurasi cloud (seperti Cloud Penataan Gaya). |
Peristiwa | |
---|---|
bounds_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat batas area pandang berubah. |
center_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti pusat peta berubah. |
click |
function(event) Argumen:
Peristiwa ini dijalankan saat pengguna mengklik pada peta. MapMouseEvent dengan properti untuk lokasi yang diklik ditampilkan kecuali ikon tempat diklik, dalam hal ini IconMouseEvent dengan ID tempat ditampilkan. IconMouseEvent dan MapMouseEvent identik, kecuali IconMouseEvent memiliki kolom ID tempat. Peristiwa selalu dapat diperlakukan sebagai MapMouseEvent saat ID tempat tidak penting. Peristiwa klik tidak diaktifkan jika penanda atau jendela info diklik. |
contextmenu |
function(event) Argumen:
Peristiwa ini dipicu ketika peristiwa menu konteks DOM diaktifkan pada penampung peta. |
dblclick |
function(event) Argumen:
Peristiwa ini dipicu saat pengguna mengklik dua kali pada peta. Perhatikan bahwa peristiwa klik terkadang akan aktif sekali dan terkadang dua kali, tepat sebelum peristiwa ini. |
drag |
function() Argumen: Tidak ada
Peristiwa ini berulang kali diaktifkan saat pengguna menarik peta. |
dragend |
function() Argumen: Tidak ada
Peristiwa ini dijalankan saat pengguna berhenti menarik peta. |
dragstart |
function() Argumen: Tidak ada
Peristiwa ini dijalankan saat pengguna mulai menarik peta. |
heading_changed |
function() Argumen: Tidak ada
Peristiwa ini dijalankan ketika properti arah peta berubah. |
idle |
function() Argumen: Tidak ada
Peristiwa ini dipicu ketika peta tidak ada aktivitas setelah menggeser atau melakukan zoom. |
isfractionalzoomenabled_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti isFracrationZoomEnabled telah berubah. |
mapcapabilities_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat kemampuan peta berubah. |
maptypeid_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti mapTypeId berubah. |
mousemove |
function(event) Argumen:
Peristiwa ini dipicu setiap kali mouse pengguna bergerak di atas penampung peta. |
mouseout |
function(event) Argumen:
Peristiwa ini dipicu saat mouse pengguna keluar dari penampung peta. |
mouseover |
function(event) Argumen:
Peristiwa ini dipicu saat mouse pengguna memasuki penampung peta. |
projection_changed |
function() Argumen: Tidak ada
Peristiwa ini dijalankan saat proyeksi telah berubah. |
renderingtype_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat renderingType telah berubah. |
tilesloaded |
function() Argumen: Tidak ada
Peristiwa ini dijalankan saat ubin yang terlihat telah selesai dimuat. |
tilt_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti kemiringan peta berubah. |
zoom_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu ketika properti zoom peta berubah. |
|
function(event) Argumen:
Peristiwa ini dipicu saat pengguna mengklik kanan pada peta. |
Antarmuka MapOptions
Antarmuka
google.maps.MapOptions
Objek MapOptions digunakan untuk menentukan properti yang dapat ditetapkan pada Peta.
Properti | |
---|---|
backgroundColor optional |
Jenis:
string optional Warna yang digunakan untuk latar belakang div Peta. Warna ini akan terlihat saat ubin belum dimuat saat pengguna menggeser. Opsi ini hanya dapat ditetapkan bila peta diinisialisasi. |
center optional |
Jenis:
LatLng|LatLngLiteral optional Pusat peta awal. |
clickableIcons optional |
Jenis:
boolean optional Default:
true Jika false , ikon peta tidak dapat diklik. Ikon peta mewakili lokasi menarik, yang juga dikenal sebagai POI. |
controlSize optional |
Jenis:
number optional Ukuran piksel kontrol yang muncul di peta. Nilai ini harus diberikan langsung saat membuat Peta, memperbarui nilai ini nanti dapat mengembalikan kontrol ke status undefined . Hanya mengatur kontrol yang dibuat oleh Maps API itu sendiri. Tidak menskalakan kontrol kustom yang dibuat developer. |
disableDefaultUI optional |
Jenis:
boolean optional Mengaktifkan/menonaktifkan semua tombol UI default. Dapat diganti satu per satu. Tidak menonaktifkan kontrol keyboard, yang dikontrol secara terpisah oleh opsi MapOptions.keyboardShortcuts . Tidak menonaktifkan kontrol gestur, yang dikontrol secara terpisah oleh opsi MapOptions.gestureHandling . |
disableDoubleClickZoom optional |
Jenis:
boolean optional Mengaktifkan/menonaktifkan zoom dan memusatkan pada klik dua kali. Diaktifkan secara default. Catatan: Properti ini tidak direkomendasikan. Untuk menonaktifkan zoom pada klik dua kali, Anda dapat menggunakan properti |
|
Jenis:
boolean optional Jika false , mencegah peta ditarik. Penarikan diaktifkan secara default. |
draggableCursor optional |
Jenis:
string optional Nama atau URL kursor yang akan ditampilkan saat mengarahkan kursor ke peta yang dapat ditarik. Properti ini menggunakan atribut cursor css untuk mengubah ikon. Seperti halnya properti css, Anda harus menentukan setidaknya satu kursor pengganti yang bukan URL. Contoh: draggableCursor: 'url(http://www.example.com/icon.png), auto;' . |
draggingCursor optional |
Jenis:
string optional Nama atau URL kursor yang akan ditampilkan saat peta ditarik. Properti ini menggunakan atribut cursor css untuk mengubah ikon. Seperti halnya properti css, Anda harus menentukan setidaknya satu kursor pengganti yang bukan URL. Contoh: draggingCursor: 'url(http://www.example.com/icon.png), auto;' . |
fullscreenControl optional |
Jenis:
boolean optional Status kontrol Layar Penuh diaktifkan atau dinonaktifkan. |
fullscreenControlOptions optional |
Jenis:
FullscreenControlOptions optional Opsi tampilan untuk kontrol Layar Penuh. |
gestureHandling optional |
Jenis:
string optional Setelan ini mengontrol cara API menangani gestur pada peta. Nilai yang diizinkan:
|
heading optional |
Jenis:
number optional Tajuk untuk citra udara dalam derajat yang diukur searah jarum jam dari arah mata angin Utara. Tajuk dipaskan ke sudut terdekat yang tersedia yang citranya tersedia. |
isFractionalZoomEnabled optional |
Jenis:
boolean optional Default:
true untuk peta vektor dan false untuk peta rasterApakah peta harus mengizinkan tingkat zoom pecahan. Dengarkan isfractionalzoomenabled_changed untuk mengetahui kapan default telah disetel. |
keyboardShortcuts optional |
Jenis:
boolean optional Jika false , mencegah peta dikontrol oleh keyboard. Pintasan keyboard diaktifkan secara default. |
mapId optional |
Jenis:
string optional ID Peta untuk peta. Parameter ini tidak dapat ditetapkan atau diubah setelah instance peta dibuat. |
mapTypeControl optional |
Jenis:
boolean optional Status awal diaktifkan/dinonaktifkan dari kontrol jenis Peta. |
mapTypeControlOptions optional |
Jenis:
MapTypeControlOptions optional Opsi tampilan awal untuk kontrol jenis Peta. |
mapTypeId optional |
Jenis:
MapTypeId|string optional MapTypeId awal. Default-nya adalah ROADMAP . |
maxZoom optional |
Jenis:
number optional Tingkat zoom maksimum yang akan ditampilkan pada peta. Jika dihilangkan, atau ditetapkan ke null , zoom maksimum dari jenis peta saat ini akan digunakan. Nilai zoom yang valid adalah angka dari nol hingga tingkat zoom maksimum yang didukung. |
minZoom optional |
Jenis:
number optional Tingkat zoom minimum yang akan ditampilkan pada peta. Jika dihilangkan, atau ditetapkan ke null , zoom minimum dari jenis peta saat ini akan digunakan. Nilai zoom yang valid adalah angka dari nol hingga tingkat zoom maksimum yang didukung. |
noClear optional |
Jenis:
boolean optional Jika true , jangan menghapus konten div Peta. |
panControl optional |
Jenis:
boolean optional Status kontrol Geser yang diaktifkan/dinonaktifkan. Catatan: Kontrol geser tidak tersedia di rangkaian kontrol baru yang diperkenalkan di Google Maps JavaScript API v3.22. Saat menggunakan v3.22 dan v3.23, Anda dapat memilih untuk menggunakan kumpulan kontrol sebelumnya, bukan kontrol baru, sehingga kontrol Pan tersedia sebagai bagian dari set kontrol lama. Lihat Yang Baru di Kontrol Peta v3.22. |
panControlOptions optional |
Jenis:
PanControlOptions optional Opsi tampilan untuk kontrol Geser. Catatan: Kontrol geser tidak tersedia di rangkaian kontrol baru yang diperkenalkan di Google Maps JavaScript API v3.22. Saat menggunakan v3.22 dan v3.23, Anda dapat memilih untuk menggunakan kumpulan kontrol sebelumnya, bukan kontrol baru, sehingga kontrol Pan tersedia sebagai bagian dari set kontrol lama. Lihat Yang Baru di Kontrol Peta v3.22. |
restriction optional |
Jenis:
MapRestriction optional Menentukan batas yang membatasi area peta yang dapat diakses oleh pengguna. Jika ditetapkan, pengguna hanya dapat menggeser dan melakukan zoom saat tampilan kamera tetap berada di dalam batas. |
rotateControl optional |
Jenis:
boolean optional Status kontrol Rotasi yang diaktifkan/dinonaktifkan. |
rotateControlOptions optional |
Jenis:
RotateControlOptions optional Opsi tampilan untuk kontrol Rotasi. |
scaleControl optional |
Jenis:
boolean optional Status awal diaktifkan/dinonaktifkan dari kontrol Skala. |
scaleControlOptions optional |
Jenis:
ScaleControlOptions optional Opsi tampilan awal untuk kontrol Skala. |
scrollwheel optional |
Jenis:
boolean optional Jika false , menonaktifkan zoom pada peta menggunakan roda scroll mouse. Scrollwheel diaktifkan secara default. Catatan: Properti ini tidak direkomendasikan. Untuk menonaktifkan zoom menggunakan scrollwheel, Anda dapat menggunakan properti |
streetView optional |
Jenis:
StreetViewPanorama optional StreetViewPanorama untuk ditampilkan saat pegman Street View dilepas di peta. Jika tidak ada panorama yang ditentukan, StreetViewPanorama default akan ditampilkan dalam div peta saat pegman dilepas. |
streetViewControl optional |
Jenis:
boolean optional Status awal diaktifkan/dinonaktifkan dari kontrol Pegman Street View. Kontrol ini adalah bagian dari UI default dan harus ditetapkan ke false saat menampilkan jenis peta tempat overlay jalan Street View tidak akan muncul (misalnya, jenis peta non-Earth). |
streetViewControlOptions optional |
Jenis:
StreetViewControlOptions optional Opsi tampilan awal untuk kontrol Pegman Street View. |
styles optional |
Jenis:
Array<MapTypeStyle> optional Gaya yang akan diterapkan ke setiap jenis peta default. Perlu diketahui bahwa untuk mode satellite /hybrid dan terrain , gaya ini hanya akan diterapkan pada label dan geometri. |
tilt optional |
Jenis:
number optional Untuk peta vektor, menetapkan sudut insiden peta. Nilai yang diizinkan dibatasi bergantung pada tingkat zoom peta. Untuk peta raster, mengontrol perilaku peralihan otomatis untuk sudut insiden peta. Satu-satunya nilai yang diizinkan adalah 0 dan 45 . Nilai 0 menyebabkan peta selalu menggunakan tampilan overhead 0°, terlepas dari tingkat zoom dan area pandang. Nilai 45 menyebabkan sudut kemiringan beralih secara otomatis ke 45 setiap kali gambar 45° tersedia untuk tingkat zoom saat ini dan area pandang, serta beralih kembali ke 0 setiap kali gambar 45° tidak tersedia (ini adalah perilaku default). Gambar 45° hanya tersedia untuk jenis peta satellite dan hybrid , dalam beberapa lokasi, dan pada beberapa tingkat zoom. Catatan: getTilt menampilkan sudut kemiringan saat ini, bukan nilai yang ditentukan oleh opsi ini. Karena getTilt dan opsi ini merujuk pada hal yang berbeda, jangan bind() properti tilt ; tindakan tersebut dapat menghasilkan efek yang tidak dapat diprediksi. |
zoom optional |
Jenis:
number optional Tingkat zoom Peta awal. Nilai zoom yang valid adalah angka dari nol hingga tingkat zoom maksimum yang didukung. Nilai zoom yang lebih besar akan memiliki resolusi yang lebih tinggi. |
zoomControl optional |
Jenis:
boolean optional Status kontrol Zoom yang diaktifkan/dinonaktifkan. |
zoomControlOptions optional |
Jenis:
ZoomControlOptions optional Opsi tampilan untuk kontrol Zoom. |
Class MapElement
Class
google.maps.MapElement
MapElement adalah subclass HTMLElement
untuk merender peta. Setelah memuat library maps
, peta dapat dibuat dalam HTML. Misalnya:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID"></gmp-map>
Secara internal, properti ini menggunakan Map
, yang dapat diakses dengan properti innerMap
.
Elemen kustom:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>
Class ini memperluas
HTMLElement
.
Class ini mengimplementasikan
MapElementOptions
.
Akses dengan memanggil const {MapElement} = await google.maps.importLibrary("maps")
. Lihat Library di Maps JavaScript API.
Properti | |
---|---|
center |
Jenis:
LatLng|LatLngLiteral optional Lintang/bujur tengah peta.
Atribut HTML:
|
innerMap |
Jenis:
Map Referensi ke Map yang digunakan MapElement secara internal. |
mapId |
Jenis:
string optional ID Peta untuk peta. Lihat dokumentasi ID Peta untuk informasi selengkapnya.
Atribut HTML:
|
zoom |
Jenis:
number optional Tingkat zoom peta.
Atribut HTML:
|
Metode | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Nilai Hasil:
void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan ditayangkan ke target. Lihat addEventListener |
|
removeEventListener(type, listener[, options]) Parameter:
Nilai Hasil:
void Menghapus pemroses peristiwa yang sebelumnya terdaftar dengan addEventListener dari target. Lihat removeEventListener |
Antarmuka MapElementOptions
Antarmuka
google.maps.MapElementOptions
Objek MapElementOptions digunakan untuk menentukan properti yang dapat ditetapkan pada MapElement.
Properti | |
---|---|
center optional |
Jenis:
LatLng|LatLngLiteral optional Pusat peta awal. |
mapId optional |
Jenis:
string optional ID Peta untuk peta. Parameter ini tidak dapat ditetapkan atau diubah setelah instance peta dibuat. |
zoom optional |
Jenis:
number optional Tingkat zoom Peta awal. Nilai zoom yang valid adalah angka dari nol hingga tingkat zoom maksimum yang didukung. Nilai zoom yang lebih besar akan memiliki resolusi yang lebih tinggi. |
Antarmuka MapTypeStyle
Antarmuka
google.maps.MapTypeStyle
MapTypeStyle
adalah kumpulan pemilih dan styler yang menentukan cara penataan gaya peta. Pemilih menentukan fitur dan/atau elemen peta yang akan terpengaruh, dan styler menentukan cara fitur dan elemen tersebut harus dimodifikasi. Untuk mengetahui detailnya, lihat referensi gaya.
Properti | |
---|---|
stylers |
Aturan gaya untuk diterapkan pada fitur dan elemen peta yang dipilih. Aturan diterapkan sesuai urutan yang Anda tetapkan dalam array ini. Untuk panduan tentang penggunaan dan nilai yang diizinkan, lihat referensi gaya. |
elementType optional |
Jenis:
string optional Elemen yang akan menerapkan styler. Elemen adalah aspek visual dari fitur pada peta. Misalnya: label, ikon, goresan, atau pengisi yang diterapkan pada geometri, dan lainnya. Opsional. Jika elementType tidak ditentukan, nilai diasumsikan sebagai 'all' . Untuk detail penggunaan dan nilai yang diizinkan, lihat referensi gaya. |
featureType optional |
Jenis:
string optional Fitur, atau sekelompok fitur, yang harus diterapkan styler. Opsional. Jika featureType tidak ditentukan, nilai diasumsikan sebagai 'all' . Untuk detail penggunaan dan nilai yang diizinkan, lihat referensi gaya. |
Antarmuka MapMouseEvent
Antarmuka
google.maps.MapMouseEvent
Objek ini ditampilkan dari berbagai peristiwa mouse pada peta dan overlay, serta berisi semua kolom yang ditampilkan di bawah ini.
Properti | |
---|---|
domEvent |
Peristiwa DOM native yang sesuai. Developer tidak boleh mengandalkan properti target , currentTarget , relatedTarget , dan path yang ditentukan dan konsisten. Developer juga tidak boleh bergantung pada struktur DOM dari implementasi internal Maps API. Karena pemetaan peristiwa internal, domEvent mungkin memiliki semantik yang berbeda dari MapMouseEvent (misalnya, "klik" MapMouseEvent mungkin memiliki domEvent jenis KeyboardEvent ). |
latLng optional |
Jenis:
LatLng optional Lintang/bujur yang berada di bawah kursor saat peristiwa terjadi. |
Metode | |
---|---|
stop |
stop() Parameter: Tidak ada
Nilai Hasil:
void Mencegah peristiwa ini agar tidak menyebar lebih lanjut. |
Antarmuka IconMouseEvent
Antarmuka
google.maps.IconMouseEvent
Objek ini dikirim dalam peristiwa saat pengguna mengklik ikon pada peta. ID tempat dari tempat ini disimpan di anggota placeId. Untuk mencegah jendela info default muncul, panggil metode stop() pada peristiwa ini untuk mencegahnya disebarkan. Pelajari lebih lanjut ID tempat di panduan developer Places API.
Antarmuka ini memperluas
MapMouseEvent
.
Properti | |
---|---|
placeId optional |
Jenis:
string optional ID tempat dari tempat yang diklik. ID tempat ini dapat digunakan untuk meminta informasi selengkapnya tentang fitur yang diklik. Pelajari lebih lanjut ID tempat di panduan developer Places API. |
Diwariskan:
domEvent ,
latLng
|
Metode | |
---|---|
Diwariskan:
stop
|
Konstanta MapTypeId
Konstanta google.maps.MapTypeId
ID untuk MapType umum. Tentukan nilai ini menurut nilai, atau dengan menggunakan nama konstanta. Misalnya, 'satellite'
atau google.maps.MapTypeId.SATELLITE
.
Akses dengan memanggil const {MapTypeId} = await google.maps.importLibrary("maps")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
HYBRID |
Jenis peta ini menampilkan lapisan transparan jalan utama pada citra satelit. |
ROADMAP |
Jenis peta ini menampilkan peta jalan biasa. |
SATELLITE |
Jenis peta ini menampilkan gambar satelit. |
TERRAIN |
Jenis peta ini menampilkan peta dengan fitur fisik seperti medan dan vegetasi. |
Class MapTypeRegistry
Class
google.maps.MapTypeRegistry
Registry untuk instance MapType, yang dikunci oleh ID MapType.
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {MapTypeRegistry} = await google.maps.importLibrary("maps")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Parameter: Tidak ada
MapTypeRegistry menyimpan kumpulan jenis peta kustom yang tersedia untuk peta untuk digunakan. API memeriksa registry ini saat memberikan daftar jenis peta yang tersedia dalam kontrol, misalnya. |
Metode | |
---|---|
set |
set(id, mapType) Parameter:
Nilai Hasil: Tidak ada
Menetapkan registry untuk mengaitkan ID string yang diteruskan dengan MapType yang diteruskan. |
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
setValues ,
unbind ,
unbindAll
|
Antarmuka MapRestriction
Antarmuka
google.maps.MapRestriction
Pembatasan yang dapat diterapkan ke Peta. Area pandang peta tidak akan melebihi batasan ini.
Properti | |
---|---|
latLngBounds |
Jenis:
LatLngBounds|LatLngBoundsLiteral Jika ditetapkan, pengguna hanya dapat menggeser dan melakukan zoom dalam batas yang ditentukan. Batas dapat membatasi bujur dan lintang, atau dapat membatasi lintang saja. Untuk batas khusus lintang, gunakan bujur barat dan timur masing-masing sebesar -180 dan 180, misalnya, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} . |
strictBounds optional |
Jenis:
boolean optional Batas dapat dibuat lebih ketat dengan menetapkan flag strictBounds ke true . Hal ini mengurangi seberapa jauh pengguna dapat memperkecil tampilan, sehingga memastikan semua hal di luar batas yang dibatasi tetap disembunyikan. Defaultnya adalah false , artinya pengguna dapat memperkecil tampilan hingga seluruh area terikat terlihat, mungkin termasuk area di luar area terikat. |
Class TrafficLayer
Class
google.maps.TrafficLayer
Lapisan traffic.
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {TrafficLayer} = await google.maps.importLibrary("maps")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
TrafficLayer |
TrafficLayer([opts]) Parameter:
Lapisan yang menampilkan lalu lintas jalan saat ini. |
Metode | |
---|---|
getMap |
getMap() Parameter: Tidak ada
Nilai Hasil:
Map Menampilkan peta tempat lapisan ini ditampilkan. |
setMap |
setMap(map) Parameter:
Nilai Hasil: Tidak ada
Merender lapisan pada peta yang ditentukan. Jika peta ditetapkan ke null , lapisan akan dihapus. |
setOptions |
setOptions(options) Parameter:
Nilai Hasil: Tidak ada
|
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Antarmuka TrafficLayerOptions
Antarmuka
google.maps.TrafficLayerOptions
Objek TrafficLayerOptions digunakan untuk menentukan properti yang dapat ditetapkan pada TrafficLayer.
Properti | |
---|---|
autoRefresh optional |
Jenis:
boolean optional Default:
true Apakah lapisan traffic diperbarui secara otomatis dengan informasi yang telah diperbarui. |
map optional |
Jenis:
Map optional Peta untuk menampilkan lapisan lalu lintas. |
Class TransitLayer
Class
google.maps.TransitLayer
Lapisan transportasi umum.
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {TransitLayer} = await google.maps.importLibrary("maps")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
TransitLayer |
TransitLayer() Parameter: Tidak ada
Lapisan yang menampilkan jalur transit. |
Metode | |
---|---|
getMap |
getMap() Parameter: Tidak ada
Nilai Hasil:
Map Menampilkan peta tempat lapisan ini ditampilkan. |
setMap |
setMap(map) Parameter:
Nilai Hasil: Tidak ada
Merender lapisan pada peta yang ditentukan. Jika peta ditetapkan ke null , lapisan akan dihapus. |
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Class BicyclingLayer
Class
google.maps.BicyclingLayer
Lapisan yang menampilkan jalur dan jalur sepeda.
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {BicyclingLayer} = await google.maps.importLibrary("maps")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
BicyclingLayer |
BicyclingLayer() Parameter: Tidak ada
Lapisan yang menampilkan jalur sepeda dan jalur serta mendemosikan jalan besar. |
Metode | |
---|---|
getMap |
getMap() Parameter: Tidak ada
Nilai Hasil:
Map Menampilkan peta tempat lapisan ini ditampilkan. |
setMap |
setMap(map) Parameter:
Nilai Hasil: Tidak ada
Merender lapisan pada peta yang ditentukan. Jika peta ditetapkan ke null , lapisan akan dihapus. |
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Antarmuka CameraOptions
Antarmuka
google.maps.CameraOptions
Digunakan untuk menyetel opsi kamera peta.
Properti | |
---|---|
center optional |
Jenis:
LatLngLiteral|LatLng optional |
heading optional |
Jenis:
number optional |
tilt optional |
Jenis:
number optional |
zoom optional |
Jenis:
number optional |
Antarmuka VisibleRegion
Antarmuka
google.maps.VisibleRegion
Berisi empat titik yang mendefinisikan poligon empat sisi yang merupakan wilayah peta yang terlihat. Pada peta vektor, poligon ini dapat menjadi Trapesium, bukan persegi panjang, jika peta vektor memiliki kemiringan.
Properti | |
---|---|
farLeft |
Jenis:
LatLng |
farRight |
Jenis:
LatLng |
latLngBounds |
Jenis:
LatLngBounds Kotak pembatas terkecil yang menyertakan wilayah yang terlihat. |
nearLeft |
Jenis:
LatLng |
nearRight |
Jenis:
LatLng |
Konstanta RenderingType
Konstanta google.maps.RenderingType
Akses dengan memanggil const {RenderingType} = await google.maps.importLibrary("maps")
. Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
RASTER |
Menunjukkan bahwa peta adalah peta raster. |
UNINITIALIZED |
Menunjukkan bahwa peta belum diketahui apakah vektor atau raster, karena inisialisasi pada peta belum selesai. |
VECTOR |
Menunjukkan bahwa peta adalah peta vektor. |
Antarmuka MapCapabilities
Antarmuka
google.maps.MapCapabilities
Objek yang berisi snapshot tentang kemampuan yang saat ini tersedia untuk Peta. Perhatikan bahwa ini bukan berarti modul yang relevan dimuat atau diinisialisasi, tetapi peta saat ini memiliki izin untuk menggunakan API ini. Lihat properti untuk daftar kemungkinan kemampuan.
Properti | |
---|---|
isAdvancedMarkersAvailable optional |
Jenis:
boolean optional Jika true (benar), peta ini dikonfigurasi dengan benar untuk memungkinkan penggunaan penanda lanjutan. Perhatikan bahwa Anda masih harus mengimpor library marker untuk menggunakan penanda lanjutan. Lihat https://goo.gle/gmp-isAdvancedMarkersAvailable untuk mengetahui informasi selengkapnya. |
isDataDrivenStylingAvailable optional |
Jenis:
boolean optional Jika true (benar), peta ini dikonfigurasi dengan benar untuk memungkinkan penggunaan gaya visual berbasis data untuk setidaknya satu FeatureLayer. Lihat https://goo.gle/gmp-data-driven-style dan https://goo.gle/gmp-FeatureLayerIsAvailable untuk mengetahui informasi selengkapnya. |