Maps

Class MapElement

google.maps.MapElement class
extends HTMLElement
implements MapElementOptions
library "maps"

MapElement adalah subclass HTMLElement untuk merender peta. Setelah memuat library maps, peta dapat dibuat dalam HTML. Contoh:

<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, class ini menggunakan Map, yang dapat diakses dengan properti MapElement.innerMap.

    
<gmp-map
  center="lat,lng"
  heading-interaction-disabled
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  rendering-type="value-name"
  tilt-interaction-disabled
  zoom="number">
</gmp-map>
const {MapElement} = await google.maps.importLibrary("maps");
MapElement
MapElement([options])
Parameter:
center
attr: center
Jenis: LatLng|LatLngLiteral optional
Lintang/bujur tengah peta.
Atribut HTML: center="lat,lng"
headingInteractionDisabled
attr: heading-interaction-disabled
Jenis: boolean optional
Default: false
Apakah peta harus mengizinkan kontrol pengguna atas arah kamera (rotasi). Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak ditetapkan dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia).
Atribut HTML: heading-interaction-disabled
innerMap
Jenis: Map
Referensi ke Map yang digunakan MapElement secara internal.
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Jenis: Iterable<string> optional
Default: null
Menambahkan ID atribusi penggunaan ke penginisialisasi, yang membantu Google memahami library dan contoh mana yang berguna bagi developer, seperti penggunaan library pengelompokan penanda. Untuk memilih tidak mengirim 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 pembuatan instance dapat diabaikan.
Atribut HTML: internal-usage-attribution-ids="id1 id2"
mapId
attr: map-id
Jenis: string optional
ID peta dari peta. Parameter ini tidak dapat ditetapkan atau diubah setelah peta dibuat instance-nya. Map.DEMO_MAP_ID dapat digunakan untuk mencoba fitur yang memerlukan ID peta, tetapi tidak memerlukan pengaktifan cloud.
Atribut HTML: map-id="string"
renderingType
attr: rendering-type
Jenis: RenderingType optional
Apakah peta harus berupa peta raster atau vektor. Parameter ini tidak dapat ditetapkan atau diubah setelah peta dibuat instance-nya. Jika tidak ditetapkan, konfigurasi cloud untuk ID peta akan menentukan jenis rendering (jika tersedia). Perhatikan bahwa peta vektor mungkin tidak tersedia untuk semua perangkat dan browser, dan peta akan kembali ke peta raster sesuai kebutuhan.
Atribut HTML: rendering-type="value-name"
tiltInteractionDisabled
attr: tilt-interaction-disabled
Jenis: boolean optional
Default: false
Apakah peta harus mengizinkan kontrol pengguna atas kemiringan kamera. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak ditetapkan dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia).
Atribut HTML: tilt-interaction-disabled
zoom
attr: zoom
Jenis: number optional
Tingkat zoom peta. Nilai zoom yang valid adalah angka dari nol hingga tingkat zoom maksimum yang didukung. Nilai zoom yang lebih besar sesuai dengan resolusi yang lebih tinggi.
Atribut HTML: zoom="number"
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 sekitar Komponen Web Maps JavaScript, seperti AdvancedMarkerElement, menggunakan elemen kustom. Secara default, elemen kustom apa pun yang ditambahkan langsung ke MapElement akan ditempatkan dan dirender di MapPanes.overlayMouseTarget. Namun, Komponen Web Maps JavaScript API dapat dimasukkan kembali ke slot internal MapElement.
Diwarisi: addEventListener, 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 ditetapkan di MapElement.

center
opsional
Jenis: LatLng|LatLngLiteral optional
headingInteractionDisabled
opsional
Jenis: boolean optional
internalUsageAttributionIds
opsional
Jenis: Iterable<string> optional
mapId
opsional
Jenis: string optional
renderingType
opsional
Jenis: RenderingType optional
tiltInteractionDisabled
opsional
Jenis: boolean optional
zoom
opsional
Jenis: number optional

Class ZoomChangeEvent

google.maps.ZoomChangeEvent class
extends Event
library "maps"

Peristiwa ini dibuat dari pemantauan perubahan zoom.

const {ZoomChangeEvent} = await google.maps.importLibrary("maps");

Class Map

google.maps.Map class
extends MVCObject
library "maps"

