Maps

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.

Map
Map(mapDiv[, opts])
Parameter: 
Membuat peta baru di dalam penampung HTML tertentu, yang biasanya merupakan elemen DIV.
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 Gaya Visual Cloud).
controls
Kontrol tambahan untuk dilampirkan ke peta. Untuk menambahkan kontrol pada 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
Registry instance MapType berdasarkan ID string.
overlayMapTypes
Jenis:  MVCArray<MapType optional>
Jenis peta tambahan ke overlay. Jenis peta overlay akan ditampilkan di atas peta dasar yang melampirkannya, sesuai dengan urutan kemunculannya dalam array overlayMapTypes (overlay dengan nilai indeks yang lebih tinggi ditampilkan di depan overlay dengan nilai indeks yang lebih rendah).
fitBounds
fitBounds(bounds[, padding])
Parameter: 
  • boundsLatLngBounds|LatLngBoundsLiteral Batas untuk ditampilkan.
  • paddingnumber|Padding optional Padding dalam piksel. Batas akan pas di bagian peta yang tetap ada setelah padding dihapus. Nilai angka akan menghasilkan padding yang sama di 4 sisinya. Sediakan 0 di sini untuk membuat fitBounds menjadi idempoten pada hasil getBounds.
Nilai Hasil: Tidak ada
Menyetel area pandang agar memuat batas yang ditentukan.
Catatan: Jika peta ditetapkan 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, 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 mulus saat peta digeser dan di-zoom agar sesuai dengan batas. Dapat dianimasikan atau tidak metode ini bergantung pada heuristik internal.
getBounds
getBounds()
Parameter: Tidak ada
Nilai Hasil:  LatLngBounds|undefined Batas lat/lng area pandang saat ini.
Menampilkan batas lat/lng area pandang saat ini. Jika lebih dari satu salinan dunia terlihat, batas rentang dalam bujur mulai dari -180 hingga 180 derajat inklusif. Jika peta belum diinisialisasi atau dipusatkan dan zoom belum ditetapkan, hasilnya adalah undefined. Untuk peta vektor dengan kemiringan atau arah bukan nol, batas lat/lng yang ditampilkan mewakili kotak pembatas terkecil yang menyertakan wilayah yang terlihat dari area pandang peta. Lihat MapCanvasProjection.getVisibleRegion untuk mendapatkan wilayah persis yang terlihat di area pandang peta.
getCenter
getCenter()
Parameter: Tidak ada
Nilai Hasil:  LatLng|undefined
Menampilkan posisi yang ditampilkan di tengah peta. Perlu diketahui bahwa objek LatLng ini tidak digabungkan. Baca LatLng untuk mengetahui informasi selengkapnya. Jika pusat atau batas belum ditetapkan, hasilnya adalah undefined.
getClickableIcons
getClickableIcons()
Parameter: Tidak ada
Nilai Hasil:  boolean|undefined
Menampilkan kemampuan diklik ikon peta. Ikon peta merepresentasikan lokasi menarik, yang juga dikenal sebagai POI. Jika nilai yang ditampilkan adalah true, ikon dapat diklik pada peta.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parameter: 
  • datasetIdstring
Nilai Hasil:  FeatureLayer
Menampilkan FeatureLayer untuk datasetId yang ditentukan. ID set data harus dikonfigurasi di Google Cloud Console. Jika ID set data tidak dikaitkan 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 Visual Berbasis Data atau Set Data yang dikonfigurasi di Gaya Peta), ini akan mencatat error dalam log, dan FeatureLayer.isAvailable yang dihasilkan akan bernilai 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 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 ubin vektor, dan tidak ada FeatureLayer yang diaktifkan di gaya peta), tindakan ini akan mencatat error ke dalam log, dan FeatureLayer.isAvailable yang dihasilkan akan bernilai salah.
getHeading
getHeading()
Parameter: Tidak ada
Nilai Hasil:  number|undefined
Menampilkan judul kompas pada peta. Nilai arah tujuan diukur dalam derajat (searah jarum jam) dari arah mata angin ke 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 memastikannya bukan undefined.
getRenderingType
getRenderingType()
Parameter: Tidak ada
Nilai Hasil:  RenderingType
Menampilkan RenderingType peta saat ini.
getStreetView
getStreetView()
Parameter: Tidak ada
Nilai Hasil:  StreetViewPanorama Panorama yang terikat ke peta.
Menampilkan 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 tercermin 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. Lihat setTilt untuk mengetahui detailnya.
getZoom
getZoom()
Parameter: Tidak ada
Nilai Hasil:  number|undefined
Menampilkan zoom peta. Jika zoom belum disetel, hasilnya adalah undefined.
moveCamera
moveCamera(cameraOptions)
Parameter: 
Nilai Hasil: Tidak ada
Segera menetapkan kamera peta ke opsi kamera target, tanpa animasi.
panBy
panBy(x, y)
Parameter: 
  • xnumber Jumlah piksel untuk menggeser peta ke arah x.
  • ynumber Jumlah piksel untuk menggerakkan peta ke arah y.
