Referensi Class GMSMarker

Referensi Class GMSMarker

Ringkasan

Penanda adalah ikon yang ditempatkan pada titik tertentu di permukaan peta.

Ikon penanda digambar dengan berorientasi pada layar perangkat, bukan permukaan peta; dengan kata lain, ikon tidak selalu akan mengubah orientasi karena rotasi peta, kemiringan, atau zoom.

Mewarisi GMSOverlay.

Fungsi Anggota Publik Statis

(jenis instance)+ 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, yang ditampilkan di bawah judul di jendela info saat dipilih.
UIGambar * ikon
 Ikon penanda yang akan dirender.
UIView * ikonTampilan
 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 bingkai.
Titik CGgroundAnchor
 Jangkar tanah menetapkan titik dalam gambar ikon yang ditambatkan ke posisi penanda pada permukaan bumi.
Titik CGInfoWindowAnchor
 Anchor jendela info menentukan titik dalam gambar ikon untuk menambatkan jendela info, yang akan ditampilkan langsung di atas titik ini.
GMSMarkerAnimationmergeAnimation
 Mengontrol animasi yang digunakan saat penanda ini ditempatkan di GMSMapView (default kGMSMarkerAnimationNone, tanpa animasi).
BOOLdapat ditarik
 Mengontrol apakah penanda ini dapat ditarik secara interaktif (tidak default).
BOOLdatar
 Mengontrol apakah penanda ini harus datar terhadap permukaan Bumi (YES) atau baliho yang menghadap kamera (TIDAK, default).
CLLocationDerajatrotasi
 Menetapkan rotasi penanda dalam derajat searah jarum jam tentang titik link penanda.
floatopasitas
 Menetapkan opasitas penanda, antara 0 (sepenuhnya transparan) dan 1 (default).
GMSMarkerLayer *lapisan
 Menyediakan lapisan Animasi Inti untuk GMSMarker ini.
GMSPanoramaViewpanoramaView
 panoramaView menentukan tampilan panorama yang akan mencoba menampilkan penanda ini.
NSString * title
 Judul, deskripsi singkat overlay.
GMSMapViewmap
 Peta tempat overlay ini berada.
BOOLyang dapat diketuk
 Jika overlay ini harus menyebabkan notifikasi ketuk.
intIndeks z
 Overlay nilai zIndex yang lebih tinggi akan digambar di atas lapisan ubin nilai zIndex yang lebih rendah dan overlay.
idpenggunaData
 Data overlay.

Dokumentasi Fungsi Anggota

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D) position

Konstruktor praktis untuk penanda default.

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

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


Dokumentasi Properti

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

Posisi penanda.

Animasi.

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

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

- (UIImage*) ikon [read, write, assign]

Ikon penanda yang akan dirender.

Jika dibiarkan kosong, gunakan penanda tempat SDK default.

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

Mendukung penggunaan perataan RectRectInsets untuk menentukan area ketuk yang dikurangi. Hal ini juga menentukan ulang cara menentukan anchor. Untuk gambar animasi, nilai untuk animasi digunakan, bukan setiap frame.

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

Tampilan penanda yang akan dirender.

Jika dibiarkan kosong, maka akan kembali ke properti icon.

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

Perhatikan bahwa tampilan berperilaku seolah-olah clipsToBounds ditetapkan ke YES, terlepas dari nilainya yang sebenarnya.

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

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

Perhatikan bahwa jika ini berubah dari TIDAK menjadi YA, ikon dijamin akan digambar ulang frame berikutnya.

Default-nya adalah YES. Tidak berpengaruh jika iconView bernilai nol.

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

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

Perhatikan bahwa ketika ini berubah dari TIDAK menjadi YA, jendela info dijamin akan digambar ulang frame berikutnya.

Default-nya adalah NO.

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

Jangkar tanah menetapkan titik dalam gambar ikon yang ditambatkan ke posisi penanda pada permukaan bumi.

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

Jika gambar memiliki perataan non-nol untuk RectInsets, bagian kiri atas dan kanan bawah yang disebutkan di atas merujuk pada bagian inset gambar.

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

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

Titik ini ditetapkan dalam ruang yang sama dengan GroundAnchor.

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

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

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

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

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

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

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

Menetapkan rotasi penanda dalam derajat searah jarum jam tentang titik link penanda.

Sumbu rotasi tegak lurus terhadap penanda. Rotasi 0 sesuai dengan posisi default penanda. Animasi.

Jika penanda datar pada peta, posisi default sejajar dengan utara dan rotasi diatur sehingga penanda selalu datar di peta. Jika penanda adalah baliho, posisi default-nya adalah mengarah ke atas dan rotasi diatur sehingga penanda selalu menghadap kamera.

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

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

- (GMSMarkerLayer*) lapisan [read, assign]

Menyediakan lapisan Animasi Inti untuk GMSMarker ini.

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

panoramaView menentukan tampilan panorama yang akan mencoba menampilkan penanda ini.

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

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

Penanda dapat ditampilkan pada panorama dan peta secara bersamaan.

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

Judul, deskripsi singkat overlay.

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

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

Peta tempat overlay ini berada.

Menetapkan properti ini akan menambahkan overlay ke peta. Menetapkannya ke nilai nol akan menghapus overlay ini dari peta. Overlay dapat aktif pada maksimal satu peta pada waktu tertentu.

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

Jika overlay ini harus menyebabkan notifikasi ketuk.

Beberapa overlay, seperti penanda, akan secara default dapat diketuk.

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

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

Nilai yang sama menghasilkan pengurutan gambar yang tidak ditentukan. Penanda adalah pengecualian yang terlepas dari zIndex, penanda akan selalu digambar di atas lapisan ubin dan overlay non-penanda lainnya; penanda tersebut secara efektif dianggap berada dalam 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 dilepaskan).