const {Map} = await google.maps.importLibrary("maps");
Map
Map(mapDiv[, opts])
Parameter:
Membuat peta baru di dalam penampung HTML tertentu, yang biasanya berupa 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 ke peta, tambahkan <div> kontrol ke MVCArray yang sesuai dengan ControlPosition tempat kontrol tersebut akan dirender.
data
Jenis: Data
Instance Data, yang 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 yang akan ditempatkan. 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).
fitBounds
fitBounds(bounds[, padding])
Parameter:
  • bounds: LatLngBounds|LatLngBoundsLiteral Batas yang akan ditampilkan.
  • padding: number|Padding optional Padding dalam piksel. Batas akan disesuaikan di bagian peta yang tersisa setelah padding dihapus. Nilai angka akan menghasilkan padding yang sama di keempat sisi. Berikan nilai 0 di sini untuk membuat fitBounds idempoten pada hasil getBounds.
Nilai Hasil: Tidak ada
Menetapkan area pandang untuk 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, tetapkan peta ke visibility: hidden, sehingga memastikan div peta memiliki ukuran sebenarnya. Untuk peta vektor, metode ini menetapkan kemiringan dan arah peta ke nilai default nol. Memanggil metode ini dapat menyebabkan animasi yang mulus saat peta digeser dan diperbesar/diperkecil 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 lintang/bujur area pandang saat ini.
Menampilkan batas lintang/bujur area pandang saat ini. Jika lebih dari satu salinan dunia terlihat, batas rentang bujur dari -180 hingga 180 derajat inklusif. Jika peta belum diinisialisasi atau pusat 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 dari area pandang peta.
getCenter
getCenter()
Parameter: Tidak ada
Nilai Hasil: LatLng|undefined
Menampilkan posisi yang ditampilkan di tengah peta. Perhatikan 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 apakah ikon peta dapat diklik atau tidak. Ikon peta merepresentasikan lokasi menarik, yang juga dikenal sebagai POI. Jika nilai yang ditampilkan adalah true, ikon dapat diklik di peta.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parameter:
  • datasetId: string
Nilai Hasil: FeatureLayer
Menampilkan FeatureLayer untuk datasetId yang ditentukan. ID set data harus dikonfigurasi di Konsol Google Cloud. Jika ID set data tidak terkait dengan gaya 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), hal ini akan mencatat error, dan FeatureLayer.isAvailable yang dihasilkan akan salah.
getDiv
getDiv()
Parameter: Tidak ada
Nilai Hasil: HTMLElement MapDiv 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 dalam gaya peta), hal ini akan mencatat error, dan FeatureLayer.isAvailable yang dihasilkan akan salah.
getHeading
getHeading()
Parameter: Tidak ada
Nilai Hasil: 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 Hasil: boolean|null
Menampilkan apakah interaksi judul diaktifkan. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak ditetapkan dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Parameter: Tidak ada
Nilai Hasil: Iterable<string>|null
Menampilkan daftar ID atribusi penggunaan, yang membantu Google memahami library dan contoh yang berguna bagi developer, seperti penggunaan library pengelompokan penanda.
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 nilainya 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 terlihat dalam tampilan panorama terikat tersebut.
getTilt
getTilt()
Parameter: Tidak ada
Nilai Hasil: number|undefined
Menampilkan sudut datang 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.
getTiltInteractionEnabled
getTiltInteractionEnabled()
Parameter: Tidak ada
Nilai Hasil: boolean|null
Menampilkan apakah interaksi miring diaktifkan. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak ditetapkan dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia).
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 menyetel kamera peta ke opsi kamera target, tanpa animasi.
panBy
panBy(x, y)
Parameter:
  • x: number Jumlah piksel untuk memindahkan peta ke arah x.
  • y: number Jumlah piksel untuk memindahkan peta ke arah y.
Nilai Hasil: Tidak ada
Mengubah pusat peta berdasarkan jarak yang ditentukan 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 Hasil: 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:
  • latLngBounds: LatLngBounds|LatLngBoundsLiteral Batas untuk menggeser peta.
  • padding: number|Padding optional Padding dalam piksel. Nilai angka akan menghasilkan padding yang sama di keempat sisi. Nilai defaultnya adalah 0.