Nilai Hasil: Tidak ada
Mengubah bagian tengah peta menurut jarak yang ditetapkan dalam piksel. Jika jaraknya kurang dari lebar dan tinggi peta, transisi akan dianimasikan dengan mulus. Perhatikan, 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 mulus.
panToBounds
panToBounds(latLngBounds[, padding])
Parameter: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral Batas untuk menggeser peta.
  • paddingnumber|Padding optional Padding dalam piksel. Nilai angka akan menghasilkan padding yang sama di 4 sisinya. Nilai defaultnya adalah 0.
Nilai Hasil: Tidak ada
Menggeser peta sebesar jumlah minimum yang diperlukan untuk memuat LatLngBounds yang ditentukan. Tindakan ini tidak menjamin di mana batas akan berada di peta, kecuali bahwa peta akan digeser 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 Hasil: Tidak ada
setClickableIcons
setClickableIcons(value)
Parameter: 
  • valueboolean
Nilai Hasil: Tidak ada
Mengontrol apakah ikon peta dapat diklik atau tidak. Ikon peta merepresentasikan lokasi menarik, yang juga dikenal sebagai POI. Untuk menonaktifkan kemampuan diklik ikon peta, teruskan nilai false ke metode ini.
setHeading
setHeading(heading)
Parameter: 
  • headingnumber
Nilai Hasil: Tidak ada
Menyetel arah kompas untuk peta yang diukur dalam derajat dari arah mata angin Utara. Untuk peta raster, metode ini hanya berlaku untuk 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 menggantikan StreetViewPanorama default, sehingga peta dapat diikat ke panorama eksternal di luar peta. Menyetel panorama ke null akan mengikat panorama tersemat kembali ke peta.
setTilt
setTilt(tilt)
Parameter: 
  • tiltnumber
Nilai Hasil: Tidak ada
Untuk peta vektor, tetapkan sudut timbulnya peta. Nilai yang diizinkan dibatasi bergantung pada tingkat zoom peta. Untuk peta raster, mengontrol perilaku pengalihan otomatis untuk sudut kemunculan peta. Satu-satunya nilai yang diizinkan adalah 0 dan 45. setTilt(0) menyebabkan peta selalu menggunakan tampilan dari atas 0°, apa pun 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, 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 melakukan bind() pada properti tilt; jika demikian, hal tersebut dapat menghasilkan efek yang tidak dapat diprediksi.
setZoom
setZoom(zoom)
Parameter: 
  • zoomnumber Nilai zoom yang lebih besar akan menghasilkan resolusi yang lebih tinggi.
