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 melalui konstruktor praktis [GMSMapView mapWithFrame:camera:]. Instance ini juga dapat dibuat dengan metode default [[GMSMapView alloc] initWithFrame:] (di mana kameranya akan ditetapkan ke lokasi default).

GMSMapView hanya bisa 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
(jenis instance)	- initWithFrame:camera:
	Membuat dan menampilkan tampilan peta, dengan bingkai dan target kamera.
(jenis instance)	- initWithFrame:mapID:camera:
	Membuat 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 sesuai dengan `update`.
(BOOL)	- areEqualForRenderingPosition:position:
	Periksa apakah posisi kamera tertentu 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
(jenis instance)	+ mapWithFrame:camera:
	Membuat dan menampilkan tampilan peta dengan bingkai dan target kamera.
(jenis instance)	+ mapWithFrame:mapID:kamera:
	Penginisialisasi praktis untuk membuat dan menampilkan tampilan peta dengan bingkai, ID peta, dan target kamera.
Properti
IBOutlet id< GMSMapViewDelegate >	delegasi
	GMSMapView.
GMSCameraPosition *	camera
	Mengontrol kamera, yang menentukan cara orientasi peta.
GMSProyeksi *	proyeksi
	Menampilkan objek GMSProyeksi yang dapat Anda gunakan untuk melakukan konversi antara koordinat layar dan koordinat lintang/bujur.
BOOL	myLocationEnabled
	Mengontrol apakah lingkaran Lokasiku dan akurasi diaktifkan.
CLLocation *	Lokasiku
	Jika Lokasi Saya diaktifkan, menampilkan titik lokasi pengguna sedang digambar.
GMSMarker *	SelectedMarker
	Penanda yang dipilih.
BOOL	trafficEnabled
	Mengontrol apakah peta menggambar data lalu lintas, jika tersedia.
GMSMapViewType	mapType
	Mengontrol jenis ubin peta yang harus ditampilkan.
GMSMapStyle *	mapStyle
	Mengontrol gaya peta.
float	minZoom
	Zoom minimum (jarak jauh mungkin diperkecil).
float	maxZoom
	Zoom maksimum (yang paling dekat dengan posisi kamera ke Bumi).
BOOL	bangunanDiaktifkan
	Jika disetel, bangunan 3D akan ditampilkan jika tersedia.
BOOL	indoorEnabled
	Menetapkan apakah peta lantai ditampilkan, jika tersedia.
GMSIndoorDisplay *	indoorDisplay
	Mendapatkan instance GMSIndoorDisplay yang dapat mengamati atau mengontrol aspek tampilan data dalam ruangan.
GMSUISettings *	setelan
	Mendapatkan objek GMSUISettings, yang mengontrol setelan antarmuka pengguna untuk peta.
UIEdgeInsets	padding
	Mengontrol region 'visible' pada tampilan.
GMSMapViewPaddingAdjustmentBehavior	paddingAdjustmentBehavior
	Mengontrol cara inset area aman ditambahkan ke nilai padding.
BOOL	accessibilityElementsHidden
	Default-nya adalah YES.
GMSMapLayer *	lapisan
	Aksesor untuk jenis CALayer kustom yang digunakan untuk lapisan.
GMSFrameRate	KecepatanFrame pilihan
	Mengontrol kecepatan frame rendering.
GMSCoordinateBounds *	cameraTargetBounds
	Jika tidak kosong, batasi target kamera agar gestur tidak dapat keluar dari batas yang ditentukan.
Fungsi Terkait
(Perhatikan bahwa ini bukan fungsi anggota.)
NSString *const	kGMSAccessibilityCompass
	ID aksesibilitas untuk tombol kompas.
NSString *const	kGMSAccessibilityMyLocation
	ID aksesibilitas untuk tombol "my location".

Dokumentasi Fungsi Anggota

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

Membuat dan menampilkan tampilan peta dengan bingkai dan target kamera.

