Marker (legacy)

Class Marker

Class google.maps.Marker

Tidak digunakan lagi: Mulai 21 Februari 2024, penggunaan google.maps.Marker dihentikan. Sebagai gantinya, gunakan AdvancedMarkerElement. Saat ini, google.maps.Marker tidak dijadwalkan untuk dihentikan, tetapi AdvancedMarkerElement direkomendasikan daripada google.maps.Marker. Meskipun google.maps.Marker akan terus menerima perbaikan bug untuk regresi utama, bug yang ada di google.maps.Marker tidak akan ditangani. Pemberitahuan akan diberikan setidaknya 12 bulan sebelum dukungan dihentikan. Lihat https://developers.google.com/maps/deprecations untuk mengetahui detail tambahan dan https://developers.google.com/maps/documentation/javascript/advanced-markers/migration untuk panduan migrasi.

Class ini memperluas MVCObject.

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

Konstruktor
Marker	Marker([opts]) Parameter:  opts:  MarkerOptions optional Argumen opsional bernama Membuat penanda dengan opsi yang ditentukan. Jika peta ditentukan, penanda akan ditambahkan ke peta saat konstruksi. Perhatikan bahwa posisi harus ditetapkan agar penanda ditampilkan.

Konstanta
MAX_ZINDEX	Indeks z default maksimum yang akan ditetapkan API ke penanda. Anda dapat menetapkan indeks z yang lebih tinggi untuk memindahkan penanda ke depan.