Nilai Hasil: Tidak ada
Menetapkan zoom peta.
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Argumen: Tidak ada
Peristiwa ini dipicu saat batas area pandang telah berubah.
center_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti pusat peta berubah.
click
function(event)
Argumen: 
Peristiwa ini dipicu 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, hanya saja IconMouseEvent memiliki kolom ID tempat. Peristiwa selalu dapat diperlakukan sebagai MapMouseEvent jika ID tempat tidak penting. Peristiwa klik tidak akan diaktifkan jika penanda atau jendela info diklik.
contextmenu
function(event)
Argumen: 
Peristiwa ini diaktifkan saat peristiwa menu konteks DOM diaktifkan di penampung peta.
dblclick
function(event)
Argumen: 
Peristiwa ini dipicu saat pengguna mengklik dua kali pada peta. Perhatikan bahwa peristiwa klik terkadang akan diaktifkan sekali dan terkadang dua kali, tepat sebelum peristiwa ini.
drag
function()
Argumen: Tidak ada
Peristiwa ini berulang kali dipicu saat pengguna menarik peta.
dragend
function()
Argumen: Tidak ada
Peristiwa ini akan dipicu saat pengguna berhenti menarik peta.
dragstart
function()
Argumen: Tidak ada
Peristiwa ini akan dipicu saat pengguna mulai menarik peta.
heading_changed
function()
Argumen: Tidak ada
Peristiwa ini akan dipicu saat properti arah peta berubah.
idle
function()
Argumen: Tidak ada
Peristiwa ini dipicu saat peta menjadi tidak ada aktivitas setelah menggeser atau melakukan zoom.
isfractionalzoomenabled_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti isFractionalZoomEnabled telah berubah.
mapcapabilities_changed
function()
Argumen: Tidak ada
Peristiwa ini akan dipicu saat kemampuan peta berubah.
maptypeid_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti mapTypeId berubah.
mousemove
function(event)
Argumen: 
Peristiwa ini akan diaktifkan setiap kali mouse pengguna bergerak di atas penampung peta.
mouseout
function(event)
Argumen: 
Peristiwa ini akan dipicu saat mouse pengguna keluar dari penampung peta.
mouseover
function(event)
Argumen: 
Peristiwa ini akan diaktifkan saat mouse pengguna memasuki penampung peta.
projection_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat proyeksi telah berubah.
renderingtype_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat renderingType telah berubah.
tilesloaded
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat ubin yang terlihat telah 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.
rightclick
function(event)
Argumen: 
Peristiwa ini dipicu saat pengguna mengklik kanan pada peta.

Antarmuka MapOptions

Antarmuka google.maps.MapOptions

Objek MapOptions yang digunakan untuk mendefinisikan properti yang dapat ditetapkan pada Map.

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 saat peta diinisialisasi.
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.
controlSize optional
Jenis:  number optional
Ukuran dalam piksel kontrol yang muncul pada peta. Nilai ini harus diberikan langsung saat membuat Peta. Memperbarui nilai ini nanti dapat membuat kontrol menjadi 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 saat klik dua kali. Diaktifkan secara default.

Catatan: Properti ini tidak direkomendasikan. Untuk menonaktifkan zoom dengan klik dua kali, Anda dapat menggunakan properti gestureHandling, dan menetapkannya ke "none".

draggable optional
Jenis:  boolean optional
Jika false, mencegah peta ditarik. Menarik 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 properti CSS, Anda harus menentukan setidaknya satu kursor penggantian 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 properti CSS, Anda harus menentukan setidaknya satu kursor penggantian yang bukan URL. Contoh: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Jenis:  boolean optional
Status diaktifkan/dinonaktifkan 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 pada peta. Nilai yang diizinkan:
  • "cooperative": Peristiwa scroll dan gestur sentuh satu jari men-scroll halaman, dan jangan melakukan zoom atau menggeser peta. Gestur sentuh dua jari menggeser dan melakukan zoom pada peta. Scroll peristiwa dengan tombol ctrl atau tombol ⌘ yang ditekan untuk zoom peta.
    Dalam mode ini, peta bekerja sama dengan halaman.
  • "greedy": Semua gestur sentuh dan peristiwa scroll menggeser atau melakukan zoom pada peta.
  • "none": Peta tidak dapat digeser atau di-zoom oleh gestur pengguna.
  • "auto": (default) Penanganan gestur bersifat kooperatif atau serakah, bergantung pada apakah halaman dapat di-scroll atau dalam iframe.
heading optional
Jenis:  number optional
Arah untuk citra udara dalam derajat yang diukur searah jarum jam dari arah mata angin ke Utara. Arah dipaskan ke sudut terdekat yang tersedia yang gambarnya tersedia.
isFractionalZoomEnabled optional
Jenis:  boolean optional
Default: true untuk peta vektor dan false untuk peta raster
Apakah 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 dari peta. Parameter ini tidak dapat ditetapkan atau diubah setelah instance peta dibuat.
mapTypeControl optional
Jenis:  boolean optional
Status awal diaktifkan/dinonaktifkan untuk 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 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 di 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 hapus konten div Map.
panControl optional
Jenis:  boolean optional
Status diaktifkan/dinonaktifkan pada Kontrol Pan.