+ (instancetype) mapWithFrame:	(CGRect)	frame
ID peta:	(GMSMapID *)	IDID
kamera:	(GMSCameraPosition *)	kamera

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

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

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

- (instancetype) initWithFrame:	(CGRect)	frame
ID peta:	(GMSMapID *)	IDID
kamera:	(GMSCameraPosition *)	kamera

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

- (void) startRendering

Memberi tahu peta ini untuk menyalakan perendernya.

Hal ini bersifat opsional dan idempoten.

Catatan:: Opsi ini tidak digunakan lagi. Metode ini sudah usang dan akan dihapus dalam rilis mendatang.

- (void) stopRendering

Memberi tahu peta ini untuk mematikan perendernya.

Hal ini bersifat opsional dan idempoten.

Catatan:: Opsi ini tidak digunakan lagi. Metode ini sudah usang dan akan dihapus dalam rilis mendatang.

- (void) jelas

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 nilai minimum kurang dari atau sama dengan maksimum, dan akan melempar pengecualian dengan nama NSRangeException.

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

Buat GMSCameraPosition yang menyajikan bounds dengan padding.

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

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

- (void) moveCamera: (GMSCameraUpdate *) perbarui

Mengubah kamera sesuai dengan update.

Perubahan kamera seketika (tanpa animasi).

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

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

- (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 dikunci oleh [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirection) bearing

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

Nol menunjukkan utara sejati.

- (void) animateToViewingAngle: (ganda) sudut pandang

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

Nilai ini akan dikunci hingga minimum nol (yaitu, menghadap lurus ke bawah) dan antara 30 dan 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".

Dokumentasi Properti

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

GMSMapView.

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

Mengontrol kamera, yang menentukan cara orientasi peta.

Perubahan properti ini dapat dilakukan seketika.

- (Proyeksi *) proyeksi [read, assign]

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

Ini adalah snapshot proyeksi saat ini, dan tidak akan otomatis diupdate saat kamera bergerak. Ini mewakili proyeksi frame GMSMapView yang terakhir digambar, atau; bila kamera telah disetel secara eksplisit atau peta yang baru saja dibuat, frame yang akan datang. Nama ini tidak akan pernah berubah.

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

Mengontrol apakah lingkaran Lokasiku dan akurasi diaktifkan.

Default-nya adalah NO.

- (CLLocation*) myLocation [read, assign]

Jika Lokasi Saya diaktifkan, menampilkan titik lokasi pengguna sedang digambar.

Jika kebijakan disetel ke nonaktif, atau diaktifkan, tetapi tidak ada data lokasi yang tersedia, setelan ini akan disetel ke nol. 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 atasnya. Jika properti ini non-nil, menyetelnya ke nil akan membatalkan pilihan penanda, 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 NO.

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

- (float) minZoom [read, assign]

Zoom minimum (jarak jauh mungkin diperkecil).

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

- (float) maxZoom [read, assign]

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

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

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

Jika disetel, 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 disetel ke TIDAK, 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 'visible' 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 bahwa padding ini dan padding yang diminta akan diperhitungkan.

Properti ini dapat dianimasikan dalam blok animasi berbasis UIView.

- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign]

Mengontrol cara inset area aman ditambahkan ke nilai padding.

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

Setelan defaultnya adalah kGMSMapViewPaddingAdjustmentBehaviorAlways.

- (BOOL) accessibilityElementsTersembunyi [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 sesuai dengan 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 kGMSFrameRateMax.

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

Jika tidak kosong, batasi target kamera agar gestur tidak dapat keluar dari batas yang ditentukan.

Referensi Class GMSMapView

Ringkasan

Fungsi Anggota Publik

Fungsi Anggota Publik Statis

Properti

Fungsi Terkait

Dokumentasi Fungsi Anggota

Dokumentasi Fungsi Terkait dan Teman

Dokumentasi Properti