Penanda

class final publik Marker memperluas Object

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 adalah false.
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 menyimpan Map<Marker, Object> secara 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 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
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
setIcon(BitmapDescriptor iconDescriptor)
Menetapkan ikon untuk penanda.
void
setInfoWindowAnchor(float anchorU, float anchorV)
Menentukan titik dalam gambar penanda untuk menempatkan jendela info saat ditampilkan.
void
setPosition(LatLng latlng)
Menetapkan lokasi penanda.
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)

Menguji apakah Marker ini sama dengan yang lain.

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

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

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 setPosition (LatLng latlng)

Menetapkan lokasi penanda.

Parameter
latlng

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