Nilai Hasil: 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 digeser untuk menampilkan sebanyak mungkin batas di dalam {currentMapSizeInPx} - {padding}. Untuk peta raster dan peta vektor, zoom, kemiringan, dan arah peta tidak akan diubah.
setCenter
setCenter(latlng)
Parameter:
Nilai Hasil: Tidak ada
setClickableIcons
setClickableIcons(value)
Parameter:
  • value: boolean
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 klik ikon peta, teruskan nilai false ke metode ini.
setHeading
setHeading(heading)
Parameter:
  • heading: number
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 untuk citra udara.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
Parameter:
  • headingInteractionEnabled: boolean
Nilai Hasil: Tidak ada
Menetapkan apakah interaksi judul diaktifkan. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak ditetapkan dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia).
setMapTypeId
setMapTypeId(mapTypeId)
Parameter:
Nilai Hasil: Tidak ada
setOptions
setOptions(options)
Parameter:
Nilai Hasil: Tidak ada
setRenderingType
setRenderingType(renderingType)
Parameter:
Nilai Hasil: Tidak ada
Menetapkan RenderingType peta saat ini.
setStreetView
setStreetView(panorama)
Parameter:
Nilai Hasil: Tidak ada
Mengikat StreetViewPanorama ke peta. Panorama ini menggantikan StreetViewPanorama default, sehingga peta dapat terikat ke panorama eksternal di luar peta. Menetapkan panorama ke null akan mengikat panorama tersemat default kembali ke peta.
setTilt
setTilt(tilt)
Parameter:
  • tilt: number
Nilai Hasil: Tidak ada
Untuk peta vektor, menetapkan sudut datang peta. Nilai yang diizinkan dibatasi bergantung pada tingkat zoom peta.

Untuk peta raster, mengontrol perilaku pengalihan otomatis untuk sudut datang 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 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 bind() properti tilt; tindakan ini dapat menghasilkan efek yang tidak dapat diprediksi.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Parameter:
  • tiltInteractionEnabled: boolean
Nilai Hasil: Tidak ada
Menetapkan apakah interaksi miring diaktifkan. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak ditetapkan dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia).
setZoom
setZoom(zoom)
Parameter:
  • zoom: number Nilai zoom yang lebih besar sesuai dengan resolusi yang lebih tinggi.
Nilai Hasil: Tidak ada
Menetapkan zoom peta.
Diwarisi: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
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 diaktifkan saat pengguna mengklik peta. MapMouseEvent dengan properti untuk lokasi yang diklik akan ditampilkan, kecuali jika ikon tempat diklik, yang akan menampilkan IconMouseEvent dengan ID tempat. IconMouseEvent dan MapMouseEvent identik, kecuali IconMouseEvent memiliki kolom ID tempat. Peristiwa ini 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 diaktifkan saat peristiwa contextmenu DOM diaktifkan di penampung peta.
dblclick
function(event)
Argumen:
Peristiwa ini diaktifkan 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 diaktifkan 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 arah peta berubah.
idle
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat peta menjadi tidak ada aktivitas setelah digeser atau diperbesar.
isfractionalzoomenabled_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan 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 mouse pengguna bergerak di atas penampung peta.
mouseout
function(event)
Argumen:
Peristiwa ini diaktifkan saat mouse pengguna keluar dari penampung peta.
mouseover
function(event)
Argumen:
Peristiwa ini 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 berubah.
tilesloaded
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan 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 saat properti zoom peta berubah.
rightclick
function(event)
Argumen:
Peristiwa ini diaktifkan saat pengguna mengklik kanan peta.

Antarmuka MapOptions

Antarmuka google.maps.MapOptions

Objek MapOptions yang digunakan untuk menentukan properti yang dapat ditetapkan di Peta.

backgroundColor
opsional
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.
cameraControl
opsional
Jenis: boolean optional
Status diaktifkan/dinonaktifkan dari kontrol Kamera.
cameraControlOptions
opsional
Jenis: CameraControlOptions optional
Opsi tampilan untuk kontrol Kamera.
center
opsional
Jenis: LatLng|LatLngLiteral optional
Pusat Peta awal.
clickableIcons
opsional
Jenis: boolean optional
Default: true
Jika false, ikon peta tidak dapat diklik. Ikon peta merepresentasikan lokasi menarik, yang juga dikenal sebagai POI.
colorScheme
opsional
Jenis: ColorScheme|string optional
Skema warna Peta awal. Opsi ini hanya dapat ditetapkan saat peta diinisialisasi.
controlSize
opsional
Jenis: number optional
Ukuran dalam piksel untuk kontrol yang muncul di peta. Nilai ini harus diberikan langsung saat membuat Peta. Memperbarui nilai ini nanti dapat membuat kontrol berada dalam status undefined. Hanya mengatur kontrol yang dibuat oleh Maps API itu sendiri. Tidak menskalakan kontrol kustom yang dibuat developer.
disableDefaultUI
opsional
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
opsional
Jenis: boolean optional
Mengaktifkan/menonaktifkan zoom dan pemusatan saat mengklik dua kali. Diaktifkan secara default.

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

