Map class
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 di dalam penampung HTML tertentu, yang biasanya merupakan elemen DIV . |
Konstanta | |
---|---|
DEMO_MAP_ID |
ID peta yang dapat digunakan untuk contoh kode yang memerlukan ID peta. ID peta ini tidak ditujukan untuk digunakan dalam aplikasi produksi dan tidak dapat digunakan untuk fitur yang memerlukan konfigurasi cloud (seperti Gaya Visual Cloud). |
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 harus dirender. |
data |
Jenis:
Data Instance Data , terikat ke peta. Tambahkan fitur ke objek Data ini untuk menampilkannya dengan mudah di peta ini. |
mapTypes |
Jenis:
MapTypeRegistry Registry instance MapType menurut ID string. |
overlayMapTypes |
Jenis peta tambahan yang akan di-overlay. Jenis peta overlay akan ditampilkan di atas peta dasar yang terkait dengannya, 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 yang Ditampilkan: Tidak Ada
Menetapkan area tampilan untuk memuat 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 tampilan saat peta disembunyikan, tetapkan peta ke visibility: hidden , sehingga memastikan div peta memiliki ukuran sebenarnya. Untuk peta vektor, metode ini menetapkan kemiringan dan arah peta ke nilai nol defaultnya. Memanggil metode ini dapat menyebabkan animasi yang lancar saat peta di-pan dan di-zoom agar sesuai dengan batas. Apakah metode ini menganimasikan atau tidak bergantung pada heuristik internal. |
getBounds |
getBounds() Parameter: Tidak ada
Nilai yang Ditampilkan:
LatLngBounds|undefined Batas lat/lng area pandang saat ini.Menampilkan batas lat/lng area tampilan saat ini. Jika lebih dari satu salinan dunia terlihat, rentang batas dalam bujur dari -180 hingga 180 derajat inklusif. Jika peta belum diinisialisasi atau pusat dan zoom belum disetel, hasilnya adalah undefined . Untuk peta vektor dengan kemiringan atau arah yang tidak nol, batas lat/lng yang ditampilkan mewakili kotak pembatas terkecil yang menyertakan wilayah yang terlihat di area pandang peta. Lihat MapCanvasProjection.getVisibleRegion untuk mendapatkan area yang terlihat persis dari area pandang peta. |
getCenter |
getCenter() Parameter: Tidak ada
Nilai yang Ditampilkan:
LatLng|undefined |
getClickableIcons |
getClickableIcons() Parameter: Tidak ada
Nilai yang Ditampilkan:
boolean|undefined Menampilkan kemampuan ikon peta untuk diklik. Ikon peta merepresentasikan lokasi menarik, yang juga dikenal sebagai POI. Jika nilai yang ditampilkan adalah true , ikon dapat diklik di peta. |
|
getDatasetFeatureLayer(datasetId) Parameter:
Nilai yang Ditampilkan:
FeatureLayer Menampilkan FeatureLayer untuk datasetId yang ditentukan. ID set data harus dikonfigurasi di Konsol Google Cloud. Jika ID set data tidak dikaitkan dengan gaya peta, atau jika Gaya visual berbasis data tidak tersedia (tidak ada ID peta, tidak ada petak vektor, tidak ada lapisan fitur Gaya Visual Berbasis Data atau Set Data yang dikonfigurasi di Gaya Peta), hal ini akan mencatat error, dan FeatureLayer.isAvailable yang dihasilkan akan salah (false). |
getDiv |
getDiv() Parameter: Tidak ada
Nilai yang Ditampilkan:
HTMLElement mapDiv peta. |
getFeatureLayer |
getFeatureLayer(featureType) Parameter:
Nilai yang Ditampilkan:
FeatureLayer Menampilkan FeatureLayer dari FeatureType tertentu. FeatureLayer harus diaktifkan di Konsol Google Cloud. Jika FeatureLayer dari FeatureType yang ditentukan tidak ada di peta ini, atau jika Gaya visual berbasis data tidak tersedia (tidak ada ID peta, tidak ada petak vektor, dan tidak ada FeatureLayer yang diaktifkan dalam gaya visual peta), error akan dicatat, dan FeatureLayer.isAvailable yang dihasilkan akan salah (false). |
getHeading |
getHeading() Parameter: Tidak ada
Nilai yang Ditampilkan:
number|undefined Menampilkan arah kompas peta. Nilai arah diukur dalam derajat (searah jarum jam) dari arah mata angin Utara. Jika peta belum diinisialisasi, hasilnya adalah undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Parameter: Tidak ada
Nilai yang Ditampilkan:
boolean|null Menampilkan apakah interaksi judul diaktifkan atau tidak. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak disetel dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia). |
getInternalUsageAttributionIds |
getInternalUsageAttributionIds() Parameter: Tidak ada
Nilai yang Ditampilkan:
Iterable<string>|null Menampilkan daftar ID atribusi penggunaan, yang membantu Google memahami library dan contoh mana yang bermanfaat bagi developer, seperti penggunaan library pengelompokan penanda. |
getMapCapabilities |
getMapCapabilities() Parameter: Tidak ada
Nilai yang Ditampilkan:
MapCapabilities Memberi tahu pemanggil tentang kemampuan saat ini yang tersedia untuk peta berdasarkan ID peta yang diberikan. |
getMapTypeId |
getMapTypeId() Parameter: Tidak ada
Nilai yang Ditampilkan:
MapTypeId|string|undefined |
getProjection |
getProjection() Parameter: Tidak ada
Nilai yang Ditampilkan:
Projection|undefined Menampilkan Projection saat ini. Jika peta belum diinisialisasi, hasilnya adalah undefined . Proses peristiwa projection_changed dan periksa nilainya untuk memastikan nilainya bukan undefined . |
getRenderingType |
getRenderingType() Parameter: Tidak ada
Nilai yang Ditampilkan:
RenderingType Menampilkan RenderingType peta saat ini. |
getStreetView |
getStreetView() Parameter: Tidak ada
Nilai yang Ditampilkan:
StreetViewPanorama Panorama yang terikat ke peta.Menampilkan batas StreetViewPanorama default yang terikat ke peta, yang mungkin berupa 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 yang Ditampilkan:
number|undefined Menampilkan sudut datang peta saat ini, dalam derajat dari bidang area tampilan 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 . Lihat setTilt untuk mengetahui detailnya. |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Parameter: Tidak ada
Nilai yang Ditampilkan:
boolean|null Menampilkan apakah interaksi kemiringan diaktifkan atau tidak. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak disetel dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia). |
getZoom |
getZoom() Parameter: Tidak ada
Nilai yang Ditampilkan:
number|undefined Menampilkan zoom peta. Jika zoom belum disetel, hasilnya adalah undefined . |
moveCamera |
moveCamera(cameraOptions) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Segera menyetel kamera peta ke opsi kamera target, tanpa animasi. |
panBy |
panBy(x, y) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Mengubah pusat peta dengan jarak tertentu dalam piksel. Jika jaraknya kurang dari lebar dan tinggi peta, transisi akan dianimasikan dengan lancar. Perhatikan bahwa sistem koordinat peta meningkat dari barat ke timur (untuk nilai x) dan utara ke selatan (untuk nilai y). |
panTo |
panTo(latLng) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Mengubah pusat peta ke LatLng yang diberikan. Jika perubahan kurang dari lebar dan tinggi peta, transisi akan dianimasikan dengan lancar. |
panToBounds |
panToBounds(latLngBounds[, padding]) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Menggeser peta dengan jumlah minimum yang diperlukan untuk memuat LatLngBounds yang diberikan. Tidak ada jaminan di mana batas akan berada di peta, kecuali bahwa peta akan di-pan untuk menampilkan batas sebanyak mungkin di dalam {currentMapSizeInPx} - {padding} . Untuk peta raster dan vektor, zoom, kemiringan, dan arah peta tidak akan diubah. |
setCenter |
setCenter(latlng) Parameter:
Nilai yang Ditampilkan: Tidak Ada
|
setClickableIcons |
setClickableIcons(value) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Mengontrol apakah ikon peta dapat diklik atau tidak. Ikon peta merepresentasikan lokasi menarik, yang juga dikenal sebagai POI. Untuk menonaktifkan kemampuan ikon peta untuk diklik, teruskan nilai false ke metode ini. |
setHeading |
setHeading(heading) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Menetapkan arah kompas untuk peta yang diukur dalam derajat dari arah mata angin Utara. Untuk peta raster, metode ini hanya berlaku untuk gambar udara. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Menetapkan apakah interaksi judul diaktifkan. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak disetel dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia). |
setMapTypeId |
setMapTypeId(mapTypeId) Parameter:
Nilai yang Ditampilkan: Tidak Ada
|
setOptions |
setOptions(options) Parameter:
Nilai yang Ditampilkan: Tidak Ada
|
setRenderingType |
setRenderingType(renderingType) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Menetapkan RenderingType peta saat ini. |
setStreetView |
setStreetView(panorama) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Mengikat StreetViewPanorama ke peta. Panorama ini menggantikan StreetViewPanorama default, sehingga peta dapat terikat ke panorama eksternal di luar peta. Menyetel panorama ke null akan mengikat kembali panorama sematan default ke peta. |
setTilt |
setTilt(tilt) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Untuk peta vektor, menetapkan sudut datangnya peta. Nilai yang diizinkan dibatasi bergantung pada tingkat zoom peta. Untuk peta raster, mengontrol perilaku peralihan otomatis untuk sudut datangnya peta. Satu-satunya nilai yang diizinkan adalah 0 dan 45 . setTilt(0) menyebabkan peta selalu menggunakan tampilan atas 0° terlepas dari tingkat zoom dan area pandang. setTilt(45) menyebabkan sudut kemiringan otomatis beralih ke 45 setiap kali gambar 45° tersedia untuk tingkat zoom dan area tampilan 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 , di 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() properti tilt ; melakukannya dapat menghasilkan efek yang tidak dapat diprediksi. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Menetapkan apakah interaksi kemiringan diaktifkan atau tidak. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak disetel dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia). |
setZoom |
setZoom(zoom) Parameter:
Nilai yang Ditampilkan: Tidak Ada
Menetapkan zoom peta. |
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Acara | |
---|---|
bounds_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat batas viewport telah berubah. |
center_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat properti pusat peta berubah. |
click |
function(event) Argumen:
Peristiwa ini diaktifkan saat pengguna mengklik peta. MapMouseEvent dengan properti untuk lokasi yang diklik akan ditampilkan kecuali jika ikon tempat diklik, dalam hal ini IconMouseEvent dengan ID tempat akan ditampilkan. IconMouseEvent dan MapMouseEvent identik, kecuali IconMouseEvent memiliki kolom ID tempat. Peristiwa selalu dapat diperlakukan sebagai MapMouseEvent jika ID tempat tidak penting. Peristiwa klik tidak diaktifkan jika penanda atau jendela info diklik. |
contextmenu |
function(event) Argumen:
Peristiwa ini dipicu saat peristiwa contextmenu DOM dipicu di penampung peta. |
dblclick |
function(event) Argumen:
Peristiwa ini diaktifkan saat pengguna mengklik dua kali pada peta. Perhatikan bahwa peristiwa klik terkadang dipicu satu kali dan terkadang dua kali, tepat sebelum peristiwa ini. |
drag |
function() Argumen: Tidak ada
Peristiwa ini dipicu berulang kali saat pengguna menarik peta. |
dragend |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat pengguna berhenti menarik peta. Catatan: dragend TIDAK diaktifkan saat pengguna berhenti menggeser peta menggunakan keyboard. Gunakan peristiwa Map.idle untuk menentukan kapan pengguna berhenti menggeser ATAU menarik peta. |
dragstart |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat pengguna mulai menarik peta. |
heading_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat properti heading peta berubah. |
idle |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat peta menjadi tidak aktif setelah menggeser atau melakukan zoom. |
isfractionalzoomenabled_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat properti isFractionalZoomEnabled telah berubah. |
mapcapabilities_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat kemampuan peta berubah. |
maptypeid_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat properti mapTypeId berubah. |
mousemove |
function(event) Argumen:
Peristiwa ini diaktifkan setiap kali kursor mouse pengguna bergerak di atas penampung peta. |
mouseout |
function(event) Argumen:
Peristiwa ini diaktifkan saat kursor pengguna keluar dari penampung peta. |
mouseover |
function(event) Argumen:
Peristiwa ini diaktifkan saat kursor pengguna memasuki penampung peta. |
projection_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat proyeksi telah berubah. |
renderingtype_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat renderingType telah berubah. |
tilesloaded |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat ubin yang terlihat selesai dimuat. |
tilt_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat properti kemiringan peta berubah. |
zoom_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat properti zoom peta berubah. |
|
function(event) Argumen:
Peristiwa ini diaktifkan saat pengguna mengklik kanan peta. |
MapOptions interface
google.maps.MapOptions
interface
Objek MapOptions yang digunakan untuk menentukan properti yang dapat ditetapkan di Peta.
Properti | |
---|---|
backgroundColor optional |
Jenis:
string optional Warna yang digunakan untuk latar belakang div Peta. Warna ini akan terlihat saat petak belum dimuat saat pengguna melakukan penggeseran. Opsi ini hanya dapat ditetapkan saat peta diinisialisasi. |
cameraControl optional |
Jenis:
boolean optional Status aktif/nonaktif kontrol Kamera. |
cameraControlOptions optional |
Jenis:
CameraControlOptions optional Opsi tampilan untuk Kontrol kamera. |
center optional |
Jenis:
LatLng|LatLngLiteral optional Pusat Peta awal. |
clickableIcons optional |
Jenis:
boolean optional Default:
true Saat false , ikon peta tidak dapat diklik. Ikon peta merepresentasikan lokasi menarik, yang juga dikenal sebagai POI. |
colorScheme optional |
Jenis:
ColorScheme|string optional Default:
ColorScheme.LIGHT Skema warna Peta awal. Opsi ini hanya dapat ditetapkan saat peta diinisialisasi. |
controlSize optional |
Jenis:
number optional Ukuran dalam piksel kontrol yang muncul di peta. Nilai ini harus diberikan secara langsung saat membuat Peta. Jika nilai ini diupdate nanti, kontrol dapat berada dalam 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 ganda. 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 css cursor untuk mengubah ikon. Seperti 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 css cursor untuk mengubah ikon. Seperti 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 aktif/nonaktif kontrol Layar penuh. |
fullscreenControlOptions optional |
Jenis:
FullscreenControlOptions optional Opsi tampilan untuk Kontrol layar penuh. |
gestureHandling optional |
Jenis:
string optional Setelan ini mengontrol cara API menangani gestur di peta. Nilai yang diizinkan:
|
heading optional |
Jenis:
number optional Arah untuk gambar udara dalam derajat yang diukur searah jarum jam dari arah mata angin Utara. Judul disesuaikan ke sudut terdekat yang tersedia dan memiliki gambar. |
headingInteractionEnabled optional |
Jenis:
boolean optional Default:
false Apakah peta harus mengizinkan kontrol pengguna terhadap arah kamera (rotasi). Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak disetel dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia). |
internalUsageAttributionIds optional |
Jenis:
Iterable<string> optional Default:
null Menambahkan ID atribusi penggunaan ke penginisialisasi, yang membantu Google memahami library dan contoh mana yang bermanfaat bagi developer, seperti penggunaan library pengelompokan penanda. Untuk memilih tidak mengirimkan ID atribusi penggunaan, Anda dapat menghapus properti ini atau mengganti nilainya dengan string kosong. Hanya nilai unik yang akan dikirim. Perubahan pada nilai ini setelah instansiasi dapat diabaikan. |
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 setelan default telah ditetapkan. |
keyboardShortcuts optional |
Jenis:
boolean optional Jika false , mencegah peta dikontrol oleh keyboard. Pintasan keyboard diaktifkan secara default. |
mapId optional |
Jenis:
string optional ID peta peta. Parameter ini tidak dapat ditetapkan atau diubah setelah peta di-instansiasi. Map.DEMO_MAP_ID dapat digunakan untuk mencoba fitur yang memerlukan ID peta, tetapi tidak memerlukan pengaktifan cloud. |
mapTypeControl optional |
Jenis:
boolean optional Status awal aktif/nonaktif dari kontrol Jenis peta. |
mapTypeControlOptions optional |
Jenis:
MapTypeControlOptions optional Opsi tampilan awal untuk kontrol jenis Peta. |
mapTypeId optional |
Jenis:
MapTypeId|string optional MapTypeId peta awal. Default-nya adalah ROADMAP . |
maxZoom optional |
Jenis:
number optional Tingkat zoom maksimum yang akan ditampilkan di peta. Jika tidak disertakan, 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 di peta. Jika tidak disertakan, atau disetel 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 hapus konten div Peta. |
|