panControlOptions optional
Jenis:  PanControlOptions optional
Opsi tampilan untuk kontrol Geser.

restriction optional
Jenis:  MapRestriction optional
Menentukan batas yang membatasi area peta yang dapat diakses oleh pengguna. Jika disetel, pengguna hanya dapat menggeser dan melakukan zoom saat tampilan kamera tetap berada dalam batas batas.
rotateControl optional
Jenis:  boolean optional
Status diaktifkan/dinonaktifkan dari kontrol Rotasi.
rotateControlOptions optional
Jenis:  RotateControlOptions optional
Opsi tampilan untuk kontrol Rotasi.
scaleControl optional
Jenis:  boolean optional
Status awal diaktifkan/dinonaktifkan dari kontrol Scale.
scaleControlOptions optional
Jenis:  ScaleControlOptions optional
Opsi tampilan awal untuk kontrol Scale.
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 roda scroll, Anda dapat menggunakan properti gestureHandling, dan menyetelnya ke "cooperative" atau "none".

streetView optional
Jenis:  StreetViewPanorama optional
StreetViewPanorama yang akan ditampilkan saat Pegman Street View diletakkan di peta. Jika panorama tidak ditentukan, StreetViewPanorama default akan ditampilkan di div peta saat pegman dilepaskan.
streetViewControl optional
Jenis:  boolean optional
Status awal kontrol Pegman Street View yang diaktifkan/dinonaktifkan. Kontrol ini merupakan bagian dari UI default, dan harus ditetapkan ke false saat menampilkan jenis peta yang tidak boleh menampilkan overlay jalan Street View (mis. jenis peta non-Bumi).
streetViewControlOptions optional
Jenis:  StreetViewControlOptions optional
Opsi tampilan awal untuk kontrol Pegman Street View.
styles optional
Jenis:  Array<MapTypeStyle> optional
Gaya yang akan diterapkan pada setiap jenis peta default. Perhatikan bahwa untuk mode satellite/hybrid dan terrain, gaya ini hanya akan berlaku untuk label dan geometri.
tilt optional
Jenis:  number optional
Untuk peta vektor, tetapkan sudut timbulnya peta. Nilai yang diizinkan dibatasi bergantung pada tingkat zoom peta. Untuk peta raster, mengontrol perilaku pengalihan otomatis untuk sudut kemunculan peta. Satu-satunya nilai yang diizinkan adalah 0 dan 45. Nilai 0 menyebabkan peta selalu menggunakan tampilan dari atas 0°, apa pun tingkat zoom dan area tampilan. Nilai 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, di 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 ini 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 menghasilkan resolusi yang lebih tinggi.
zoomControl optional
Jenis:  boolean optional
Status diaktifkan/dinonaktifkan pada kontrol Zoom.
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">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

Secara internal, kode 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.

MapElement
MapElement([options])
Parameter: 
center
Jenis:  LatLng|LatLngLiteral optional
Lintang/bujur tengah peta.
Atribut HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Jenis:  Map
Referensi ke Map yang digunakan MapElement secara internal.
mapId
Jenis:  string optional
ID Peta dari peta. Lihat dokumentasi ID Peta untuk informasi selengkapnya.
Atribut HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Jenis:  number optional
Tingkat zoom peta.
Atribut HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Menempatkan elemen slot di posisi ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Menempatkan elemen slot di posisi ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Menempatkan elemen slot di posisi ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Menempatkan elemen slot di posisi ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Menempatkan elemen slot di posisi ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Menempatkan elemen slot di posisi ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Menempatkan elemen slot di posisi ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Menempatkan elemen slot di posisi ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Menempatkan elemen slot di posisi ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Menempatkan elemen slot di posisi ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Menempatkan elemen slot di posisi ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Menempatkan elemen slot di posisi ControlPosition.INLINE_START_BLOCK_START.
default
Anda dapat membuat komponen yang dapat digunakan kembali di seluruh Komponen Web Maps JavaScript, seperti AdvancedMarkerElement, menggunakan elemen kustom. Secara default, semua elemen kustom yang ditambahkan langsung ke MapElement akan ditempatkan dan dirender di MapPanes.overlayMouseTarget. Namun, Komponen Web Maps JavaScript API dapat ditempatkan ulang ke slot internal MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String yang peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Objek ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai Hasil:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi
Nilai Hasil:  void
Menghapus pemroses peristiwa yang sebelumnya terdaftar dengan addEventListener dari target. Lihat removeEventListener
gmp-zoomchange
function(event)
Argumen: 
Peristiwa ini dipicu saat properti zoom peta berubah.