draggable
opsional
Jenis: boolean optional
Jika false, mencegah peta ditarik dan diperbesar/diperkecil dengan gestur sentuh dan mouse. Penyeretan diaktifkan secara default.
draggableCursor
opsional
Jenis: string optional
Nama atau URL kursor yang akan ditampilkan saat mengarahkan mouse ke peta yang dapat ditarik. Properti ini menggunakan atribut cursor CSS 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
opsional
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 pengganti yang bukan URL. Contoh: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl
opsional
Jenis: boolean optional
Status aktif/nonaktif kontrol Layar penuh.
fullscreenControlOptions
opsional
Jenis: FullscreenControlOptions optional
Opsi tampilan untuk kontrol Layar penuh.
gestureHandling
opsional
Jenis: string optional
Setelan ini mengontrol cara API menangani gestur di peta. Nilai yang diizinkan:
  • "cooperative": Peristiwa scroll dan gestur sentuh satu jari akan men-scroll halaman, dan tidak memperbesar atau menggeser peta. Gestur sentuh dua jari menggeser dan memperbesar/memperkecil peta. Peristiwa scroll dengan tombol ctrl atau tombol ⌘ yang ditekan akan memperbesar atau memperkecil peta.
    Dalam mode ini, peta bekerja sama dengan halaman.
  • "greedy": Semua gestur sentuh dan peristiwa scroll akan menggeser atau men-zoom peta.
  • "none": Peta tidak dapat digeser atau di-zoom dengan gestur pengguna.
  • "auto": (default) Penanganan gestur bersifat kooperatif atau greedy, bergantung pada apakah halaman dapat di-scroll atau berada dalam iframe.
heading
opsional
Jenis: number optional
Heading untuk citra udara dalam derajat yang diukur searah jarum jam dari arah mata angin Utara. Judul disesuaikan dengan sudut terdekat yang tersedia untuk citra yang tersedia.
headingInteractionEnabled
opsional
Jenis: boolean optional
Default: false
Apakah peta harus mengizinkan kontrol pengguna atas arah kamera (rotasi). Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak ditetapkan dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia).
internalUsageAttributionIds
opsional
Jenis: Iterable<string> optional
Default: null
Menambahkan ID atribusi penggunaan ke penginisialisasi, yang membantu Google memahami library dan contoh mana yang berguna bagi developer, seperti penggunaan library pengelompokan penanda. Untuk memilih tidak mengirim 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 pembuatan instance dapat diabaikan.
isFractionalZoomEnabled
opsional
Jenis: boolean optional
Default: true untuk peta vektor dan false untuk peta raster
Menentukan apakah peta harus mengizinkan tingkat zoom pecahan. Proses isfractionalzoomenabled_changed untuk mengetahui kapan default telah ditetapkan.
keyboardShortcuts
opsional
Jenis: boolean optional
Jika false, mencegah peta dikontrol oleh keyboard. Pintasan keyboard diaktifkan secara default.
mapId
opsional
Jenis: string optional
ID peta dari peta. Parameter ini tidak dapat ditetapkan atau diubah setelah peta dibuat instance-nya. Map.DEMO_MAP_ID dapat digunakan untuk mencoba fitur yang memerlukan ID peta, tetapi tidak memerlukan pengaktifan cloud.
mapTypeControl
opsional
Jenis: boolean optional
Status awal diaktifkan/dinonaktifkan dari kontrol Jenis peta.
mapTypeControlOptions
opsional
Jenis: MapTypeControlOptions optional
Opsi tampilan awal untuk kontrol Map type.
mapTypeId
opsional
Jenis: MapTypeId|string optional
mapTypeId Peta awal. Default-nya adalah ROADMAP.
maxZoom
opsional
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
opsional
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
opsional
Jenis: boolean optional
Jika true, jangan hapus konten div Peta.
panControl
opsional
Jenis: boolean optional
Status diaktifkan/dinonaktifkan dari kontrol Geser.

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

