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 | |
| 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 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 frame. | |
| CGPoint | groundAnchor |
| Anchor bumi menentukan titik pada gambar ikon yang ditambatkan ke posisi penanda di permukaan bumi. | |
| CGPoint | infoWindowAnchor |
| Anchor jendela info menentukan titik pada gambar ikon untuk menambatkan jendela info, yang akan ditampilkan tepat di atas titik ini. | |
| GMSMarkerAnimation | appearAnimation |
| Mengontrol animasi yang digunakan saat penanda ini ditempatkan pada GMSMapView (default kGMSMarkerAnimationNone, tanpa animasi). | |
| BOOL | dapat ditarik |
| Mengontrol apakah penanda ini dapat ditarik secara interaktif (default NO). | |
| BOOL | datar |
| Mengontrol apakah penanda ini harus datar terhadap permukaan Bumi (YA) atau baliho yang menghadap kamera (TIDAK, default). | |
| CLLocationDegrees | rotasi |
| 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. | |
| GMSMarkerLayer * | lapisan |
| Menyediakan lapisan Animasi Inti untuk GMSMarker ini. | |
| GMSPanoramaView * | panoramaView |
panoramaView menentukan tampilan panorama mana yang akan mencoba menampilkan penanda ini. | |
| NSString * | title |
| Judul, deskripsi singkat tentang overlay. | |
| GMSMapView * | map |
| Peta tempat overlay ini berada. | |
| BOOL | dapat 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. | |
| id | userData |
| 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 UIImage*) [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. 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).