Referensi Class GMSMapView


Ringkasan

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

Instance peta harus dibuat melalui konstruktor praktis [Workspace mapWithFrame:camera:]. Objek ini juga dapat dibuat dengan metode [[dak alokasi] initWithFrame:] default (dengan kameranya akan disetel ke lokasi default).

Workspace hanya dapat dibaca dan diubah dari thread utama, seperti 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 target kamera dan bingkai.
(instancetype)- initWithFrame:mapID:camera:
 Membuat dan menampilkan tampilan peta dengan bingkai, ID peta, dan target kamera.
(tidak berlaku)- startRendering
 Memberi tahu peta ini untuk meningkatkan kualitas perendernya.
(tidak berlaku)- stopRendering
 Memberi tahu peta ini untuk mematikan perender.
(tidak berlaku)- jelas
 Menghapus semua markup yang telah ditambahkan ke peta, termasuk penanda, polyline, dan overlay bumi.
(tidak berlaku)- setMinZoom:maxZoom:
 Menetapkan minZoom dan maxZoom.
(nullable GMSCameraPosition *)- cameraForBounds:inset:
 Buat GMSCameraPosition yang menyajikan bounds dengan padding.
(tidak berlaku)- moveCamera:
 Mengubah kamera sesuai dengan update.
(BOOL)- areEqualForRenderingPosition:position:
 Periksa apakah posisi kamera tertentu akan secara praktis menyebabkan kamera dirender sama, dengan mempertimbangkan tingkat presisi dan transformasi yang digunakan secara internal.
(GMSFeatureLayer
< GMSPlaceFeature * > *)
- featureLayerOfFeatureType:
 Menampilkan lapisan fitur dari jenis yang ditentukan.
(tidak berlaku)- animateToCameraPosition:
 Menganimasikan kamera peta ini ke cameraPosition.
(tidak berlaku)- animateToLocation:
 Sebagai animateToCameraPosition:, tetapi hanya mengubah lokasi kamera (yaitu, dari lokasi saat ini ke location).
(tidak berlaku)- animateToZoom:
 Sebagai animateToCameraPosition:, tetapi hanya mengubah tingkat zoom kamera.
(tidak berlaku)- animateToBearing:
 Sebagai animateToCameraPosition:, tetapi hanya mengubah bearing kamera (dalam derajat).
(tidak berlaku)- animateToViewingAngle:
 Sebagai animateToCameraPosition:, tetapi hanya mengubah sudut pandang kamera (dalam derajat).
(tidak berlaku)- animateWithCameraUpdate:
 Menerapkan cameraUpdate ke kamera saat ini, lalu menggunakan hasilnya sesuai animateToCameraPosition:.

Fungsi Anggota Publik Statis

(instancetype)+ mapWithFrame:camera:
 Membuat dan menampilkan tampilan peta dengan target kamera dan bingkai.
(instancetype)+ mapWithFrame:mapID:camera:
 Penginisialisasi praktis untuk membuat dan menampilkan tampilan peta dengan bingkai, ID peta, dan target kamera.

Properti

ID IBOutlet< AuthenticatorDelegate >delegasikan
 Delegasi Workspace.
GMSCameraPositioncamera
 Mengontrol kamera, yang menentukan cara orientasi peta.
GMSProjectionproyeksi
 Menampilkan objek GMSProjection yang dapat Anda gunakan untuk melakukan konversi antara koordinat layar dan koordinat lintang/bujur.
BOLEHmyLocationEnabled
 Mengontrol apakah titik Lokasiku dan lingkaran akurasi diaktifkan.
CLLokasi * myLocation
 Jika Lokasiku diaktifkan, ini akan mengungkapkan tempat titik lokasi perangkat digambar.
GMSMarkerSelectedMarker
 Penanda yang dipilih.
BOLEHtrafficEnabled
 Mengontrol apakah peta menggambar data lalu lintas, jika tersedia.
DeployTypemapType
 Mengontrol jenis ubin peta yang harus ditampilkan.
GMSMapStylemapStyle
 Mengontrol gaya peta.
{i>float<i}minZoom
 Zoom minimum (terjauh kamera mungkin diperkecil).
{i>float<i}maxZoom
 Zoom maksimum (posisi kamera yang paling dekat dengan Bumi).
BOLEHbuildingsEnabled
 Jika disetel, bangunan 3D akan ditampilkan jika tersedia.
BOLEHindoorEnabled
 Menetapkan apakah peta lantai akan ditampilkan, jika tersedia.
GMSIndoorDisplayindoorDisplay
 Mendapatkan instance GMSIndoorDisplay yang memungkinkan untuk mengamati atau mengontrol aspek tampilan data dalam ruangan.
GMSUISettingssetelan
 Mendapatkan objek GMSUISettings, yang mengontrol setelan antarmuka pengguna untuk peta.
UIEdgeInsetpadding
 Mengontrol area 'terlihat' pada tampilan.
FILLINPaddingBehaviorBehaviorpaddingPenyesuaianBehavior
 Mengontrol bagaimana inset area aman ditambahkan ke nilai padding.
BOLEHaccessibilityElementsHidden
 Default-nya adalah YES.
GMSMapLayerlapisan
 Aksesor untuk jenis CALayer kustom yang digunakan untuk lapisan.
GMSFrameRatepreferredFrameRate
 Mengontrol kecepatan frame rendering.
GMSCoordinateBoundscameraTargetBounds
 Jika tidak bernilai nil, akan membatasi target kamera sehingga gestur tidak dapat menyebabkannya keluar dari 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 *constkGMSAccessibility memandu
 ID aksesibilitas untuk tombol kompas.
NSString *constkGMSAccessibilityMyLocation
 ID aksesibilitas untuk tombol "my location".