renderingType
opsional
Jenis: RenderingType optional
Apakah peta harus berupa peta raster atau vektor. Parameter ini tidak dapat ditetapkan atau diubah setelah peta dibuat instance-nya. Jika tidak ditetapkan, konfigurasi cloud untuk ID peta akan menentukan jenis rendering (jika tersedia). Perhatikan bahwa peta vektor mungkin tidak tersedia untuk semua perangkat dan browser, dan peta akan kembali ke peta raster sesuai kebutuhan.
restriction
opsional
Jenis: MapRestriction optional
Menentukan batas yang membatasi area peta yang dapat diakses oleh pengguna. Jika ditetapkan, pengguna hanya dapat menggeser dan memperbesar/memperkecil saat tampilan kamera tetap berada dalam batas.
rotateControl
opsional
Jenis: boolean optional
Status aktif/nonaktif kontrol Rotate.
rotateControlOptions
opsional
Jenis: RotateControlOptions optional
Opsi tampilan untuk kontrol Putar.
scaleControl
opsional
Jenis: boolean optional
Status awal diaktifkan/dinonaktifkan dari kontrol Skala.
scaleControlOptions
opsional
Jenis: ScaleControlOptions optional
Opsi tampilan awal untuk kontrol Skala.
scrollwheel
opsional
Jenis: boolean optional
Jika false, menonaktifkan zoom pada peta menggunakan roda scroll mouse. Roda scroll diaktifkan secara default.

Catatan: Properti ini tidak direkomendasikan. Untuk menonaktifkan zoom menggunakan roda scroll, Anda dapat menggunakan properti gestureHandling, dan menetapkannya ke "cooperative" atau "none".

streetView
opsional
Jenis: StreetViewPanorama optional
StreetViewPanorama yang akan ditampilkan saat pegman Street View diletakkan di peta. Jika tidak ada panorama yang ditentukan, StreetViewPanorama default akan ditampilkan di div peta saat pegman diletakkan.
streetViewControl
opsional
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 yang tidak boleh menampilkan overlay jalan Street View (misalnya, jenis peta non-Earth).
streetViewControlOptions
opsional
Jenis: StreetViewControlOptions optional
Opsi tampilan awal untuk kontrol Pegman Street View.
styles
opsional
Jenis: Array<MapTypeStyle> optional
Gaya yang akan diterapkan ke setiap jenis peta default. Perhatikan bahwa untuk mode satellite/hybrid dan terrain, gaya ini hanya akan berlaku untuk label dan geometri. Fitur ini tidak tersedia saat menggunakan ID peta, atau saat menggunakan peta vektor (gunakan gaya visual peta berbasis cloud).
tilt
opsional
Jenis: number optional
Untuk peta vektor, menetapkan sudut datang peta. Nilai yang diizinkan dibatasi bergantung pada tingkat zoom peta. Untuk peta raster, mengontrol perilaku peralihan otomatis untuk sudut datang peta. Satu-satunya nilai yang diizinkan adalah 0 dan 45. Nilai 0 menyebabkan peta selalu menggunakan tampilan atas 0° terlepas dari tingkat zoom dan area pandang. Nilai 45 menyebabkan sudut kemiringan otomatis beralih 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.
tiltInteractionEnabled
opsional
Jenis: boolean optional
Default: false
Apakah peta harus mengizinkan kontrol pengguna atas kemiringan kamera. Opsi ini hanya berlaku jika peta adalah peta vektor. Jika tidak ditetapkan dalam kode, konfigurasi cloud untuk ID peta akan digunakan (jika tersedia).
zoom
opsional
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 sesuai dengan resolusi yang lebih tinggi.
zoomControl
opsional
Jenis: boolean optional
Status diaktifkan/dinonaktifkan dari kontrol Zoom.
zoomControlOptions
opsional
Jenis: ZoomControlOptions optional
Opsi tampilan untuk kontrol Zoom.

Antarmuka MapTypeStyle

Antarmuka google.maps.MapTypeStyle

MapTypeStyle adalah kumpulan pemilih dan penata gaya yang menentukan cara penataan gaya peta. Pemilih menentukan fitur dan/atau elemen peta yang akan terpengaruh, dan styler menentukan cara fitur dan elemen tersebut akan diubah. Untuk mengetahui detailnya, lihat referensi gaya.

