Ikon yang ditempatkan pada titik tertentu di permukaan peta. Ikon penanda digambar dengan berorientasi pada layar perangkat dan bukan pada permukaan peta; dengan kata lain, penanda tidak akan berubah orientasinya karena rotasi peta, kemiringan, atau zoom.
Penanda memiliki properti berikut:
- Alpha
- Menetapkan opasitas penanda. Default-nya adalah 1.0.
- Anchor
- Titik pada gambar yang akan ditempatkan pada posisi
LatLng
penanda. Setelan default-nya adalah 50% dari kiri gambar dan di bagian bawah gambar. - Posisi
- Nilai
LatLng
untuk posisi penanda pada peta. Anda dapat mengubah nilai ini kapan saja jika ingin memindahkan penanda. - Judul
- String teks yang ditampilkan di jendela info saat pengguna mengetuk penanda. Anda dapat mengubah nilai ini kapan saja.
- Snippet
- Teks tambahan yang ditampilkan di bawah judul. Anda dapat mengubah nilai ini kapan saja.
- Ikon
- Bitmap yang ditampilkan untuk penanda. Jika ikon tidak disetel, ikon default akan
ditampilkan. Anda dapat menentukan warna alternatif ikon default menggunakan
defaultMarker(float)
. - Status Tarik
- Jika Anda ingin mengizinkan pengguna menarik penanda, tetapkan properti ini ke
true
. Anda dapat mengubah nilai ini kapan saja. Defaultnya adalahfalse
. - Visibilitas
- Secara default, penanda dapat dilihat. Untuk membuat penanda tidak terlihat, tetapkan properti ini ke
false
. Anda dapat mengubah nilai ini kapan saja. - Sepatu Flat atau Billboard
- Jika penanda datar terhadap peta, penanda akan tetap berada di peta saat kamera diputar dan miring, tetapi tetap berukuran sama saat kamera di-zoom, tidak seperti
GroundOverlay
. Jika penanda berupa baliho, penanda akan selalu digambar menghadap ke kamera serta akan berputar dan miring bersama kamera. Defaultnya adalah baliho (false
) - Rotation
- Rotasi penanda dalam derajat searah jarum jam di sekitar titik link penanda. Sumbu rotasi tegak lurus dengan penanda. Rotasi 0 sesuai dengan posisi default penanda. Jika penanda datar pada peta, posisi default-nya adalah sejajar dengan Utara dan rotasi diatur sehingga penanda selalu datar di peta. Jika penanda berupa baliho, posisi default-nya adalah mengarah ke atas dan rotasi diatur sehingga penanda selalu menghadap kamera. Nilai defaultnya adalah 0.
- Indeks
- Urutan gambar penanda. Penanda digambar sesuai urutan zIndex, dengan penanda zIndex tertinggi digambar di atasnya. Dengan menetapkan properti zIndex untuk setiap penanda, Anda dapat mengontrol target ketuk mana yang paling mungkin dicapai oleh pengguna. Nilai defaultnya adalah 0.
- Tag
Object
yang terkait dengan penanda. Misalnya,Object
dapat berisi data tentang apa yang diwakili penanda. Hal ini lebih mudah daripada menyimpanMap<Marker, Object>
secara terpisah. Sebagai contoh lainnya, Anda dapat mengaitkan IDString
yang sesuai dengan ID dari set data. Google Maps SDK for Android tidak membaca atau menulis properti ini.
Metode di class ini harus dipanggil pada UI thread Android. Jika tidak, IllegalStateException
akan ditampilkan saat runtime.
Contoh
GoogleMap map = ... // get a map.
// Add a marker at San Francisco.
Marker marker = map.addMarker(new MarkerOptions()
.position(new LatLng(37.7750, 122.4183))
.title("San Francisco")
.snippet("Population: 776733"));
Panduan Developer
Untuk informasi selengkapnya, baca panduan developer Penanda.
Ringkasan Class Bertingkat
@antarmuka | Marker.CollisionBehavior | Menunjukkan cara penanda ditangani saat terjadi konflik dengan penanda lain atau label peta dasar. |
Ringkasan Metode Publik
boolean |
sama dengan(Objek lainnya)
Menguji apakah
Marker ini sama dengan yang lain. |
float |
getAlpha()
Mendapatkan alfa penanda.
|
String |
getId()
Mendapatkan id penanda ini.
|
LatLng |
getPosition()
Menampilkan posisi penanda.
|
float |
getRotation()
Mendapatkan rotasi penanda.
|
String |
getSnippet()
Mendapatkan cuplikan penanda.
|
Objek |
getTag()
Mendapatkan tag untuk penanda.
|
String |
getTitle()
Mendapatkan judul penanda.
|
float |
getZIndex()
Menampilkan zIndex penanda.
|
int |
hashCode()
|
void |
hideInfoWindow()
Menyembunyikan jendela info jika ditampilkan dari penanda ini.
|
boolean |
isDraggable()
Mendapatkan tarikan penanda.
|
boolean |
isFlat()
Mendapatkan setelan datar Penanda.
|
boolean |
isInfoWindowShow()
Menampilkan apakah jendela info saat ini ditampilkan di atas penanda ini.
|
boolean |
isVisible()
Mendapatkan setelan visibilitas penanda ini.
|
void |
remove()
Menghapus penanda ini dari peta.
|
void |
setAlpha(float alpha)
Menetapkan alfa (opasitas) penanda.
|
void |
setAnchor(float anchorU, float anchorV)
Menetapkan titik link untuk penanda.
|
void |
setDraggable(boolean draggable)
Menetapkan daya tarik penanda.
|
void |
setFlat(boolean datar)
Menetapkan apakah penanda ini harus datar terhadap peta
true atau baliho yang menghadap ke kamera false . |
void | |
void |
setInfoWindowAnchor(float anchorU, float anchorV)
Menentukan titik dalam gambar penanda untuk menempatkan jendela info saat ditampilkan.
|
void | |
void |
setRotation(float rotasi)
Menetapkan rotasi penanda dalam derajat searah jarum jam di sekitar titik link penanda.
|
void |
setSnippet(Cuplikan string)
Menetapkan cuplikan penanda.
|
void |
setTag(Tag objek)
Menetapkan tag untuk penanda.
|
void |
setTitle(Judul string)
Menetapkan judul penanda.
|
void |
setVisible(boolean terlihat)
Menetapkan visibilitas penanda ini.
|
void |
setZIndex(float zIndex)
Menetapkan zIndex penanda.
|
void |
showInfoWindow()
Menampilkan jendela info penanda ini di peta, jika penanda ini
isVisible() . |
Ringkasan Metode Turunan
Metode Publik
boolean publik sama dengan (Objek lainnya)
float publik getAlpha ()
Mendapatkan alfa penanda.
Hasil
- alfa penanda dalam rentang [0, 1].
publik String getId ()
Mendapatkan id penanda ini. ID akan unik di antara semua Penanda pada peta.
Hasil
- id penanda ini.
publik LatLng getPosition ()
Menampilkan posisi penanda.
Hasil
- Objek
LatLng
yang menentukan posisi penanda saat ini.
float publik getRotation ()
Mendapatkan rotasi penanda.
Hasil
- rotasi penanda dalam derajat searah jarum jam dari posisi default.
publik String getCuplikan ()
Mendapatkan cuplikan penanda.
Hasil
- String yang berisi cuplikan penanda.
publik Objek getTag ()
Mendapatkan tag untuk penanda.
Hasil
- tag jika tag ditetapkan dengan
setTag
;null
jika tidak ada tag yang ditetapkan.
publik String getTitle ()
Mendapatkan judul penanda.
Hasil
- String yang berisi judul penanda.
float publik getZIndex ()
Menampilkan zIndex penanda.
Hasil
- penanda z ini.
int publik hashCode ()
publik void hideInfoWindow ()
Menyembunyikan jendela info jika ditampilkan dari penanda ini.
Metode ini tidak berpengaruh jika penanda ini tidak terlihat.
boolean publik isDraggable ()
Mendapatkan tarikan penanda. Jika dapat ditarik, penanda dapat dipindahkan oleh pengguna dengan menekan lama penanda.
Hasil
true
jika penanda dapat ditarik; jika tidak, menampilkanfalse
.
boolean publik isFlat ()
Mendapatkan setelan datar Penanda.
Hasil
true
jika penanda datar terhadap peta;false
jika penanda harus menghadap kamera.
boolean publik isInfoWindowShow ()
Menampilkan apakah jendela info saat ini ditampilkan di atas penanda ini. Ini tidak mempertimbangkan apakah jendela info benar-benar terlihat di layar atau tidak.
boolean publik isVisible ()
Mendapatkan setelan visibilitas penanda ini. Perhatikan bahwa ini tidak menunjukkan apakah penanda berada dalam area pandang layar. Menunjukkan apakah penanda akan digambar jika penanda terdapat di area pandang layar.
Hasil
- visibilitas penanda ini.
publik void remove ()
Menghapus penanda ini dari peta. Setelah penanda dihapus, perilaku semua metodenya tidak ditentukan.
public void setAlpha (float alpha)
Menetapkan alfa (opasitas) penanda. Ini adalah nilai dari 0 hingga 1, di mana 0 berarti penanda sepenuhnya transparan dan 1 berarti penanda sepenuhnya buram.
Parameter
alfa |
---|
publik void setAnchor (float anchorU, float anchorV)
Menetapkan titik link untuk penanda.
Jangkar menentukan titik dalam gambar ikon yang ditambatkan ke posisi penanda di permukaan Bumi.
Titik link ditentukan dalam spasi berkelanjutan [0.0, 1.0] x [0.0, 1.0], dengan (0, 0) adalah sudut kiri atas gambar, dan (1, 1) adalah pojok kanan bawah. Titik anchor dalam gambar W x H adalah titik petak terpisah terdekat dalam petak (W + 1) x (H + 1), yang diperoleh dengan menskalakan pembulatan lalu. Misalnya, dalam gambar 4 x 2, titik link (0.7, 0.6) akan berubah menjadi titik petak di (3, 1).
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
Parameter
anchorU | u-koordinat anchor, sebagai rasio lebar gambar (dalam rentang [0, 1]). |
---|---|
anchorV | koordinat v anchor, sebagai rasio tinggi gambar (dalam rentang [0, 1]). |
publik void setDraggable (boolean dapat ditarik)
Menetapkan daya tarik penanda. Jika dapat ditarik, penanda dapat dipindahkan oleh pengguna dengan menekan lama penanda.
Parameter
dapat ditarik |
---|
publik void setFlat (boolean datar)
Menetapkan apakah penanda ini harus datar terhadap peta true
atau baliho yang menghadap ke kamera false
.
Parameter
datar |
---|
publik void setIcon (BitmapDescriptor iconDescriptor)
Menetapkan ikon untuk penanda.
Parameter
iconDescriptor | jika null, penanda default akan digunakan. |
---|
publik void setInfoWindowAnchor (float anchorU, float anchorV)
Menentukan titik dalam gambar penanda untuk menempatkan jendela info saat ditampilkan. Nilai ini ditentukan dalam sistem koordinat yang sama dengan anchor. Lihat setAnchor(float, float)
untuk mengetahui detail selengkapnya. Defaultnya adalah bagian tengah atas gambar.
Parameter
anchorU | u-koordinat anchor jendela info, sebagai rasio lebar gambar (dalam rentang [0, 1]). |
---|---|
anchorV | koordinat v anchor jendela info, sebagai rasio tinggi gambar (dalam rentang [0, 1]). |
publik void setRotation (rotasi float)
Menetapkan rotasi penanda dalam derajat searah jarum jam di sekitar titik link penanda. Sumbu rotasi tegak lurus dengan penanda. Rotasi 0 sesuai dengan posisi default penanda.
Parameter
rotasi |
---|
publik void setSnippet (Cuplikan string)
Menetapkan cuplikan penanda.
Parameter
cuplikan | jika null, cuplikan dihapus. |
---|
publik void setTag (Tag objek)
Menetapkan tag untuk penanda.
Anda dapat menggunakan properti ini untuk mengaitkan Object
arbitrer dengan penanda ini. Misalnya, Object
dapat berisi data tentang apa yang diwakili oleh penanda. Hal ini lebih mudah daripada menyimpan Map<Marker, Object>
yang terpisah. Sebagai contoh lainnya, Anda dapat mengaitkan
ID String
yang sesuai dengan ID dari set data. Google Maps SDK for Android tidak membaca atau menulis properti ini. Anda bertanggung jawab untuk memanggil setTag(null)
untuk menghapus tag saat tidak diperlukan lagi, guna mencegah kebocoran memori di aplikasi Anda.
Parameter
tag | jika null, tag akan dihapus. |
---|
publik void setTitle (String title)
Menetapkan judul penanda.
Parameter
judul | jika null, judul dihapus. |
---|
publik void setVisible (booleanvisible)
Menetapkan visibilitas penanda ini. Jika ditetapkan ke false
dan jendela info saat ini ditampilkan untuk penanda ini, jendela info akan disembunyikan.
Parameter
terlihat |
---|
publik void setZIndex (float zIndex)
Menetapkan zIndex penanda.
Parameter
Indeks |
---|
publik void showInfoWindow ()
Menampilkan jendela info penanda ini di peta, jika penanda ini isVisible()
.
Menampilkan
IllegalArgumentException | jika marker tidak ada di peta ini
|
---|