Referensi Class GMSMarker

Referensi Class GMSMarker

Ringkasan

Penanda adalah 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 peta, kemiringan, atau zoom.

Mewarisi GMSOverlay.

Diwariskan oleh GMSAdvancedMarker.

Fungsi Anggota Publik Statis

(instancetype)+ markerWithPosition:
 Konstruktor praktis untuk penanda default.
(UIImage *)+ markerImageWithColor:
 Membuat versi berwarna dari gambar penanda default untuk digunakan sebagai ikon.

Properti

CLLocationCoordinate2Dposition
 Posisi penanda.
NSString * cuplikan
 Teks cuplikan, ditampilkan di bawah judul di jendela info saat dipilih.
UIImage * ikon
 Ikon penanda untuk dirender.
UIView * iconView
 Tampilan penanda yang akan dirender.
BOOLtracksViewChanges
 Mengontrol apakah ikon untuk penanda ini harus digambar ulang setiap bingkai.
BOOLtracksInfoWindowChanges
 Mengontrol apakah jendela info untuk penanda ini harus digambar ulang setiap frame.
CGPointgroundAnchor
 Anchor bumi menentukan titik pada gambar ikon yang ditambatkan ke posisi penanda di permukaan bumi.
CGPointinfoWindowAnchor
 Anchor jendela info menentukan titik pada gambar ikon untuk menambatkan jendela info, yang akan ditampilkan tepat di atas titik ini.
GMSMarkerAnimationappearAnimation
 Mengontrol animasi yang digunakan saat penanda ini ditempatkan pada GMSMapView (default kGMSMarkerAnimationNone, tanpa animasi).
BOOLdapat ditarik
 Mengontrol apakah penanda ini dapat ditarik secara interaktif (default NO).
BOOLdatar
 Mengontrol apakah penanda ini harus datar terhadap permukaan Bumi (YA) atau baliho yang menghadap kamera (TIDAK, default).
CLLocationDegreesrotasi
 Menetapkan rotasi penanda dalam derajat, searah jarum jam di sekitar titik tambatan penanda.
float opasitas
 Menetapkan opasitas penanda, antara 0 (sepenuhnya transparan) dan 1 (default) inklusif.
GMSMarkerLayerlapisan
 Menyediakan lapisan Animasi Inti untuk GMSMarker ini.
GMSPanoramaViewpanoramaView
 panoramaView menentukan tampilan panorama mana yang akan mencoba menampilkan penanda ini.
NSString * title
 Judul, deskripsi singkat tentang overlay.
GMSMapViewmap
 Peta tempat overlay ini berada.
BOOLdapat di-tap
 Jika overlay ini seharusnya menyebabkan notifikasi ketuk.
int zIndex
 Overlay dengan nilai zIndex yang lebih tinggi akan digambar di atas overlay dan lapisan ubin nilai zIndex yang lebih rendah.
iduserData
 Data overlay.

Dokumentasi Fungsi Anggota

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D)  position

Konstruktor praktis untuk penanda default.

+ (UIImage *) markerImageWithColor: (nullable UIColor *)  warna

Membuat versi berwarna dari gambar penanda default untuk digunakan sebagai ikon.


Dokumentasi Properti

- (CLLocationCoordinate2D) position [read, write, assign]

Posisi penanda.

Animasi.

- (NSString*) cuplikan [read, write, copy]

Teks cuplikan, ditampilkan di bawah judul di jendela info saat dipilih.

Ikon penanda untuk dirender.

Jika dibiarkan nol, penanda tempat SDK default akan digunakan.

Mendukung gambar animasi, tetapi setiap frame harus memiliki ukuran yang sama atau perilakunya tidak ditentukan.

Mendukung penggunaan perataanRectInsets untuk menentukan area ketuk yang dikurangi. Hal ini juga menentukan ulang cara menentukan anchor. Untuk gambar animasi, nilai animasi yang digunakan adalah nilai masing-masing frame.

- (UIView*) iconView [read, write, assign]

Tampilan penanda yang akan dirender.

Jika dibiarkan nol, akan kembali ke properti icon.

Mendukung animasi semua properti UIView yang dapat dianimasikan, kecuali frame dan center. Pengubahan properti ini atau versi CALayer yang sesuai, termasuk position, tidak didukung.

Perhatikan bahwa tampilan berperilaku seolah-olah clipsToBounds disetel ke YA, terlepas dari nilai sebenarnya.

