Referensi Class GMSMapView


Ringkasan

Ini adalah class utama Google Maps SDK for iOS dan merupakan titik entri untuk semua metode yang terkait dengan peta.

Peta harus dibuat instance-nya melalui konstruktor praktis [GMSMapView mapWithFrame:camera:]. Class ini juga dapat dibuat dengan metode default [[GMSMapView alloc] initWithFrame:] (di mana kameranya akan ditetapkan ke lokasi default).

GMSMapView hanya dapat dibaca dan diubah dari thread utama, mirip dengan semua objek UIKit. Memanggil metode ini dari thread lain akan menghasilkan pengecualian atau perilaku yang tidak ditentukan.

Fungsi Anggota Publik

(instancetype)- initWithFrame:camera:
 Membuat dan menampilkan tampilan peta, dengan bingkai dan target kamera.
(instancetype)- initWithFrame:mapID:camera:
 Mem-build dan menampilkan tampilan peta dengan bingkai, ID peta, dan target kamera.
(void)- startRendering
 Memberi tahu peta ini untuk menyalakan perendernya.
(void)- stopRendering
 Memberi tahu peta ini untuk mematikan perendernya.
(void)- hapus
 Menghapus semua markup yang telah ditambahkan ke peta, termasuk penanda, polyline, dan overlay bumi.
(void)- setMinZoom:maxZoom:
 Menetapkan minZoom dan maxZoom.
