Ikon yang ditempatkan pada titik tertentu pada permukaan peta. Ikon penanda digambar dengan berorientasi pada layar perangkat, bukan permukaan peta; artinya, ikon tidak selalu berubah orientasi karena adanya rotasi, kemiringan, atau zoom peta.
Penanda memiliki properti berikut:
- Alfa
- Menetapkan opasitas penanda. Default-nya adalah 1.0.
- Titik Tambatan
- Titik pada gambar yang akan ditempatkan pada posisi
LatLng
penanda. Setelan default-nya adalah 50% dari bagian 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.
- Cuplikan
- 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 pewarnaan alternatif ikon default menggunakan
defaultMarker(float)
. - Status Seret
- 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 terlihat. Untuk membuat penanda tidak terlihat, tetapkan properti ini ke
false
. Anda dapat mengubah nilai ini kapan saja. - Datar atau Baliho
- Jika penanda datar pada peta, penanda akan tetap berada di peta saat kamera berputar dan miring, tetapi akan tetap berukuran sama saat kamera di-zoom, tidak seperti
GroundOverlay
. Jika penanda adalah baliho, penanda akan selalu digambar menghadap kamera serta akan berputar dan miring bersama kamera. Defaultnya adalah baliho (false
) - Rotasi
- Rotasi penanda dalam derajat searah jarum jam di sekitar titik tambatan penanda. Sumbu rotasi tegak lurus terhadap 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 tetap datar pada peta. Jika penanda adalah baliho, posisi default-nya adalah mengarah ke atas dan rotasi diatur sehingga penanda selalu menghadap kamera. Nilai defaultnya adalah 0.
- zIndex
- Urutan gambar untuk penanda. Penanda digambar sesuai urutan zIndex, dengan penanda zIndex tertinggi digambar di bagian atas. Dengan menetapkan properti zIndex untuk setiap penanda, Anda dapat mengontrol target ketuk yang kemungkinan besar dicapai pengguna. Nilai defaultnya adalah 0.
- Tag
Object
yang terkait dengan penanda. Misalnya,Object
dapat berisi data tentang hal yang diwakili penanda. Hal ini lebih mudah daripada menyimpanMap<Marker, Object>
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 di 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 penanganan penanda saat mengalami tabrakan 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.
|
Object |
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 kemampuan penanda untuk ditarik.
|
boolean |
isFlat()
Mendapatkan setelan datar Penanda.
|
boolean |
isInfoWindowShown()
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(alfa mengambang)
Menetapkan alfa (opasitas) penanda.
|
void |
setAnchor(float anchorU, float anchorV)
Menetapkan titik link untuk penanda.
|
void |
setDraggable(boolean dapat ditarik)
Menetapkan kemampuan penanda untuk ditarik.
|
void |
setFlat(boolean datar)
Menetapkan apakah penanda ini harus datar terhadap peta
true atau baliho yang menghadap kamera false . |
void | |
void |
setInfoWindowAnchor(float anchorU, float anchorV)
Menentukan titik pada gambar penanda untuk menambatkan jendela info saat ditampilkan.
|
void | |
void |
setRotation(rotasi float)
Menetapkan rotasi penanda dalam derajat, searah jarum jam di sekitar titik tambatan 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 pada 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].
public String getId ()
Mendapatkan ID penanda ini. ID akan bersifat 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.
public String getSnippet ()
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.
public String getTitle ()
Mendapatkan judul penanda.
Hasil
- String yang berisi judul penanda.
float publik getZIndex ()
Menampilkan zIndex penanda.
Hasil
- zIndex penanda ini.
public int hashCode ()
public void hideInfoWindow ()
Menyembunyikan jendela info jika ditampilkan dari penanda ini.
Metode ini tidak berpengaruh jika penanda ini tidak terlihat.
boolean publik isDraggable ()
Mendapatkan kemampuan penanda untuk ditarik. 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 isInfoWindowShown ()
Menampilkan apakah jendela info saat ini ditampilkan di atas penanda ini. Hal 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. Ini menunjukkan apakah penanda akan digambar jika terdapat dalam area pandang layar.
Hasil
- visibilitas penanda ini.
public void remove ()
Menghapus penanda ini dari peta. Setelah penanda dihapus, perilaku semua metodenya tidak akan ditentukan.
public void setAlpha (float alpha)
Menetapkan alfa (opasitas) penanda. Ini adalah nilai dari 0 hingga 1, dengan 0 berarti penanda sepenuhnya transparan dan 1 berarti penanda benar-benar tidak tembus pandang.
Parameter
alfa |
---|
public void setAnchor (float anchorU, float anchorV)
Menetapkan titik link untuk penanda.
Anchor menentukan titik pada gambar ikon yang ditambatkan ke posisi penanda di permukaan bumi.
Titik link ditentukan dalam ruang kontinu [0,0, 1,0] x [0,0, 1,0], dengan (0, 0) adalah sudut kiri atas gambar, dan (1, 1) adalah sudut kanan bawah. Titik penambatan dalam gambar L x T adalah titik petak diskrit terdekat dalam petak (W + 1) x (H + 1), yang diperoleh dengan menskalakan pembulatan kemudian. Misalnya, dalam gambar 4 x 2, titik link (0,7, 0,6) me-resolve ke titik petak di (3, 1).
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
Parameter
anchorU | koordinat u anchor, sebagai rasio lebar gambar (dalam rentang [0, 1]). |
---|---|
anchorV | koordinat v anchor, sebagai rasio tinggi gambar (dalam rentang [0, 1]). |
public void setDraggable (boolean draggable)
Menetapkan kemampuan penanda untuk ditarik. Jika dapat ditarik, penanda dapat dipindahkan oleh pengguna dengan menekan lama penanda.
Parameter
dapat ditarik |
---|
publik void setFlat (boolean flat)
Menetapkan apakah penanda ini harus datar terhadap peta true
atau baliho yang menghadap kamera false
.
Parameter
datar |
---|
publik void setIcon (BitmapDescriptor iconDescriptor)
Menetapkan ikon untuk penanda.
Parameter
iconDescriptor | jika null, penanda default akan digunakan. |
---|
public void setInfoWindowAnchor (float anchorU, float anchorV)
Menentukan titik pada gambar penanda untuk menambatkan jendela info saat ditampilkan. Ini ditetapkan dalam sistem koordinat yang sama dengan anchor. Lihat setAnchor(float, float)
untuk mengetahui detail selengkapnya. Defaultnya adalah bagian tengah atas gambar.
Parameter
anchorU | koordinat u 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]). |
public void setRotation (rotasi float)
Menetapkan rotasi penanda dalam derajat, searah jarum jam di sekitar titik tambatan penanda. Sumbu rotasi tegak lurus terhadap penanda. Rotasi 0 sesuai dengan posisi default penanda.
Parameter
rotasi |
---|
public void setSnippet (Cuplikan string)
Menetapkan cuplikan penanda.
Parameter
cuplikan | jika null, cuplikan akan dihapus. |
---|
public 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 hal yang diwakili penanda. Hal ini lebih mudah daripada menyimpan Map<Marker, Object>
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 memanggil setTag(null)
untuk menghapus
tag saat tidak diperlukan lagi, guna mencegah kebocoran memori dalam aplikasi.
Parameter
tag | jika null, tag akan dihapus. |
---|
public void setTitle (Judul string)
Menetapkan judul penanda.
Parameter
title | jika null, judul akan dihapus. |
---|
publik void setVisible (boolean visible)
Menetapkan visibilitas penanda ini. Jika ditetapkan ke false
dan jendela info saat ini ditampilkan untuk penanda ini, jendela info tersebut akan disembunyikan.
Parameter
terlihat |
---|
public void setZIndex (float zIndex)
Menetapkan zIndex penanda.
Parameter
zIndex |
---|
public void showInfoWindow ()
Menampilkan jendela info penanda ini pada peta, jika penanda ini isVisible()
.
Menampilkan
IllegalArgumentException | jika marker tidak ada dalam peta ini
|
---|