- (BOOL) tracksViewChanges [read, write, assign]

Mengontrol apakah ikon untuk penanda ini harus digambar ulang setiap bingkai.

Perhatikan bahwa saat ini berubah dari NO ke YES, ikon dijamin akan digambar ulang bingkai berikutnya.

Default-nya adalah YA. Tidak berpengaruh jika iconView nol.

- (BOOL) tracksInfoWindowChanges [read, write, assign]

Mengontrol apakah jendela info untuk penanda ini harus digambar ulang setiap frame.

Perhatikan bahwa saat ini berubah dari NO ke YES, jendela info dijamin akan digambar ulang frame berikutnya.

Nilai defaultnya adalah TIDAK.

- (CGPoint) groundAnchor [read, write, assign]

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

Titik ini 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.

Jika gambar memiliki alignRectInsets selain nol, bagian kiri atas dan kanan bawah yang disebutkan di atas merujuk ke bagian inset gambar.

- (CGPoint) infoWindowAnchor [read, write, assign]

Anchor jendela info menentukan titik pada gambar ikon untuk menambatkan jendela info, yang akan ditampilkan tepat di atas titik ini.

Titik ini ditetapkan dalam ruang yang sama dengan groundAnchor.

- (GMSMarkerAnimation) appearAnimation [read, write, assign]

Mengontrol animasi yang digunakan saat penanda ini ditempatkan pada GMSMapView (default kGMSMarkerAnimationNone, tanpa animasi).

- (BOOL) dapat ditarik [read, write, assign]

Mengontrol apakah penanda ini dapat ditarik secara interaktif (default NO).

- (BOOL) datar [read, write, assign]

Mengontrol apakah penanda ini harus datar terhadap permukaan Bumi (YA) atau baliho yang menghadap kamera (TIDAK, default).

- (CLLocationDegrees) rotasi [read, write, assign]

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. Animasi.

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.

- (float) opacity [read, write, assign]

Menetapkan opasitas penanda, antara 0 (sepenuhnya transparan) dan 1 (default) inklusif.

- (GMSMarkerLayer*) lapisan [read, assign]

Menyediakan lapisan Animasi Inti untuk GMSMarker ini.

- (GMSPanoramaView*) panoramaView [read, write, assign]

panoramaView menentukan tampilan panorama mana yang akan mencoba menampilkan penanda ini.

Perhatikan bahwa jika position penanda terlalu jauh dari lokasi panorama panoramaView saat ini, penanda tidak akan ditampilkan karena terlalu kecil.

Dapat disetel ke nol untuk menghapus penanda dari tampilan panorama saat ini yang melampirkannya.

Penanda bisa ditampilkan pada panorama dan peta secara bersamaan.

- (NSString*) title [read, write, copy, inherited]

Judul, deskripsi singkat tentang overlay.

Beberapa overlay, seperti penanda, akan menampilkan judul pada peta. Judul juga merupakan teks aksesibilitas default.

- Peta [read, write, assign, inherited] (GMSMapView*)

Peta tempat overlay ini berada.

Menyetel properti ini akan menambahkan overlay ke peta. Menyetelnya ke nol akan menghapus overlay ini dari peta. Overlay mungkin akan aktif pada paling banyak satu peta pada waktu tertentu.

- (BOOL) dapat diketuk [read, write, assign, inherited]

Jika overlay ini seharusnya menyebabkan notifikasi ketuk.

Beberapa overlay, seperti penanda, secara default dapat diketuk.

- (int) zIndex [read, write, assign, inherited]

Overlay dengan nilai zIndex yang lebih tinggi akan digambar di atas overlay dan lapisan ubin nilai zIndex yang lebih rendah.

Nilai yang sama menyebabkan pengurutan gambar yang tidak ditentukan. Penanda merupakan pengecualian karena terlepas dari zIndex, penanda akan selalu digambar di atas lapisan ubin dan overlay non-penanda lainnya; penanda secara efektif dianggap sebagai grup indeks z yang terpisah dibandingkan dengan overlay lainnya.

- (id) userData [read, write, assign, inherited]

Data overlay.

Anda dapat menggunakan properti ini untuk mengaitkan objek arbitrer dengan overlay ini. Google Maps SDK for iOS tidak membaca atau menulis properti ini.

Perhatikan bahwa userData tidak boleh menyimpan referensi yang kuat ke objek Maps apa pun, jika tidak, siklus retensi dapat dibuat (mencegah objek dirilis).