Antarmuka MapElementOptions

Antarmuka google.maps.MapElementOptions

Objek MapElementOptions yang digunakan untuk menentukan properti yang dapat disetel di MapElement.

center optional
Jenis:  LatLng|LatLngLiteral optional
Pusat peta awal.
mapId optional
Jenis:  string optional
ID Peta dari 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 menghasilkan resolusi yang lebih tinggi.

ZoomChangeEvent

Class google.maps.ZoomChangeEvent

Peristiwa ini dibuat dari pemantauan perubahan zoom.

Class ini memperluas Event.

Akses dengan memanggil const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). Lihat Library di Maps JavaScript API.

Antarmuka MapTypeStyle

Antarmuka google.maps.MapTypeStyle

MapTypeStyle adalah kumpulan pemilih dan styler yang menentukan cara menata gaya peta. Pemilih menetapkan fitur dan/atau elemen peta yang akan terpengaruh, dan styler menetapkan bagaimana fitur dan elemen tersebut harus dimodifikasi. Untuk mengetahui detailnya, lihat referensi gaya.

stylers
Jenis:  Array<Object>
Aturan gaya yang akan 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 tempat styler harus diterapkan. Elemen adalah aspek visual dari fitur pada peta. Contoh: label, ikon, goresan atau isian yang diterapkan pada geometri, dan lainnya. Opsional. Jika elementType tidak ditentukan, nilainya diasumsikan sebagai 'all'. Untuk mengetahui detail penggunaan dan nilai yang diizinkan, lihat referensi gaya.
featureType optional
Jenis:  string optional
Fitur, atau sekelompok fitur, tempat styler harus diterapkan. Opsional. Jika featureType tidak ditentukan, nilainya diasumsikan sebagai 'all'. Untuk mengetahui detail penggunaan dan nilai yang diizinkan, lihat referensi gaya.

Antarmuka MapMouseEvent

Antarmuka google.maps.MapMouseEvent

Objek ini ditampilkan dari berbagai kejadian mouse pada peta dan overlay, dan berisi semua kolom yang ditampilkan di bawah ini.

domEvent
Peristiwa DOM native yang sesuai. Developer tidak boleh mengandalkan properti target, currentTarget, relatedTarget, dan path yang ditentukan dan konsisten. Developer juga tidak boleh mengandalkan struktur DOM dari implementasi internal Maps API. Karena pemetaan peristiwa internal, domEvent mungkin memiliki semantik yang berbeda dari MapMouseEvent (mis. "klik" MapMouseEvent mungkin memiliki domEvent jenis KeyboardEvent).
latLng optional
Jenis:  LatLng optional
Lintang/bujur yang berada di bawah kursor saat peristiwa terjadi.
stop
stop()
Parameter: Tidak ada
Nilai Hasil:  void
Mencegah peristiwa ini diterapkan lebih lanjut.

Antarmuka IconMouseEvent

Antarmuka google.maps.IconMouseEvent

Objek ini dikirim dalam peristiwa saat pengguna mengklik ikon di peta. ID tempat ini disimpan dalam 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.

placeId optional
Jenis:  string optional
ID tempat dari tempat yang diklik. ID tempat ini dapat digunakan untuk mengajukan kueri informasi lebih lanjut tentang fitur yang diklik.

Pelajari lebih lanjut ID tempat di panduan developer Places API.

Diwariskan: domEvent, latLng
Diwariskan: stop

Konstanta MapTypeId

google.maps.MapTypeId konstanta

ID untuk MapTypes umum. Tentukan ini berdasarkan 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.

HYBRID Jenis peta ini menampilkan lapisan transparan jalan-jalan utama pada citra satelit.
ROADMAP Jenis peta ini menampilkan peta jalan normal.
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

Registri untuk instance MapType, dikunci oleh id MapType.

Class ini memperluas MVCObject.

Akses dengan memanggil const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Lihat Library di Maps JavaScript API.