(GMSCameraPosition nullable *- cameraForBounds:insets:
 Buat GMSCameraPosition yang menyajikan bounds dengan padding.
(void)- moveCamera:
 Mengubah kamera menurut update.
(BOOL)- areEqualForRenderingPosition:position:
 Periksa apakah posisi kamera yang diberikan secara praktis akan menyebabkan kamera dirender sama, dengan mempertimbangkan tingkat presisi dan transformasi yang digunakan secara internal.
(void)- animateToCameraPosition:
 Menganimasikan kamera peta ini ke cameraPosition.
(void)- animateToLocation:
 Sebagai animateToCameraPosition:, tetapi hanya mengubah lokasi kamera (yaitu, dari lokasi saat ini ke location).
(void)- animateToZoom:
 Sebagai animateToCameraPosition: tetapi hanya mengubah tingkat zoom kamera.
(void)- animateToBearing:
 Sebagai animateToCameraPosition: tetapi hanya mengubah arah kamera (dalam derajat).
(void)- animateToViewingAngle:
 Sebagai animateToCameraPosition:, tetapi hanya mengubah sudut pandang kamera (dalam derajat).
(void)- animateWithCameraUpdate:
 Menerapkan cameraUpdate ke kamera saat ini, lalu menggunakan hasilnya sesuai dengan animateToCameraPosition:.

Fungsi Anggota Publik Statis

(instancetype)+ mapWithFrame:camera:
 Mem-build dan menampilkan tampilan peta dengan bingkai dan target kamera.
(instancetype)+ mapWithFrame:mapID:camera:
 Penginisialisasi yang mudah untuk membuat dan menampilkan tampilan peta dengan bingkai, ID peta, dan target kamera.

Properti

ID IBOutlet< GMSMapViewDelegate >delegasi
 GMSMapView yang sama.
GMSCameraPositioncamera
 Mengontrol kamera, yang menentukan cara orientasi peta.
GMSProyeksiproyeksi
 Menampilkan objek GMSProject yang dapat Anda gunakan untuk melakukan konversi antara koordinat layar dan koordinat lintang/bujur.
BOOLLokasiSayaDiaktifkan
 Mengontrol apakah titik Lokasiku dan lingkaran akurasi diaktifkan.
CLLocation * Lokasiku
 Jika Lokasi Saya diaktifkan, menunjukkan lokasi titik lokasi perangkat sedang digambar.
GMSMarkerSelectedMarker
 Penanda yang dipilih.
BOOLtrafficEnabled
 Mengontrol apakah peta menggambar data lalu lintas, jika tersedia.
GMSMapViewTypemapType
 Mengontrol jenis ubin peta yang harus ditampilkan.
GMSMapStyleMapStyle
 Mengontrol gaya peta.
mengambangminZoom
 Zoom minimum (jarak jauh dapat diperkecil).
mengambangmaxZoom
 Zoom maksimum (yang paling dekat dengan kamera terhadap Bumi).
BOOLbangunan aktif
 Jika ditetapkan, bangunan 3D akan ditampilkan jika tersedia.
BOOLindoorEnabled
 Menetapkan apakah peta lantai ditampilkan, jika tersedia.
GMSIndoorDisplayLayarIndoor
 Mendapatkan instance GMSIndoorDisplay yang dapat mengamati atau mengontrol aspek tampilan data dalam ruangan.
GMSUISettingssetelan
 Mendapatkan objek GMSUISettings, yang mengontrol setelan antarmuka pengguna untuk peta.
UIEdgeInsetspadding
 Mengontrol region 'terlihat' pada tampilan.
GMSMapViewPaddingPaddingBehaviorpaddingPenyesuaianBehavior
 Mengontrol cara inset area aman ditambahkan ke nilai padding.
BOOLaccessibilityElementsHidden
 Default-nya adalah YES.
GMSMapLayerlapisan
 Aksesor untuk jenis CALayer kustom yang digunakan untuk lapisan.
GMSFrameRatepreferredFrameRate
 Mengontrol kecepatan frame rendering.
GMSordinatBoundscameraTargetBounds
 Jika tidak nol, batasi target kamera sehingga gestur tidak dapat meninggalkan batas yang ditentukan.
GMSMapCapabilityFlagsMapCapabilities
 Semua kemampuan yang tersedia secara bersyarat (bergantung pada mapID atau setelan peta lainnya) yang tersedia pada saat ini.

(Perhatikan bahwa ini bukan fungsi anggota.)

NSString *constkGMSAccessibilityCompass
 ID aksesibilitas untuk tombol kompas.
NSString *constkGMSAccessibilityMyLocation
 ID aksesibilitas untuk tombol "my location".
NSString *constkGMSAccessibilityOutOfQuota
 ID aksesibilitas untuk label error "kuota habis".

Dokumentasi Fungsi Anggota

+ (instancetype) mapWithFrame: (CGRect) bingkai
kamera: (GMSCameraPosition *) kamera

Mem-build dan menampilkan tampilan peta dengan bingkai dan target kamera.

+ (instancetype) mapWithFrame: (CGRect) bingkai
mapID: (GMSMapID *) IDID
kamera: (GMSCameraPosition *) kamera

Penginisialisasi yang mudah untuk membuat dan menampilkan tampilan peta dengan bingkai, ID peta, dan target kamera.

- (instancetype) initWithFrame: (CGRect) bingkai
kamera: (GMSCameraPosition *) kamera

Membuat dan menampilkan tampilan peta, dengan bingkai dan target kamera.

- (instancetype) initWithFrame: (CGRect) bingkai
mapID: (GMSMapID *) IDID
kamera: (GMSCameraPosition *) kamera

Mem-build dan menampilkan tampilan peta dengan bingkai, ID peta, dan target kamera.

- (void) startRendering

Memberi tahu peta ini untuk menyalakan perendernya.

Ini bersifat opsional dan bersifat idempoten.

Catatan:
Tidak digunakan lagi. Metode ini sudah tidak berlaku dan akan dihapus dalam rilis mendatang.
- (void) stopRendering

Memberi tahu peta ini untuk mematikan perendernya.

Ini bersifat opsional dan bersifat idempoten.

Catatan:
Tidak digunakan lagi. Metode ini sudah tidak berlaku dan akan dihapus dalam rilis mendatang.
- (batal) hapus

Menghapus semua markup yang telah ditambahkan ke peta, termasuk penanda, polyline, dan overlay bumi.

Tindakan ini tidak akan menghapus titik lokasi yang terlihat atau mereset mapType saat ini.

- (void) setMinZoom: (float) minZoom
maxZoom: (float) maxZoom

Menetapkan minZoom dan maxZoom.

Metode ini mengharuskan nilai minimum kurang dari atau sama dengan nilai maksimum, dan akan menampilkan pengecualian dengan nama NSRangeException.

- (GMSCameraPosition nullable kamera *)ForBounds: (GMSRelationBounds *) batas
inset: (UIEdgeInsets) inset

Buat GMSCameraPosition yang menyajikan bounds dengan padding.

Kamera akan memiliki nol bantalan dan kemiringan (yaitu, menghadap ke utara dan melihat langsung ke Bumi). Ini memperhitungkan frame dan padding GMSMapView ini.

Jika batasnya tidak valid, metode ini akan menampilkan kamera nol.

- (void) moveCamera: (GMSCameraUpdate *) perbarui

Mengubah kamera menurut update.

Perubahan kamera terjadi seketika (tanpa animasi).

- (BOOL) adalahEqualForRenderingPosition: (GMSCameraPosition *) position
posisi: (GMSCameraPosition *) otherPosition

Periksa apakah posisi kamera yang diberikan secara praktis akan menyebabkan kamera dirender sama, dengan mempertimbangkan tingkat presisi dan transformasi yang digunakan secara internal.

- (void) animateToCameraPosition: (GMSCameraPosition *) kameraPosition

Menganimasikan kamera peta ini ke cameraPosition.

- (void) animateToLocation: (CLLocationordinat2D) lokasi

Sebagai animateToCameraPosition:, tetapi hanya mengubah lokasi kamera (yaitu, dari lokasi saat ini ke location).

- (void) animateToZoom: (float) zoom

Sebagai animateToCameraPosition: tetapi hanya mengubah tingkat zoom kamera.

Nilai ini dikunci oleh [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirection) bearing

Sebagai animateToCameraPosition: tetapi hanya mengubah arah kamera (dalam derajat).

Nol menunjukkan utara sejati.

- (void) animateToViewingAngle: (dua) sudut pandang

Sebagai animateToCameraPosition:, tetapi hanya mengubah sudut pandang kamera (dalam derajat).

Nilai ini akan dibulatkan ke minimum nol (yaitu, menghadap lurus ke bawah) dan antara 30 hingga 45 derajat ke arah cakrawala, bergantung pada kedekatan relatif dengan bumi.

- (void) animateWithCameraUpdate: (GMSCameraUpdate *) kameraUpdate

Menerapkan cameraUpdate ke kamera saat ini, lalu menggunakan hasilnya sesuai dengan animateToCameraPosition:.


- (NSString* const) kGMSAccessibilityCompass [related].

ID aksesibilitas untuk tombol kompas.

- (NSString* const) kGMSAccessibilityMyLocation [related] .

ID aksesibilitas untuk tombol "my location".

- (NSString* const) kGMSAccessibilityOutOfQuota [related]

ID aksesibilitas untuk label error "kuota habis".


Dokumentasi Properti

- (IBOutlet id<GMSMapViewDelegate>) delegasi [read, write, assign]

GMSMapView yang sama.

- (GMSCameraPosition*) kamera [read, write, copy]

Mengontrol kamera, yang menentukan cara orientasi peta.

Perubahan properti ini dilakukan secara instan.

- (Proyeksi GMS*) proyeksi [read, assign]

Menampilkan objek GMSProject yang dapat Anda gunakan untuk melakukan konversi antara koordinat layar dan koordinat lintang/bujur.

Ini adalah ringkasan proyeksi saat ini, dan tidak akan otomatis diperbarui saat kamera bergerak. Ini mewakili proyeksi frame GMSMapView yang terakhir digambar, atau; jika kamera telah disetel secara eksplisit atau peta yang baru saja dibuat, frame mendatang. Nilainya tidak akan pernah nol.

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

Mengontrol apakah titik Lokasiku dan lingkaran akurasi diaktifkan.

Default-nya adalah TIDAK.

- (CLLocation*) myLocation [read, assign]

Jika Lokasi Saya diaktifkan, menunjukkan lokasi titik lokasi perangkat sedang digambar.

Jika dinonaktifkan, atau diaktifkan, tetapi tidak ada data lokasi yang tersedia, nilainya akan menjadi nil. Properti ini dapat diamati menggunakan KVO.

- (GMSMarker*) SelectedMarker [read, write, assign]

Penanda yang dipilih.

Menetapkan properti ini akan memilih penanda tertentu, yang menampilkan jendela info di penanda tersebut. Jika properti ini bernilai nol, menyetelnya ke nil akan membatalkan pilihan penanda, dan menyembunyikan jendela info. Properti ini dapat diamati menggunakan KVO.

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

Mengontrol apakah peta menggambar data lalu lintas, jika tersedia.

Hal ini bergantung pada ketersediaan data traffic. Default-nya adalah TIDAK.

- (GMSMapViewType) mapType [read, write, assign]

Mengontrol jenis ubin peta yang harus ditampilkan.

Default-nya adalah kGMSTypeNormal.

- (GMSMapStyle*) mapStyle [read, write, assign]

Mengontrol gaya peta.

mapStyle non-nil hanya akan berlaku jika mapType adalah Normal.

- (float) minZoom [read, assign]

Zoom minimum (jarak jauh dapat diperkecil).

Default-nya adalah kGMSMinZoomLevel. Diubah dengan -setMinZoom:maxZoom:.

- (float) maxZoom [read, assign]

Zoom maksimum (yang paling dekat dengan kamera terhadap Bumi).

Default-nya adalah kGMSMaxZoomLevel. Diubah dengan -setMinZoom:maxZoom:.

- (BOOL) bangunan aktif [read, write, assign]

Jika ditetapkan, bangunan 3D akan ditampilkan jika tersedia.

Default-nya adalah YES.

Hal ini mungkin berguna saat menambahkan lapisan ubin khusus ke peta, agar lebih jelas pada tingkat zoom yang tinggi. Mengubah nilai ini akan menyebabkan semua ubin dibatalkan validasinya secara singkat.

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

Menetapkan apakah peta lantai ditampilkan, jika tersedia.

Default-nya adalah YES.

Jika kebijakan ini disetel ke NO, cache untuk data dalam ruangan dapat dihapus permanen dan lantai apa pun yang saat ini dipilih oleh pengguna akhir dapat direset.

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Mendapatkan instance GMSIndoorDisplay yang dapat mengamati atau mengontrol aspek tampilan data dalam ruangan.

- (GMSUISettings*) setelan [read, assign]

Mendapatkan objek GMSUISettings, yang mengontrol setelan antarmuka pengguna untuk peta.

- (UIEdgeInsets) padding [read, write, assign]

Mengontrol region 'terlihat' pada tampilan.

Dengan menerapkan padding, area di sekitar tepi tampilan dapat dibuat yang akan berisi data peta, tetapi tidak akan berisi kontrol UI.

Jika padding tidak seimbang, pusat visual tampilan akan bergerak sebagaimana mestinya. Padding juga akan memengaruhi properti projection sehingga wilayah yang terlihat tidak akan menyertakan area padding. GMSCameraUpdate fitToBounds akan memastikan padding ini dan padding yang diminta akan dipertimbangkan.

Properti ini dapat dianimasikan dalam blok animasi berbasis UIView.

Mengontrol cara inset area aman ditambahkan ke nilai padding.

Seperti padding, inset area aman untuk posisi kontrol peta seperti kompas, tombol lokasi saya, dan pemilih lantai dalam area aman perangkat.

Setelan default-nya adalah kGMSMapViewPadding adjustmentsBehaviorAlways.

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

Default-nya adalah YES.

Jika ditetapkan ke NO, GMSMapView akan menghasilkan elemen aksesibilitas untuk objek overlay, seperti GMSMarker dan GMSPolyline.

Properti ini mengikuti protokol UIAccessibility informal, kecuali untuk nilai default YA.

- (GMSMapLayer*) lapisan [read, retain]

Aksesor untuk jenis CALayer kustom yang digunakan untuk lapisan.

- (GMSFrameRate) preferredFrameRate [read, write, assign]

Mengontrol kecepatan frame rendering.

Nilai defaultnya adalah kGMSFrameRate dikenali.

- (GMSCoalitionBounds*) cameraTargetBounds [read, write, assign]

Jika tidak nol, batasi target kamera sehingga gestur tidak dapat meninggalkan batas yang ditentukan.

- (GMSMapCapabilityFlags) mapCapabilities [read, assign]

Semua kemampuan yang tersedia secara bersyarat (bergantung pada mapID atau setelan peta lainnya) yang tersedia pada saat ini.

Tidak termasuk kemampuan yang selalu tersedia.