Metode
getAnimation	getAnimation() Parameter:  Tidak ada Nilai yang Ditampilkan:  Animation|null|undefined Mendapatkan animasi yang sedang berjalan.
getClickable	getClickable() Parameter:  Tidak ada Nilai yang Ditampilkan:  boolean Benar jika Penanda dapat diklik. Dapatkan status yang dapat diklik dari Marker.
getCursor	getCursor() Parameter:  Tidak ada Nilai yang Ditampilkan:  string|null|undefined Mendapatkan jenis kursor mouse yang ditampilkan saat kursor diarahkan.
getDraggable	getDraggable() Parameter:  Tidak ada Nilai yang Ditampilkan:  boolean Benar jika Penanda dapat ditarik. Dapatkan status yang dapat ditarik dari Marker.
getIcon	getIcon() Parameter:  Tidak ada Nilai yang Ditampilkan:  string|Icon|Symbol|null|undefined Dapatkan ikon Marker. Lihat MarkerOptions.icon.
getLabel	getLabel() Parameter:  Tidak ada Nilai yang Ditampilkan:  MarkerLabel|string|null|undefined Dapatkan label Marker. Lihat MarkerOptions.label.
getMap	getMap() Parameter:  Tidak ada Nilai yang Ditampilkan:  Map|StreetViewPanorama Mendapatkan peta atau panorama yang dirender di Marker.
getOpacity	getOpacity() Parameter:  Tidak ada Nilai yang Ditampilkan:  number|null|undefined Angka antara 0,0 dan 1,0. Mendapatkan opasitas Marker.
getPosition	getPosition() Parameter:  Tidak ada Nilai yang Ditampilkan:  LatLng|null|undefined Mendapatkan posisi Marker.
getShape	getShape() Parameter:  Tidak ada Nilai yang Ditampilkan:  MarkerShape|null|undefined Mendapatkan bentuk Marker yang digunakan untuk interaksi. Lihat MarkerOptions.shape dan MarkerShape.
getTitle	getTitle() Parameter:  Tidak ada Nilai yang Ditampilkan:  string|null|undefined Mendapatkan judul tooltip Marker. Lihat MarkerOptions.title.
getVisible	getVisible() Parameter:  Tidak ada Nilai yang Ditampilkan:  boolean Benar jika Penanda terlihat. Dapatkan visibilitas Marker.
getZIndex	getZIndex() Parameter:  Tidak ada Nilai yang Ditampilkan:  number|null|undefined zIndex Penanda. Mendapatkan zIndex Marker. Lihat MarkerOptions.zIndex.
setAnimation	setAnimation([animation]) Parameter:  animation:  Animation optional Animasi yang akan diputar. Nilai yang Ditampilkan:  Tidak Ada Mulai animasi. Semua animasi yang sedang berlangsung akan dibatalkan. Animasi yang saat ini didukung adalah: Animation.BOUNCE, Animation.DROP. Meneruskan null akan menyebabkan animasi apa pun berhenti.
setClickable	setClickable(flag) Parameter:  flag:  boolean Jika true, Penanda dapat diklik. Nilai yang Ditampilkan:  Tidak Ada Tetapkan apakah Marker dapat diklik.
setCursor	setCursor([cursor]) Parameter:  cursor:  string optional Jenis kursor mouse. Nilai yang Ditampilkan:  Tidak Ada Tetapkan jenis kursor mouse yang ditampilkan saat kursor diarahkan.
setDraggable	setDraggable(flag) Parameter:  flag:  boolean optional Jika true, Penanda dapat ditarik. Nilai yang Ditampilkan:  Tidak Ada Tetapkan apakah Marker dapat ditarik.
setIcon	setIcon([icon]) Parameter:  icon:  string|Icon|Symbol optional Nilai yang Ditampilkan:  Tidak Ada Tetapkan ikon untuk Marker. Lihat MarkerOptions.icon.
setLabel	setLabel([label]) Parameter:  label:  string|MarkerLabel optional Label dapat berupa string karakter atau objek MarkerLabel. Nilai yang Ditampilkan:  Tidak Ada Tetapkan label untuk Marker. Lihat MarkerOptions.label.
setMap	setMap(map) Parameter:  map:  Map|StreetViewPanorama Nilai yang Ditampilkan:  Tidak Ada Merender Marker pada peta atau panorama yang ditentukan. Jika peta disetel ke null, penanda akan dihapus.
setOpacity	setOpacity([opacity]) Parameter:  opacity:  number optional Angka antara 0,0, transparan, dan 1,0, buram. Nilai yang Ditampilkan:  Tidak Ada Tetapkan opasitas Marker.
setOptions	setOptions(options) Parameter:  options:  MarkerOptions Nilai yang Ditampilkan:  Tidak Ada Tetapkan opsi untuk Marker.
setPosition	setPosition([latlng]) Parameter:  latlng:  LatLng|LatLngLiteral optional Posisi baru. Nilai yang Ditampilkan:  Tidak Ada Tetapkan posisi untuk Marker.
setShape	setShape([shape]) Parameter:  shape:  MarkerShape optional Nilai yang Ditampilkan:  Tidak Ada Tetapkan bentuk Marker yang digunakan untuk interaksi. Lihat MarkerOptions.shape dan MarkerShape.
setTitle	setTitle([title]) Parameter:  title:  string optional Nilai yang Ditampilkan:  Tidak Ada Tetapkan judul tooltip Marker. Lihat MarkerOptions.title.
setVisible	setVisible(visible) Parameter:  visible:  boolean Jika true, Penanda akan terlihat Nilai yang Ditampilkan:  Tidak Ada Ditetapkan jika Marker terlihat.
setZIndex	setZIndex([zIndex]) Parameter:  zIndex:  number optional Nilai yang Ditampilkan:  Tidak Ada Tetapkan zIndex Marker. Lihat MarkerOptions.zIndex.
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Acara
animation_changed	function() Argumen:  Tidak ada Peristiwa ini dipicu saat properti animasi Marker berubah.
click	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan saat ikon Marker diklik.
clickable_changed	function() Argumen:  Tidak ada Peristiwa ini diaktifkan saat properti yang dapat diklik Marker berubah.
contextmenu	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan saat peristiwa contextmenu DOM diaktifkan pada Marker
cursor_changed	function() Argumen:  Tidak ada Peristiwa ini diaktifkan saat properti kursor Marker berubah.
dblclick	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini dipicu saat ikon Marker diklik dua kali.
drag	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini dipicu berulang kali saat pengguna menarik Marker.
dragend	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan saat pengguna berhenti menarik Marker.
draggable_changed	function() Argumen:  Tidak ada Peristiwa ini diaktifkan saat properti yang dapat ditarik Marker berubah.
dragstart	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan saat pengguna mulai menarik Marker.
flat_changed	function() Argumen:  Tidak ada Peristiwa ini dipicu saat properti datar Marker berubah.
icon_changed	function() Argumen:  Tidak ada Peristiwa ini dipicu saat properti ikon Marker berubah.
mousedown	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan untuk peristiwa mousedown pada Marker.
mouseout	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan saat kursor mouse keluar dari area ikon Marker.
mouseover	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan saat kursor memasuki area ikon Marker.
mouseup	function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan untuk mouseup pada Marker.
position_changed	function() Argumen:  Tidak ada Peristiwa ini dipicu saat properti posisi Marker berubah.
shape_changed	function() Argumen:  Tidak ada Peristiwa ini diaktifkan saat properti bentuk Marker berubah.
title_changed	function() Argumen:  Tidak ada Peristiwa ini dipicu saat properti judul Marker berubah.
visible_changed	function() Argumen:  Tidak ada Peristiwa ini diaktifkan saat properti Marker yang terlihat berubah.
zindex_changed	function() Argumen:  Tidak ada Peristiwa ini dipicu saat properti zIndex Marker berubah.
rightclick	Tidak digunakan lagi: Gunakan peristiwa Marker.contextmenu sebagai gantinya untuk mendukung pola penggunaan seperti klik sambil menekan tombol control di macOS. function(event) Argumen:  event:  MapMouseEvent Peristiwa ini diaktifkan untuk klik kanan pada Marker.