MapTypeRegistry
MapTypeRegistry()
Parameter: Tidak ada
MapTypeRegistry menyimpan kumpulan jenis peta kustom yang tersedia untuk peta untuk digunakan. Misalnya, API akan berkonsultasi dengan registry ini saat memberikan daftar jenis peta yang tersedia dalam kontrol.
set
set(id, mapType)
Parameter: 
  • idstring ID MapType yang akan ditambahkan ke registry.
  • mapTypeMapType|* objek MapType untuk ditambahkan ke registry.
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

Batasan yang dapat diterapkan pada Peta. Area pandang peta tidak akan melebihi batasan ini.

latLngBounds
Jika disetel, pengguna hanya dapat menggeser dan melakukan zoom di dalam batas yang ditentukan. Batas dapat membatasi bujur dan lintang, atau dapat membatasi lintang saja. Untuk batas hanya lintang, gunakan bujur barat dan timur masing-masing -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 tanda strictBounds ke true. Hal ini mengurangi seberapa jauh pengguna dapat memperkecil, memastikan bahwa segala sesuatu di luar batas yang dibatasi tetap tersembunyi. Defaultnya adalah false, artinya pengguna dapat memperkecil hingga seluruh area yang dibatasi terlihat, mungkin termasuk area di luar area yang dibatasi.

TrafficLayer

Class google.maps.TrafficLayer

Lapisan lalu lintas.

Class ini memperluas MVCObject.

Akses dengan memanggil const {TrafficLayer} = await google.maps.importLibrary("maps"). Lihat Library di Maps JavaScript API.

TrafficLayer
TrafficLayer([opts])
Parameter: 
Lapisan yang menampilkan lalu lintas jalan saat ini.
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 yang digunakan untuk mendefinisikan properti yang dapat disetel pada TrafficLayer.

autoRefresh optional
Jenis:  boolean optional
Default: true
Apakah lapisan lalu lintas dimuat ulang dengan informasi yang diperbarui secara otomatis.
map optional
Jenis:  Map optional
Peta yang akan digunakan untuk menampilkan lapisan lalu lintas.

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.

TransitLayer
TransitLayer()
Parameter: Tidak ada
Lapisan yang menampilkan jalur transit.
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

BicyclingLayer class

Class google.maps.BicyclingLayer

Lapisan yang menampilkan jalur dan beberapa jalur sepeda.

Class ini memperluas MVCObject.

Akses dengan memanggil const {BicyclingLayer} = await google.maps.importLibrary("maps"). Lihat Library di Maps JavaScript API.

BicyclingLayer
BicyclingLayer()
Parameter: Tidak ada
Lapisan yang menampilkan jalur dan jalan sepeda serta mendemosikan jalan besar.
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 menetapkan opsi kamera peta.

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 berupa trapesium, bukan persegi panjang, jika peta vektor memiliki kemiringan.

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

google.maps.RenderingType konstanta

Akses dengan memanggil const {RenderingType} = await google.maps.importLibrary("maps"). Lihat Library di Maps JavaScript API.

RASTER Menunjukkan bahwa peta berupa peta raster.
UNINITIALIZED Menunjukkan bahwa belum diketahui apakah peta berupa vektor atau raster, karena inisialisasi peta belum selesai.
VECTOR Menunjukkan bahwa peta tersebut merupakan peta vektor.

Antarmuka MapCapabilities

Antarmuka google.maps.MapCapabilities

Objek yang berisi snapshot kemampuan yang saat ini tersedia untuk Peta. Perhatikan bahwa ini tidak berarti modul yang relevan dimuat atau diinisialisasi, melainkan bahwa peta saat ini memiliki izin untuk menggunakan API ini. Lihat properti untuk mengetahui daftar kemungkinan kemampuan.

isAdvancedMarkersAvailable optional
Jenis:  boolean optional
Jika true (benar), peta ini akan dikonfigurasi dengan benar untuk memungkinkan penggunaan penanda lanjutan. Perhatikan bahwa Anda tetap harus mengimpor library marker untuk menggunakan penanda lanjutan. Lihat https://goo.gle/gmp-isAdvancedMarkersAvailable untuk 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-styling dan https://goo.gle/gmp-FeatureLayerIsAvailable untuk informasi selengkapnya.