Ringkasan
Penanda adalah ikon yang ditempatkan pada titik tertentu pada permukaan peta.
Ikon penanda digambar dengan berorientasi pada layar perangkat, bukan permukaan peta; yaitu, ikon penanda tidak selalu berubah orientasi karena 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 gambar penanda default yang diberi warna untuk digunakan sebagai ikon. | |
Properti | |
| CLLocationCoordinate2D | position |
| 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 untuk dirender. | |
| BOLEH | tracksViewChanges |
| Mengontrol apakah ikon untuk penanda ini harus digambar ulang setiap bingkai. | |
| BOLEH | tracksInfoWindowChanges |
| Mengontrol apakah jendela info untuk penanda ini harus digambar ulang setiap bingkai. | |
| CGPoint | groundAnchor |
| Jangkar bumi menentukan titik pada gambar ikon yang ditambatkan ke posisi penanda di permukaan Bumi. | |
| CGPoint | infoWindowAnchor |
| Anchor jendela info menentukan titik dalam gambar ikon untuk menambatkan jendela info, yang akan ditampilkan langsung di atas titik ini. | |
| GMSMarkerAnimation | munculAnimation |
| Mengontrol animasi yang digunakan saat penanda ini ditempatkan pada Authenticator (default kGMSMarkerAnimationNone, tanpa animasi). | |
| BOLEH | dapat ditarik |
| Mengontrol apakah penanda ini dapat ditarik secara interaktif (default NO). | |
| BOLEH | datar |
| Mengontrol apakah penanda ini harus datar terhadap permukaan bumi (YA) atau papan reklame yang menghadap ke kamera (TIDAK, default). | |
| CLLocationDegrees | rotasi |
| Menetapkan rotasi penanda dalam derajat searah jarum jam di sekitar titik tambatan penanda. | |
| {i>float<i} | opasitas |
| Menetapkan opasitas penanda, antara 0 (sepenuhnya transparan) dan 1 (default) inklusif. | |
| GMSMarkerLayer * | lapisan |
| Memberikan lapisan Animasi Inti untuk GMSMarker ini. | |
| GMSPanoramaView * | panoramaView |
panoramaView menentukan tampilan panorama yang akan mencoba menampilkan penanda ini. | |
| NSString * | title |
| Judul, deskripsi singkat {i>overlay<i}. | |
| Workspace * | map |
| Peta tempat overlay ini berada. | |
| BOLEH | dapat diketuk |
| Jika overlay ini harus menyebabkan notifikasi ketuk. | |
| int | zIndex |
Overlay nilai zIndex yang lebih tinggi akan digambar di atas overlay dan lapisan ubin nilai zIndex yang lebih rendah. | |
| id | userData |
| Data overlay. | |
Dokumentasi Fungsi Anggota
| + (instancetype) markerWithPosition: | (CLLocationCoordinate2D) | position |
Konstruktor praktis untuk penanda default.
| + (UIImage *) markerImageWithColor: | (nullable UIColor *) | warna |
Membuat versi gambar penanda default yang diberi warna untuk digunakan sebagai ikon.
Dokumentasi Properti
- (CLLocationCoordinate2D) posisi [read, write, assign] |
Posisi penanda.
Animasi.
- (NSString*) cuplikan [read, write, copy] |
Teks cuplikan, ditampilkan di bawah judul di jendela info saat dipilih.
- (UIImage*) ikon [read, write, assign] |
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. Tindakan ini juga menentukan ulang cara anchor ditentukan. Untuk gambar animasi, nilai animasi yang digunakan, bukan masing-masing frame.
- iconView [read, write, assign] (UIView*) |
Tampilan penanda untuk dirender.
Jika dibiarkan nol, kembali ke properti icon.
Mendukung animasi semua properti UIView yang dapat dianimasikan, kecuali frame dan center. Mengubah 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 bila ini berubah dari NO ke YES, ikon dijamin akan digambar ulang frame berikutnya.
Default-nya adalah YES. Tidak berpengaruh jika iconView bernilai nil.
- (BOOL) tracksInfoWindowChanges [read, write, assign] |
Mengontrol apakah jendela info untuk penanda ini harus digambar ulang setiap bingkai.
Perhatikan bahwa saat ini berubah dari NO ke YES, jendela info dijamin akan digambar ulang frame berikutnya.
Nilai defaultnya adalah NO.
- (CGPoint) groundAnchor [read, write, assign] |
Jangkar 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 perataanRectInsets bukan nol, 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) TampilanAnimation [read, write, assign] |
Mengontrol animasi yang digunakan saat penanda ini ditempatkan pada Authenticator (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 papan reklame yang menghadap ke 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 berarti 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) opasitas [read, write, assign] |
Menetapkan opasitas penanda, antara 0 (sepenuhnya transparan) dan 1 (default) inklusif.
- (GMSMarkerLayer*) lapisan [read, assign] |
Memberikan 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, panorama tidak akan ditampilkan karena terlalu kecil.
Dapat ditetapkan ke nil untuk menghapus penanda dari tampilan panorama saat ini yang melampirkannya.
Penanda dapat ditampilkan pada panorama dan peta secara bersamaan.
- (NSString*) judul [read, write, copy, inherited] |
Judul, deskripsi singkat {i>overlay<i}.
Beberapa overlay, seperti penanda, akan menampilkan judul pada peta. Judul juga merupakan teks aksesibilitas default.
Peta tempat overlay ini berada.
Menyetel properti ini akan menambahkan overlay ke peta. Menyetelnya ke nil akan menghapus overlay ini dari peta. Overlay dapat aktif maksimal pada satu peta pada waktu tertentu.
- (BOOL) dapat diketuk [read, write, assign, inherited] |
Jika overlay ini harus menyebabkan notifikasi ketuk.
Beberapa overlay, seperti penanda, secara default dapat diketuk.
- (int) zIndex [read, write, assign, inherited] |
Overlay nilai zIndex yang lebih tinggi akan digambar di atas overlay dan lapisan ubin nilai zIndex yang lebih rendah.
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 ini pada dasarnya dianggap berada di 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. Jika tidak, siklus retensi dapat dibuat (mencegah objek dirilis).