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 | |
| CLLocationCoordinate2D | position |
| 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. | |
| BOOL | tracksViewChanges |
| Mengontrol apakah ikon untuk penanda ini harus digambar ulang setiap bingkai. | |
| BOOL | tracksInfoWindowChanges |
| Mengontrol apakah jendela info untuk penanda ini harus digambar ulang setiap bingkai. | |
| Titik CG | groundAnchor |
| Jangkar tanah menetapkan titik dalam gambar ikon yang ditambatkan ke posisi penanda pada permukaan bumi. | |
| Titik CG | InfoWindowAnchor |
| Anchor jendela info menentukan titik dalam gambar ikon untuk menambatkan jendela info, yang akan ditampilkan langsung di atas titik ini. | |
| GMSMarkerAnimation | mergeAnimation |
| Mengontrol animasi yang digunakan saat penanda ini ditempatkan di GMSMapView (default kGMSMarkerAnimationNone, tanpa animasi). | |
| BOOL | dapat ditarik |
| Mengontrol apakah penanda ini dapat ditarik secara interaktif (tidak default). | |
| BOOL | datar |
| Mengontrol apakah penanda ini harus datar terhadap permukaan Bumi (YES) atau baliho yang menghadap kamera (TIDAK, default). | |
| CLLocationDerajat | rotasi |
| Menetapkan rotasi penanda dalam derajat searah jarum jam tentang titik link penanda. | |
| float | opasitas |
| Menetapkan opasitas penanda, antara 0 (sepenuhnya transparan) dan 1 (default). | |
| GMSMarkerLayer * | lapisan |
| Menyediakan lapisan Animasi Inti untuk GMSMarker ini. | |
| GMSPanoramaView * | panoramaView |
panoramaView menentukan tampilan panorama yang akan mencoba menampilkan penanda ini. | |
| NSString * | title |
| Judul, deskripsi singkat overlay. | |
| GMSMapView * | map |
| Peta tempat overlay ini berada. | |
| BOOL | yang dapat diketuk |
| Jika overlay ini harus menyebabkan notifikasi ketuk. | |
| int | Indeks z |
Overlay nilai zIndex yang lebih tinggi akan digambar di atas lapisan ubin nilai zIndex yang lebih rendah dan overlay. | |
| id | penggunaData |
| 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).