Penanda

public final class Marker memperluas Object

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 adalah false.
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 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.

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
setIcon(BitmapDescriptor iconDescriptor)
Menetapkan ikon untuk penanda.
void
setInfoWindowAnchor(float anchorU, float anchorV)
Menentukan titik pada gambar penanda untuk menambatkan jendela info saat ditampilkan.
void
setPosition(LatLng latlng)
Menetapkan lokasi penanda.
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)

Menguji apakah Marker ini sama dengan yang lain.

Parameter
lainnya Object.
Hasil
  • true jika kedua objek adalah objek yang sama, yaitu, ini == other.

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, menampilkan false.

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]).

publik void setPosition (LatLng latlng)

Menetapkan lokasi penanda.

Parameter
Latlng

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