Antarmuka MarkerOptions

google.maps.MarkerOptions interface

Tidak digunakan lagi: Mulai 21 Februari 2024, penggunaan google.maps.Marker dihentikan. Sebagai gantinya, gunakan google.maps.marker.AdvancedMarkerElement. Lihat https://developers.google.com/maps/deprecations untuk mengetahui detail penghentian dan https://developers.google.com/maps/documentation/javascript/advanced-markers/migration untuk panduan migrasi.

Objek MarkerOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada Penanda.

Properti
anchorPoint optional	Jenis:  Point optional Offset dari posisi penanda ke ujung InfoWindow yang telah dibuka dengan penanda sebagai anchor.
animation optional	Jenis:  Animation optional Default: null Animasi mana yang akan diputar saat penanda ditambahkan ke peta.
clickable optional	Jenis:  boolean optional Default: true Jika true, penanda akan menerima peristiwa mouse dan sentuh.
collisionBehavior optional	Tidak digunakan lagi: collisionBehavior tidak digunakan lagi mulai Juli 2023. Sebagai gantinya, gunakan AdvancedMarkerElement.collisionBehavior. Pemberitahuan: Hanya tersedia di saluran v=beta. Jenis:  string|CollisionBehavior optional Default: null Menetapkan perilaku saat tumpang-tindih untuk penanda di peta vektor.
crossOnDrag optional	Jenis:  boolean optional Default: true Jika false, menonaktifkan tanda silang yang muncul di bawah penanda saat ditarik.
cursor optional	Jenis:  string optional Default: pointer Jenis kursor mouse yang akan ditampilkan saat kursor diarahkan.
draggable optional	Jenis:  boolean optional Default: false Jika true, penanda dapat ditarik. Catatan: Menyetelnya ke true akan membuat penanda dapat diklik meskipun clickable disetel ke false.
icon optional	Jenis:  string|Icon|Symbol optional Ikon untuk latar depan. Jika string diberikan, string tersebut akan diperlakukan seolah-olah merupakan Icon dengan string sebagai url.
label optional	Jenis:  string|MarkerLabel optional Default: null Menambahkan label ke penanda. Label marker adalah huruf atau angka yang muncul di dalam marker. Label dapat berupa string, atau objek MarkerLabel. Jika diberikan dan MarkerOptions.title tidak diberikan, teks aksesibilitas (misalnya untuk digunakan dengan pembaca layar) akan ditambahkan ke penanda dengan teks label yang diberikan. Perhatikan bahwa label saat ini hanya digunakan untuk teks aksesibilitas bagi penanda yang tidak dioptimalkan.
map optional	Jenis:  Map|StreetViewPanorama optional Peta tempat Penanda akan ditampilkan. Peta diperlukan untuk menampilkan penanda dan dapat diberikan dengan Marker.setMap jika tidak diberikan saat konstruksi penanda.
opacity optional	Jenis:  number optional Default: 1.0 Angka antara 0,0, transparan, dan 1,0, buram.
optimized optional	Jenis:  boolean optional Pengoptimalan akan meningkatkan performa dengan merender banyak penanda sebagai elemen statis tunggal. Hal ini berguna jika ada banyak penanda yang diperlukan. Baca selengkapnya tentang pengoptimalan penanda. Catatan: Pengoptimalan ini tidak berpengaruh pada penanda di peta vektor.
position optional	Jenis:  LatLng|LatLngLiteral optional Menetapkan posisi penanda. Penanda dapat dibuat, tetapi tidak ditampilkan hingga posisinya diberikan - misalnya, oleh tindakan atau pilihan pengguna. Posisi penanda dapat diberikan dengan Marker.setPosition jika tidak diberikan pada pembuatan penanda.
shape optional	Jenis:  MarkerShape optional Definisi wilayah peta gambar yang digunakan untuk menarik/mengklik.
title optional	Jenis:  string optional Default: undefined Teks rollover. Jika diberikan, teks aksesibilitas (misalnya, untuk digunakan dengan pembaca layar) akan ditambahkan ke penanda dengan nilai yang diberikan. Perhatikan bahwa title saat ini hanya digunakan untuk teks aksesibilitas bagi penanda yang tidak dioptimalkan.
visible optional	Jenis:  boolean optional Default: true Jika true, penanda akan terlihat.
zIndex optional	Jenis:  number optional Semua penanda ditampilkan di peta sesuai urutan zIndex-nya, dengan nilai yang lebih tinggi ditampilkan di depan penanda yang nilainya lebih rendah. Secara default, penanda ditampilkan sesuai dengan posisi vertikalnya di layar, dengan penanda yang lebih rendah muncul di depan penanda yang lebih tinggi di layar.