stylers
Jenis: Array<Object>
Aturan gaya yang akan diterapkan ke fitur dan elemen peta yang dipilih. Aturan diterapkan sesuai urutan yang Anda tentukan dalam array ini. Untuk panduan tentang penggunaan dan nilai yang diizinkan, lihat referensi gaya.
elementType
opsional
Jenis: string optional
Elemen yang harus menerapkan penata gaya. Elemen adalah aspek visual fitur di peta. Contoh: label, ikon, goresan atau isian yang diterapkan ke geometri, dan lainnya. Opsional. Jika elementType tidak ditentukan, nilainya akan dianggap sebagai 'all'. Untuk mengetahui detail penggunaan dan nilai yang diizinkan, lihat referensi gaya.
featureType
opsional
Jenis: string optional
Fitur, atau grup fitur, yang akan diterapkan styler. Opsional. Jika featureType tidak ditentukan, nilainya akan dianggap sebagai 'all'. Untuk mengetahui 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.

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 (misalnya, "klik" MapMouseEvent mungkin memiliki domEvent jenis KeyboardEvent).
latLng
opsional
Jenis: LatLng optional
Lintang/bujur yang berada di bawah kursor saat peristiwa terjadi.
stop
stop()
Parameter: Tidak ada
Nilai Hasil: void
Mencegah peristiwa ini menyebar lebih lanjut.

Antarmuka IconMouseEvent

google.maps.IconMouseEvent interface
extends MapMouseEvent

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

placeId
opsional
Jenis: string optional
ID tempat dari tempat yang diklik. ID tempat ini dapat digunakan untuk mengkueri informasi selengkapnya tentang fitur yang diklik.

Pelajari lebih lanjut ID tempat di panduan developer Places API.

Diwarisi: domEvent, latLng
Diwarisi: stop

ColorScheme konstanta

google.maps.ColorScheme konstanta library
"core"

ID untuk skema warna peta. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya 'FOLLOW_SYSTEM' atau google.maps.ColorScheme.FOLLOW_SYSTEM.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis ColorSchemeString.

const {ColorScheme} = await google.maps.importLibrary("core");
DARK Skema warna gelap untuk peta.
FOLLOW_SYSTEM Skema warna dipilih berdasarkan preferensi sistem, yang diperiksa sekali pada waktu eksekusi metode.
LIGHT Skema warna terang untuk peta. Nilai default untuk Maps JS lama.

Konstanta MapTypeId

google.maps.MapTypeId konstanta library
"maps"

ID untuk MapTypes umum. Tentukan ini berdasarkan nilai, atau dengan menggunakan nama konstanta. Misalnya 'satellite' atau google.maps.MapTypeId.SATELLITE.

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis MapTypeIdString.

const {MapTypeId} = await google.maps.importLibrary("maps");
HYBRID Jenis peta ini menampilkan lapisan transparan jalan utama pada citra satelit.
ROADMAP Jenis peta ini menampilkan peta jalan normal.
SATELLITE Jenis peta ini menampilkan gambar dari satelit.
TERRAIN Jenis peta ini menampilkan peta dengan fitur fisik seperti medan dan vegetasi.

Class MapTypeRegistry

google.maps.MapTypeRegistry class
extends MVCObject
library "maps"

Registry untuk instance MapType, yang diberi kunci berdasarkan ID MapType.

const {MapTypeRegistry} = await google.maps.importLibrary("maps");
MapTypeRegistry
MapTypeRegistry()
Parameter: Tidak ada
MapTypeRegistry menyimpan kumpulan jenis peta kustom yang tersedia untuk digunakan peta. API akan memeriksa registry ini saat memberikan daftar jenis peta yang tersedia dalam kontrol, misalnya.
set
set(id, mapType)
Parameter:
  • id: string ID MapType yang akan ditambahkan ke registry.
  • mapType: Objek MapType MapType|* yang akan ditambahkan ke registry.
Nilai Hasil: Tidak ada
Menetapkan registry untuk mengaitkan ID string yang diteruskan dengan MapType yang diteruskan.
Diwarisi: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Antarmuka MapRestriction

Antarmuka google.maps.MapRestriction

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

latLngBounds
Jika ditetapkan, pengguna hanya dapat menggeser dan memperbesar di dalam batas yang ditentukan. Batas dapat membatasi bujur dan lintang, atau hanya membatasi lintang. Untuk batas khusus lintang, gunakan bujur barat dan timur masing-masing -180 dan 180, misalnya, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds
opsional
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 yang berada di luar batas yang dibatasi tetap tersembunyi. Defaultnya adalah false, yang berarti pengguna dapat memperkecil tampilan hingga seluruh area yang dibatasi terlihat, mungkin termasuk area di luar area yang dibatasi.

