Marker (legacy)

Class Penanda

Class google.maps.Marker

Class ini memperluas MVCObject.

Akses dengan memanggil const {Marker} = await google.maps.importLibrary("marker"). Lihat Library di Maps JavaScript API.
Marker
Marker([opts])
Parameter: 
Membuat penanda dengan opsi yang ditentukan. Jika peta ditentukan, penanda akan ditambahkan ke peta setelah konstruksi. Perhatikan bahwa posisi harus ditetapkan agar penanda dapat ditampilkan.
MAX_ZINDEX Indeks z default maksimum yang akan ditetapkan API ke penanda. Anda dapat menetapkan indeks z yang lebih tinggi untuk menampilkan penanda ke depan.
getAnimation
getAnimation()
Parameter:  Tidak ada
Nilai Hasil:  Animation|null|undefined
Mendapatkan animasi yang sedang berjalan.
getClickable
getClickable()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  boolean Benar jika Penanda dapat diklik.
Dapatkan status Marker yang dapat diklik.
getCursor
getCursor()
Parameter:  Tidak ada
Nilai Hasil:  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.
Mendapatkan status Marker yang dapat ditarik.
getIcon
getIcon()
Parameter:  Tidak ada
Nilai Hasil:  string|Icon|Symbol|null|undefined
Dapatkan ikon Marker. Lihat MarkerOptions.icon.
getLabel
getLabel()
Parameter:  Tidak ada
Nilai Hasil:  MarkerLabel|string|null|undefined
Dapatkan label Marker. Lihat MarkerOptions.label.
getMap
getMap()
Parameter:  Tidak ada
Nilai Hasil:  Map|StreetViewPanorama
Dapatkan peta atau panorama tempat Marker dirender.
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 Hasil:  LatLng|null|undefined
Mendapatkan posisi Marker.
getShape
getShape()
Parameter:  Tidak ada
Nilai Hasil:  MarkerShape|null|undefined
Dapatkan bentuk Marker yang digunakan untuk interaksi. Lihat MarkerOptions.shape dan MarkerShape.
getTitle
getTitle()
Parameter:  Tidak ada
Nilai Hasil:  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.
Dapatkan zIndex Marker. Lihat MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parameter: 
  • animation:  Animation optional Animasi yang akan diputar.
Nilai yang Ditampilkan:  Tidak ada
Memulai animasi. Semua animasi yang sedang berlangsung akan dibatalkan. Animasi yang saat ini didukung adalah: Animation.BOUNCE, Animation.DROP. Meneruskan null akan menyebabkan animasi 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
Menetapkan 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: 
Nilai yang Ditampilkan:  Tidak ada
Tetapkan ikon untuk Marker. Lihat MarkerOptions.icon.
setLabel
setLabel([label])
Parameter: 
Nilai yang Ditampilkan:  Tidak ada
Tetapkan label untuk Marker. Lihat MarkerOptions.label.
setMap
setMap(map)
Parameter: 
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: 
Nilai yang Ditampilkan:  Tidak ada
Tetapkan opsi untuk Marker.
setPosition
setPosition([latlng])
Parameter: 
Nilai yang Ditampilkan:  Tidak ada
Tetapkan posisi untuk Marker.
setShape
setShape([shape])
Parameter: 
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
Tetapkan 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
animation_changed
function()
Argumen:  Tidak ada
Peristiwa ini diaktifkan saat properti animasi Marker berubah.
click
function(event)
Argumen: 
Peristiwa ini diaktifkan saat ikon Marker diklik.
clickable_changed
function()
Argumen:  Tidak ada
Peristiwa ini diaktifkan saat properti Marker yang dapat diklik berubah.
contextmenu
function(event)
Argumen: 
Peristiwa ini diaktifkan saat peristiwa contextmenu DOM diaktifkan di Marker
cursor_changed
function()
Argumen:  Tidak ada
Peristiwa ini diaktifkan saat properti kursor Marker berubah.
dblclick
function(event)
Argumen: 
Peristiwa ini diaktifkan saat ikon Marker diklik dua kali.
drag
function(event)
Argumen: 
Peristiwa ini diaktifkan berulang kali saat pengguna menarik Marker.
dragend
function(event)
Argumen: 
Peristiwa ini diaktifkan saat pengguna berhenti menarik Marker.
draggable_changed
function()
Argumen:  Tidak ada
Peristiwa ini diaktifkan saat properti Marker yang dapat ditarik berubah.
dragstart
function(event)
Argumen: 
Peristiwa ini diaktifkan saat pengguna mulai menarik Marker.
flat_changed
function()
Argumen:  Tidak ada
Peristiwa ini diaktifkan saat properti datar Marker berubah.
icon_changed
function()
Argumen:  Tidak ada
Peristiwa ini dipicu saat properti ikon Marker berubah.
mousedown
function(event)
Argumen: 
Peristiwa ini diaktifkan untuk mousedown di Marker.
mouseout
function(event)
Argumen: 
Peristiwa ini diaktifkan saat mouse keluar dari area ikon Marker.
mouseover
function(event)
Argumen: 
Peristiwa ini diaktifkan saat mouse memasuki area ikon Marker.
mouseup
function(event)
Argumen: 
Peristiwa ini diaktifkan untuk mouseup di 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 terlihat Marker berubah.
zindex_changed
function()
Argumen:  Tidak ada
Peristiwa ini dipicu saat properti zIndex Marker berubah.
rightclick
function(event)
Argumen: 
Peristiwa ini diaktifkan untuk klik kanan pada Marker.

Antarmuka MarkerOptions

Antarmuka google.maps.MarkerOptions