NSString *constkGMSAccessibilityOutOfQuota
 ID aksesibilitas untuk label error "habis kuota".

Dokumentasi Fungsi Anggota

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

Membuat dan menampilkan tampilan peta dengan target kamera dan bingkai.

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

Penginisialisasi praktis 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 target kamera dan bingkai.

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

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

- (void) startRendering

Memberi tahu peta ini untuk meningkatkan kualitas perendernya.

Hal ini bersifat opsional dan idempoten.

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

Memberi tahu peta ini untuk mematikan perender.

Hal ini bersifat opsional dan idempoten.

Catatan:
Ini tidak digunakan lagi. Metode ini sudah tidak berlaku dan akan dihapus dalam rilis mendatang.
- (void) 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 mengharapkan minimum kurang dari atau sama dengan maksimum, dan akan menampilkan pengecualian dengan nama NSRangeException.

- (GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds *) batas
inset: (UIEdgeInsets) inset

Buat GMSCameraPosition yang menyajikan bounds dengan padding.

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

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

- (void) moveCamera: (GMSCameraUpdate *) pembaruan

Mengubah kamera sesuai dengan update.

Perubahan kamera terjadi secara instan (tanpa animasi).

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

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

- (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: (GMSFeatureType) featureType

Menampilkan lapisan fitur dari jenis yang ditentukan.

Lapisan fitur harus dikonfigurasi di Cloud Console.

Jika lapisan dari jenis yang ditentukan tidak ada di peta ini, atau jika gaya visual berbasis data tidak diaktifkan, atau jika framework rendering Metal tidak digunakan, isAvailable lapisan yang dihasilkan akan menjadi NO, dan tidak akan merespons panggilan apa pun.

Memerlukan perender Logam. Pelajari cara mengaktifkan Metal di https://developers.google.com/maps/Document/ios-sdk/config#use-metal

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Menganimasikan kamera peta ini ke cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D) 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 dibatasi oleh [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirection) bearing

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

Nol menunjukkan utara sejati.

- (void) animateToViewingAngle: (ganda) melihatAngle

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

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

- (void) animateWithCameraUpdate: (GMSCameraUpdate *) kameraUpdate

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


- (NSString* const) kGMSAccessibility memandu [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 "habis kuota".


Dokumentasi Properti

- (ID IBOutlet<WorkspaceDelegate>) delegasi [read, write, assign]

Delegasi Workspace.

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

Mengontrol kamera, yang menentukan cara orientasi peta.

Perubahan properti ini dilakukan secara instan.

- (GMSProjection*) proyeksi [read, assign]

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

Ini adalah snapshot proyeksi saat ini dan tidak akan otomatis diperbarui saat kamera bergerak. Bingkai ini mewakili proyeksi frame Authenticator yang terakhir digambar, atau; jika kamera telah ditetapkan secara eksplisit atau peta baru saja dibuat, frame yang akan datang. Tidak akan pernah bernilai nil.

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

Mengontrol apakah titik Lokasiku dan lingkaran akurasi diaktifkan.

Nilai defaultnya adalah NO.

- (CLLocation*) myLocation [read, assign]

Jika Lokasiku diaktifkan, ini akan mengungkapkan tempat titik lokasi perangkat digambar.

Jika dinonaktifkan, atau diaktifkan tetapi tidak ada data lokasi yang tersedia, nilai ini tidak akan ada. 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 dalamnya. Jika properti ini tidak memiliki nilai nil, menetapkannya 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. Nilai defaultnya adalah NO.

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

Mengontrol jenis ubin peta yang harus ditampilkan.

Nilai defaultnya adalah kGMSTypeNormal.

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

Mengontrol gaya peta.

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

- (float) minZoom [read, assign]

Zoom minimum (terjauh kamera mungkin diperkecil).

Nilai defaultnya adalah kGMSMinZoomLevel. Diubah dengan -setMinZoom:maxZoom:.

- (float) maxZoom [read, assign]

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

Setelan defaultnya adalah kGMSMaxZoomLevel. Diubah dengan -setMinZoom:maxZoom:.

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

Jika disetel, bangunan 3D akan ditampilkan jika tersedia.

Default-nya adalah YES.

Ini mungkin berguna saat menambahkan lapisan ubin khusus ke peta, agar lebih jelas di tingkat zoom tinggi. Mengubah nilai ini akan menyebabkan semua ubin menjadi tidak valid sebentar.

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

Menetapkan apakah peta lantai akan ditampilkan, jika tersedia.

Default-nya adalah YES.

Jika ini disetel ke TIDAK, cache untuk data dalam ruangan dapat dihapus permanen dan lantai mana pun yang saat ini dipilih oleh pengguna akhir dapat disetel ulang.

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Mendapatkan instance GMSIndoorDisplay yang memungkinkan untuk 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 area '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, bagian tengah visual tampilan akan bergerak sebagaimana mestinya. Padding juga akan memengaruhi properti projection sehingga wilayah yang terlihat tidak akan menyertakan area padding. FitToBounds GMSCameraUpdate akan memastikan bahwa padding ini dan padding yang diminta akan dipertimbangkan.

Properti ini dapat dianimasikan dalam blok animasi berbasis UIView.

Mengontrol bagaimana inset area aman ditambahkan ke nilai padding.

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

Nilai defaultnya adalah kAuthenticatorPaddingAdjustmentBehaviorAlways.

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

Default-nya adalah YES.

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

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

- (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 kGMSFrameRateMaximum.

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

Jika tidak bernilai nil, akan membatasi target kamera sehingga gestur tidak dapat menyebabkannya keluar dari batas yang ditentukan.

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

Tidak mencakup kemampuan yang selalu tersedia.