Konstanta CollisionBehavior

google.maps.CollisionBehavior konstanta

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

Konstanta
OPTIONAL_AND_HIDES_LOWER_PRIORITY	Menampilkan penanda hanya jika tidak tumpang-tindih dengan penanda lainnya. Jika dua penanda dengan jenis ini akan tumpang-tindih, penanda dengan zIndex yang lebih tinggi akan ditampilkan. Jika memiliki zIndex yang sama, penanda dengan posisi layar vertikal bawah akan ditampilkan.
REQUIRED	Selalu menampilkan penanda terlepas dari tumpang-tindih yang terjadi. Ini merupakan perilaku default.
REQUIRED_AND_HIDES_OPTIONAL	Selalu menampilkan penanda terlepas dari tumpang-tindih yang terjadi, dan menyembunyikan setiap penanda atau label OPTIONAL_AND_HIDES_LOWER_PRIORITY yang akan tumpang-tindih dengan penanda.

Ikon antarmuka

google.maps.Icon interface

Struktur yang merepresentasikan gambar ikon Penanda.

Properti
url	Jenis:  string URL gambar atau sprite sheet.
anchor optional	Jenis:  Point optional Posisi untuk menempatkan gambar sesuai dengan lokasi penanda di peta. Secara default, anchor terletak di sepanjang titik tengah bagian bawah gambar.
labelOrigin optional	Jenis:  Point optional Asal label relatif terhadap sudut kiri atas gambar ikon, jika label disediakan oleh penanda. Secara default, titik asal terletak di titik tengah gambar.
origin optional	Jenis:  Point optional Posisi gambar dalam sprite, jika ada. Secara default, titik asal terletak di sudut kiri atas gambar (0, 0).
scaledSize optional	Jenis:  Size optional Ukuran seluruh gambar setelah penskalaan, jika ada. Gunakan properti ini untuk meregangkan/mengecilkan gambar atau sprite.
size optional	Jenis:  Size optional Ukuran tampilan sprite atau gambar. Saat menggunakan sprite, Anda harus menentukan ukuran sprite. Jika ukuran tidak diberikan, ukuran akan ditetapkan saat gambar dimuat.

Antarmuka MarkerLabel

google.maps.MarkerLabel interface

Opsi ini menentukan tampilan label penanda. Label penanda adalah string (sering kali satu karakter) yang akan muncul di dalam penanda. Jika Anda menggunakannya dengan penanda kustom, Anda dapat memosisikannya kembali dengan properti labelOrigin di class Icon.

Properti
text	Jenis:  string Teks yang akan ditampilkan di label.
className optional	Jenis:  string optional Default: '' (string kosong) Properti className elemen label (setara dengan atribut class elemen). Beberapa class CSS yang dipisahkan dengan spasi dapat ditambahkan. Warna, ukuran, ketebalan, dan jenis font hanya dapat ditetapkan melalui properti MarkerLabel lainnya. Class CSS tidak boleh digunakan untuk mengubah posisi atau orientasi label (misalnya, menggunakan terjemahan dan rotasi) jika juga menggunakan pengelolaan tabrakan penanda.
color optional	Jenis:  string optional Default: 'black' Warna teks label.
fontFamily optional	Jenis:  string optional Jenis font teks label (setara dengan properti font-family CSS).
fontSize optional	Jenis:  string optional Default: '14px' Ukuran font teks label (setara dengan properti font-size CSS).
fontWeight optional	Jenis:  string optional Ketebalan font teks label (setara dengan properti font-weight CSS).

Antarmuka MarkerShape

google.maps.MarkerShape interface

Objek ini menentukan area yang dapat diklik dari gambar penanda. Bentuk terdiri dari dua properti — type dan coord — yang menentukan wilayah non-transparan suatu gambar.

