Penanda

class final publik Penanda memperluas Objek

Ikon yang ditempatkan di titik tertentu pada permukaan peta. Ikon penanda digambar dengan berorientasi terhadap layar perangkat daripada permukaan peta; yaitu, hal itu belum tentu berubah karena 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. Default-nya adalah 50% dari sebelah kiri gambar dan di bagian bawah gambar.
Posisi
Nilai LatLng untuk posisi penanda pada peta. Anda dapat mengubah nilai ini di kapan saja jika Anda ingin memindahkan penanda.
Judul
String teks yang ditampilkan dalam 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 terhadap peta, penanda akan tetap menempel di peta seperti kamera berputar dan miring, tetapi tetap memiliki ukuran yang sama dengan zoom kamera, tidak seperti GroundOverlay. Jika penanda adalah papan reklame, penanda akan selalu digambar menghadap ke kamera dan 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 default posisi penanda. Jika penanda datar pada peta, posisi default-nya adalah Utara sejajar dan rotasi sedemikian rupa sehingga penanda selalu datar di peta. Jika adalah baliho, posisi defaultnya adalah mengarah ke atas dan rotasi diatur penanda selalu menghadap kamera. Nilai defaultnya adalah 0.
zIndex
Urutan gambar untuk penanda. Penanda digambar sesuai urutan zIndex, dengan penanda zIndex tertinggi yang digambar di bagian atas. Dengan menetapkan properti zIndex untuk setiap penanda, Anda dapat mengontrol target ketuk yang kemungkinan besar akan dicapai pengguna Anda. Nilai defaultnya adalah 0.
Tag
Object yang terkait dengan penanda. Misalnya, Object dapat berisi data tentang apa yang diwakili penanda. Ini lebih mudah daripada menyimpan Map<Marker, Object> terpisah. Sebagai contoh lainnya, Anda dapat mengaitkan ID String sesuai dengan ID dari set data. Google Maps SDK for Android tidak membaca atau yang 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 developer Penanda kami.

Ringkasan Class Bertingkat

@interface Marker.CollisionBehavior Menunjukkan cara penanda ditangani saat mengalami konflik dengan penanda atau dasar lainnya label peta.

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 kemampuan penanda untuk dapat 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 draggable)
Menetapkan kemampuan penanda untuk dapat ditarik.
void
setFlat(boolean datar)
Menetapkan apakah penanda ini harus datar terhadap peta true atau baliho yang menghadap kamera false.
void
setIcon(ikonBitmapDescriptor)
Menetapkan ikon untuk penanda.
void
setInfoWindowAnchor(float anchorU, float anchorV)
Menentukan titik pada gambar penanda untuk menambatkan jendela info saat gambar penanda ditampilkan.
void
setPosition(LatLng latlng)
Menetapkan lokasi penanda.
void
setRotation(rotasi mengambang)
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 visible)
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

publik boolean 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.

publik mengambang getAlpha ()

Mendapatkan alfa penanda.

Hasil
  • alfa penanda dalam rentang [0, 1].

publik {i>String<i} 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.

publik mengambang getRotation ()

Mendapatkan rotasi penanda.

Hasil
  • rotasi penanda dalam derajat searah jarum jam dari posisi default.

publik {i>String<i} 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.

publik {i>String<i} getTitle ()

Mendapatkan judul penanda.

Hasil
  • String yang berisi judul penanda.

publik mengambang getZIndex ()

Menampilkan zIndex penanda.

Hasil
  • zIndex penanda ini.

publik Int hashCode ()

publik kosong hideInfoWindow ()

Menyembunyikan jendela info jika ditampilkan dari penanda ini.

Metode ini tidak berpengaruh jika penanda ini tidak terlihat.

publik boolean isDraggable ()

Mendapatkan kemampuan penanda untuk dapat ditarik. Jika dapat ditarik, penanda dapat dipindahkan oleh pengguna dengan menekan lama penanda.

Hasil
  • true jika penanda dapat ditarik; jika tidak, akan menampilkan false.

publik boolean isFlat ()

Mendapatkan setelan datar Penanda.

Hasil
  • true jika penanda datar terhadap peta; false jika penanda harus menghadap kamera.

publik boolean 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.