Class TrafficLayer

google.maps.TrafficLayer class
extends MVCObject
library "maps"

Lapisan lalu lintas.

const {TrafficLayer} = await google.maps.importLibrary("maps");
TrafficLayer
TrafficLayer([opts])
Parameter:
Lapisan yang menampilkan lalu lintas jalan saat ini.
getMap
getMap()
Parameter: Tidak ada
Nilai Hasil: Map|null
Menampilkan peta tempat lapisan ini ditampilkan.
setMap
setMap(map)
Parameter:
  • map: Map optional
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
Diwarisi: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Antarmuka TrafficLayerOptions

Antarmuka google.maps.TrafficLayerOptions

Objek TrafficLayerOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada TrafficLayer.

autoRefresh
opsional
Jenis: boolean optional
Default: true
Apakah lapisan lalu lintas diperbarui secara otomatis dengan informasi terbaru.
map
opsional
Jenis: Map optional
Peta yang akan menampilkan lapisan lalu lintas.

Class TransitLayer

google.maps.TransitLayer class
extends MVCObject
library "maps"

Lapisan transportasi umum.

const {TransitLayer} = await google.maps.importLibrary("maps");
TransitLayer
TransitLayer()
Parameter: Tidak ada
Lapisan yang menampilkan jalur transportasi umum.
getMap
getMap()
Parameter: Tidak ada
Nilai Hasil: Map|null
Menampilkan peta tempat lapisan ini ditampilkan.
setMap
setMap(map)
Parameter:
  • map: Map optional
Nilai Hasil: void
Merender lapisan pada peta yang ditentukan. Jika peta ditetapkan ke null, lapisan akan dihapus.
Diwarisi: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Class BicyclingLayer

google.maps.BicyclingLayer class
extends MVCObject
library "maps"

Lapisan yang menampilkan lajur dan jalur sepeda.

const {BicyclingLayer} = await google.maps.importLibrary("maps");
BicyclingLayer
BicyclingLayer()
Parameter: Tidak ada
Lapisan yang menampilkan jalur dan lajur sepeda serta mendemosikan jalan besar.
getMap
getMap()
Parameter: Tidak ada
Nilai Hasil: Map|null
Menampilkan peta tempat lapisan ini ditampilkan.
setMap
setMap(map)
Parameter:
  • map: Map optional
Nilai Hasil: void
Merender lapisan pada peta yang ditentukan. Jika peta ditetapkan ke null, lapisan akan dihapus.
Diwarisi: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Antarmuka CameraOptions

Antarmuka google.maps.CameraOptions

Digunakan untuk menetapkan opsi kamera peta.

center
opsional
Jenis: LatLngLiteral|LatLng optional
heading
opsional
Jenis: number optional
tilt
opsional
Jenis: number optional
zoom
opsional
Jenis: number optional

Antarmuka VisibleRegion

Antarmuka google.maps.VisibleRegion

Berisi empat titik yang menentukan poligon bersisi empat 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
Kotak pembatas terkecil yang menyertakan wilayah yang terlihat.
nearLeft
Jenis: LatLng
nearRight
Jenis: LatLng

Konstanta RenderingType

google.maps.RenderingType konstanta library
"maps"

Konstanta ini juga dapat digunakan sebagai string. Di TypeScript, literal string ditentukan oleh jenis RenderingTypeString.

const {RenderingType} = await google.maps.importLibrary("maps");
RASTER Menunjukkan bahwa peta adalah peta raster.
UNINITIALIZED Menunjukkan bahwa belum diketahui apakah peta tersebut adalah vektor atau raster, karena peta belum selesai diinisialisasi.
VECTOR Menunjukkan bahwa peta tersebut adalah peta vektor.

Antarmuka MapCapabilities

Antarmuka google.maps.MapCapabilities

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

isAdvancedMarkersAvailable
opsional
Jenis: boolean optional
Jika benar, peta ini 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 mengetahui informasi selengkapnya.
isDataDrivenStylingAvailable
opsional
Jenis: boolean optional
Jika 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 mengetahui informasi selengkapnya.
isWebGLOverlayViewAvailable
opsional
Jenis: boolean optional
Jika benar, peta ini dikonfigurasi dengan benar untuk memungkinkan penggunaan WebGLOverlayView.