Properti
type	Jenis:  string Menjelaskan jenis bentuk dan dapat berupa circle, poly, atau rect.
coords optional	Jenis:  Array<number> optional Format atribut ini bergantung pada nilai type dan mengikuti spesifikasi coords AREA w3 yang dapat ditemukan di http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. Atribut coords adalah array bilangan bulat yang menentukan posisi piksel bentuk relatif terhadap sudut kiri atas gambar target. Koordinat bergantung pada nilai type sebagai berikut:   - circle: coords adalah [x1,y1,r] dengan x1,y2 adalah koordinat pusat lingkaran, dan r adalah radius lingkaran.   - poly: coords adalah [x1,y1,x2,y2...xn,yn] di mana setiap pasangan x,y berisi koordinat satu verteks poligon.   - rect: coords adalah [x1,y1,x2,y2] dengan x1,y1 adalah koordinat sudut kiri atas persegi panjang dan x2,y2 adalah koordinat kanan bawah persegi panjang.

Antarmuka Simbol

google.maps.Symbol interface

Mendeskripsikan simbol, yang terdiri dari jalur vektor dengan gaya. Simbol dapat digunakan sebagai ikon penanda, atau ditempatkan pada polyline.

Properti
path	Jenis:  SymbolPath|string Jalur simbol, yang merupakan jalur simbol bawaan, atau jalur kustom yang dinyatakan menggunakan notasi jalur SVG. Wajib.
anchor optional	Jenis:  Point optional Default: google.maps.Point(0,0) Posisi simbol relatif terhadap penanda atau polyline. Koordinat jalur simbol masing-masing diterjemahkan ke kiri dan ke atas berdasarkan koordinat x dan y anchor. Posisi dinyatakan dalam sistem koordinat yang sama seperti jalur simbol tersebut.
fillColor optional	Jenis:  string optional Warna pengisi simbol. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai. Untuk penanda simbol, nilai defaultnya adalah 'hitam'. Untuk simbol pada polyline, defaultnya adalah warna goresan polyline yang bersangkutan.
fillOpacity optional	Jenis:  number optional Default: 0 Opasitas pengisi simbol.
labelOrigin optional	Jenis:  Point optional Default: google.maps.Point(0,0) Asal label relatif terhadap asal jalur, jika label disediakan oleh penanda. Asal dinyatakan dalam sistem koordinat yang sama seperti jalur simbol tersebut. Properti ini tidak digunakan untuk simbol pada polyline.
rotation optional	Jenis:  number optional Default: 0 Sudut yang digunakan untuk memutar simbol, yang dinyatakan searah jarum jam dalam derajat. Simbol dalam IconSequence dengan fixedRotation adalah false diputar relatif terhadap sudut tepi tempat simbol berada.
scale optional	Jenis:  number optional Jumlah yang digunakan untuk menskalakan ukuran simbol. Untuk penanda simbol, nilai defaultnya adalah 1; setelah penskalaan, ukuran simbol bisa berapa saja. Untuk simbol pada polyline, nilai defaultnya adalah bobot goresan polyline; setelah penskalaan, simbol harus berada di dalam persegi berukuran 22 piksel yang berpusat di titik tambatan simbol.
strokeColor optional	Jenis:  string optional Warna goresan simbol. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai. Untuk penanda simbol, nilai defaultnya adalah 'hitam'. Untuk simbol di polyline, defaultnya adalah warna goresan polyline.
strokeOpacity optional	Jenis:  number optional Opasitas goresan simbol. Untuk penanda simbol, nilai defaultnya adalah 1. Untuk simbol pada polyline, nilai defaultnya adalah opasitas goresan polyline.
strokeWeight optional	Jenis:  number optional Default: Symbol.scale simbol. Ketebalan goresan simbol.

SymbolPath constants

google.maps.SymbolPath konstanta

Jalur simbol bawaan.

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

Konstanta
BACKWARD_CLOSED_ARROW	Panah tertutup yang menunjuk ke belakang.
BACKWARD_OPEN_ARROW	Panah terbuka yang menunjuk ke belakang.
CIRCLE	Lingkaran.
FORWARD_CLOSED_ARROW	Panah tertutup yang menunjuk ke depan.
FORWARD_OPEN_ARROW	Panah terbuka yang menunjuk ke depan.

Konstanta Animasi

google.maps.Animation konstanta

Animasi yang dapat diputar pada penanda. Gunakan metode Marker.setAnimation pada Penanda atau opsi MarkerOptions.animation untuk memutar animasi.

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

Konstanta
BOUNCE	Penanda memantul hingga animasi dihentikan dengan memanggil Marker.setAnimation dengan null.
DROP	Penanda turun dari bagian atas peta ke lokasi akhirnya. Animasi akan berhenti setelah penanda tidak bergerak dan Marker.getAnimation akan kembali ke null. Jenis animasi ini biasanya ditentukan selama pembuatan penanda.