publik boolean isVisible ()

Mendapatkan setelan visibilitas penanda ini. Perhatikan, ini tidak menunjukkan apakah penanda berada dalam area pandang layar. Ini menunjukkan apakah penanda akan digambar jika yang ada di area pandang layar.

Hasil
  • visibilitas penanda ini.

publik kosong hapus ()

Menghapus penanda ini dari peta. Setelah penanda dihapus, perilaku semua penanda metode tidak terdefinisi.

publik kosong setAlpha (alfa mengambang)

Menetapkan alfa (opasitas) penanda. Ini adalah nilai dari 0 hingga 1, dengan 0 berarti penanda sepenuhnya transparan dan 1 berarti penanda benar-benar buram.

Parameter
alfa

publik kosong setAnchor (float anchorU, anchor mengambangV)

Menetapkan titik link untuk penanda.

Anchor menentukan titik di gambar ikon yang ditambatkan ke posisi penanda di permukaan Bumi.

Titik angkur ditentukan dalam ruang kontinu [0,0, 1,0] x [0,0, 1,0], di mana (0, 0) adalah sudut kiri atas gambar, dan (1, 1) adalah sudut kanan bawah. Titik tautan dalam gambar W x H adalah titik petak terpisah terdekat dalam (W + 1) x (H + 1) yang diperoleh dengan menskalakan pembulatan saat itu. Misalnya, dalam gambar berukuran 4 x 2, titik jangkar (0,7, 0,6) kembali ke titik grid 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]).

publik kosong setDraggable (boolean dapat ditarik)

Menetapkan kemampuan penanda untuk dapat ditarik. Jika dapat ditarik, penanda dapat dipindahkan oleh pengguna dengan menekan lama penanda.

Parameter
dapat ditarik

publik kosong setFlat (boolean datar)

Menetapkan apakah penanda ini harus datar terhadap peta true atau baliho yang menghadap kamera false.

Parameter
datar

publik kosong setIcon (BitmapDescriptor iconDescriptor)

Menetapkan ikon untuk penanda.

Parameter
iconDescriptor jika null, penanda default akan digunakan.

publik kosong setInfoWindowAnchor (float anchorU, anchor mengambangV)

Menentukan titik pada gambar penanda untuk menambatkan jendela info saat gambar penanda ditampilkan. Nilai 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 dari anchor jendela info, sebagai rasio tinggi gambar (di kolom rentang [0, 1]).

publik kosong setPosition (LatLng latlng)

Menetapkan lokasi penanda.

Parameter
Latlng

publik kosong setRotation (rotasi mengambang)

Menetapkan rotasi penanda dalam derajat searah jarum jam di sekitar titik link penanda. Sumbu rotasi tegak lurus terhadap penanda. Rotasi 0 sesuai dengan posisi default penanda.

Parameter
rotasi

publik kosong setSnippet (Cuplikan string)

Menetapkan cuplikan penanda.

Parameter
cuplikan jika null, cuplikan akan dihapus.

publik kosong setTag (Tag objek)

Menetapkan tag untuk penanda.

Anda dapat menggunakan properti ini untuk mengaitkan Object arbitrer dengan penanda ini. Sebagai misalnya, Object dapat berisi data tentang hal yang diwakili penanda. 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 juga membaca atau menulis properti ini. Anda bertanggung jawab memanggil setTag(null) untuk menghapus tag saat Anda tidak lagi memerlukannya, untuk mencegah kebocoran memori di aplikasi.

Parameter
tag jika null, tag akan dihapus.

publik kosong setTitle (Judul string)

Menetapkan judul penanda.

Parameter
judul jika null, judul akan dihapus.

publik kosong setVisible (boolean terlihat)

Menetapkan visibilitas penanda ini. Jika ditetapkan ke false dan jendela info saat ini ditampilkan untuk penanda ini, tindakan ini akan menyembunyikan jendela info.

Parameter
terlihat

publik kosong setZIndex (zIndex mengambang)

Menetapkan zIndex penanda.

Parameter
zIndex

publik kosong showInfoWindow ()

Menampilkan jendela info penanda ini pada peta, jika penanda ini isVisible().

Menampilkan
IllegalArgumentException jika marker tidak ada di peta ini