Objek MarkerOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada Penanda.
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 yang akan diputar saat penanda ditambahkan ke peta.
clickable optional
Jenis:  boolean optional
Default: true
Jika true, penanda akan menerima peristiwa mouse dan sentuh.
BetacollisionBehavior optional
Jenis:  string|CollisionBehavior optional
Default: null
Menetapkan perilaku saat tumpang-tindih untuk penanda pada peta vektor.
crossOnDrag optional
Jenis:  boolean optional
Default: true
Jika false, menonaktifkan tanda silang yang muncul di bawah penanda saat menarik.
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: Menetapkan ini ke true akan membuat penanda dapat diklik meskipun clickable disetel ke false.
icon optional
Jenis:  string|Icon|Symbol optional
Ikon untuk latar depan. Jika disediakan, string 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 disediakan dan MarkerOptions.title tidak disediakan, teks aksesibilitas (misalnya untuk digunakan dengan pembaca layar) akan ditambahkan ke penanda dengan teks label yang disediakan. 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 pembuatan 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 saat 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 disediakan, 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 menurut urutan zIndex-nya, dengan nilai yang lebih tinggi akan ditampilkan di depan penanda yang nilainya lebih rendah. Secara default, penanda ditampilkan sesuai posisi vertikalnya di layar, dengan penanda yang lebih rendah muncul di depan penanda yang lebih tinggi di layar.

Konstanta CollisionBehavior

Konstanta google.maps.CollisionBehavior

Akses dengan memanggil const {CollisionBehavior} = await google.maps.importLibrary("marker"). Lihat Library di Maps JavaScript API.
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 konflik yang terjadi. Ini merupakan perilaku default.
REQUIRED_AND_HIDES_OPTIONAL Selalu menampilkan penanda terlepas dari konflik yang terjadi, dan menyembunyikan setiap penanda atau label OPTIONAL_AND_HIDES_LOWER_PRIORITY yang akan tumpang-tindih dengan penanda.

Antarmuka Ikon

Antarmuka google.maps.Icon

Struktur yang mewakili gambar ikon Penanda.
url
Jenis:  string
URL gambar atau sheet sprite.
anchor optional
Jenis:  Point optional
Posisi untuk mengaitkan 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, asal terletak di titik tengah gambar.
origin optional
Jenis:  Point optional
Posisi gambar dalam sprite, jika ada. Secara default, 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/menciutkan gambar atau sprite.
size optional
Jenis:  Size optional
Ukuran tampilan sprite atau gambar. Saat menggunakan sprite, Anda harus menentukan ukuran sprite. Jika tidak diberikan, ukuran akan ditetapkan saat gambar dimuat.

Antarmuka MarkerLabel

Antarmuka google.maps.MarkerLabel

Opsi ini menentukan tampilan label penanda. Label penanda adalah string (sering kali satu karakter) yang akan muncul di dalam penanda. Jika menggunakannya dengan penanda kustom, Anda dapat memosisikan ulang dengan properti labelOrigin di class Icon.
text
Jenis:  string
Teks yang akan ditampilkan di label.
className optional
Jenis:  string optional
Default: '' (string kosong)
Properti className dari elemen label (setara dengan atribut class elemen). Beberapa class CSS yang dipisahkan 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

Antarmuka google.maps.MarkerShape

Objek ini menentukan area gambar penanda yang dapat diklik. Bentuk terdiri dari dua properti — type dan coord — yang menentukan wilayah non-transparan gambar.
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 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] dengan setiap pasangan x,y berisi koordinat satu vertex poligon.
  - rect: coords adalah [x1,y1,x2,y2] dengan x1,y1 adalah koordinat sudut kiri atas persegi panjang dan x2,y2 adalah koordinat sudut kanan bawah persegi panjang.

Antarmuka Simbol

Antarmuka google.maps.Symbol

Menjelaskan simbol, yang terdiri dari jalur vektor dengan gaya visual. Simbol dapat digunakan sebagai ikon penanda, atau ditempatkan di polyline.
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 dengan jalur simbol.
fillColor optional
Jenis:  string optional
Warna isi simbol. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai. Untuk penanda simbol, warna defaultnya adalah 'hitam'. Untuk simbol pada polyline, warna defaultnya adalah warna goresan polyline yang sesuai.
fillOpacity optional
Jenis:  number optional
Default: 0
Opasitas isian 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 dengan jalur simbol. 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 tempatnya berada.
scale optional
Jenis:  number optional
Jumlah yang digunakan untuk menskalakan ukuran simbol. Untuk penanda simbol, nilai defaultnya adalah 1; setelah penskalaan, simbol dapat berukuran berapa saja. Untuk simbol pada polyline, setelan defaultnya adalah ketebalan goresan polyline; setelah penskalaan, simbol harus berada di dalam persegi berukuran 22 piksel yang berpusat di anchor simbol.
strokeColor optional
Jenis:  string optional
Warna goresan simbol. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai. Untuk penanda simbol, warna defaultnya adalah 'hitam'. Untuk simbol pada polyline, warna defaultnya adalah warna goresan polyline.
strokeOpacity optional
Jenis:  number optional
Opasitas goresan simbol. Untuk penanda simbol, nilai defaultnya adalah 1. Untuk simbol pada polyline, setelan defaultnya adalah opasitas goresan polyline.
strokeWeight optional
Jenis:  number optional
Default: Symbol.scale simbol.
Ketebalan goresan simbol.

Konstanta SymbolPath

Konstanta google.maps.SymbolPath

Jalur simbol bawaan.

Akses dengan memanggil const {SymbolPath} = await google.maps.importLibrary("core"). Lihat Library di Maps JavaScript API.
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

Konstanta google.maps.Animation

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

Akses dengan memanggil const {Animation} = await google.maps.importLibrary("marker"). Lihat Library di Maps JavaScript API.
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 menampilkan null. Jenis animasi ini biasanya ditentukan selama pembuatan penanda.