Peta direpresentasikan di API oleh class GMSMapView
, yang merupakan subclass dari UIView
. Peta adalah objek yang paling signifikan di Maps SDK for iOS, dan menyediakan metode yang diperlukan untuk menambahkan, menghapus, serta mengelola objek lain seperti penanda dan polyline.
Pengantar
Maps SDK for iOS memungkinkan Anda menampilkan peta Google di aplikasi iOS. Peta ini memiliki tampilan yang sama seperti peta yang Anda lihat di aplikasi iOS Google Maps, dan SDK ini mengekspos banyak fitur yang sama.
Selain fungsi pemetaan, API juga mendukung berbagai interaksi yang konsisten dengan model UI iOS. Misalnya, Anda dapat menyiapkan interaksi dengan peta dengan menentukan responden yang bereaksi terhadap gestur pengguna, seperti mengetuk dan mengetuk dua kali.
Class utama saat menangani objek Peta adalah class GMSMapView
.
GMSMapView
menangani operasi berikut secara otomatis:
- Menghubungkan ke layanan Google Maps.
- Mendownload petak peta.
- Menampilkan petak peta pada layar perangkat.
- Menampilkan berbagai kontrol seperti geser dan zoom.
- Merespons gestur geser dan zoom dengan menggerakkan peta dan memperbesar atau memperkecil.
- Merespons gestur dua jari dengan memiringkan sudut pandang peta.
Selain operasi otomatis ini, Anda dapat mengontrol perilaku dan tampilan peta melalui properti dan metode yang diekspos oleh class GMSMapView
. GMSMapView
memungkinkan Anda menambahkan dan menghapus penanda, overlay bumi, dan polyline, mengubah jenis peta yang ditampilkan, dan mengontrol hal yang ditampilkan pada peta melalui class GMSCameraPosition
.
Membuat Maps dengan SwiftUI
SwiftUI menawarkan cara tambahan untuk membuat UI menggunakan pendekatan deklaratif. Anda memberi tahu SwiftUI cara yang Anda inginkan untuk menampilkan tampilan beserta semua status yang berbeda untuknya, dan sistem akan melakukan sisanya. SwiftUI menangani pembaruan tampilan setiap kali status yang mendasarinya berubah karena peristiwa atau tindakan pengguna.
Maps SDK for iOS dibuat di UIKit
dan tidak menyediakan tampilan yang kompatibel dengan SwiftUI. Untuk menambahkan peta di SwiftUI, Anda harus mematuhi UIViewRepresentable
atau UIViewControllerRepresentable
. Untuk mempelajari lebih lanjut, lihat Codelab menambahkan peta ke aplikasi iOS dengan SwiftUI.
Menambahkan peta
Langkah-langkah dasar untuk menambahkan peta:
Untuk mendapatkan SDK, mendapatkan kunci API, dan menambahkan framework yang diperlukan, ikuti langkah-langkah dalam artikel berikut:
Di
AppDelegate
, berikan kunci API Anda ke metode classprovideAPIKey:
diGMSServices
.Buat atau update
ViewController
. Jika peta ditampilkan saat pengontrol tampilan ini terlihat, pastikan untuk membuatnya dalam metodeviewDidLoad
.Saat melakukan inisialisasi tampilan peta, tetapkan opsi konfigurasi dengan
GMSMapViewOptions
. Properti mencakupframe
,camera
,mapID
,backgroundColor
atauscreen
.Tetapkan properti
camera
opsi peta dengan objekGMSCameraPosition
. Atribut ini menentukan pusat dan tingkat zoom peta.Buat dan buat instance class
GMSMapView
menggunakan metodeGMSMapView
options:
. Jika peta ini akan digunakan sebagai satu-satunya tampilan pengontrol tampilan, nilai defaultframe
opsi peta dariCGRectZero
dapat digunakan sebagai tampilanframe
— peta akan diubah ukurannya secara otomatis.Tetapkan objek
GMSMapView
sebagai tampilan pengontrol tampilan. Misalnya,self.view = mapView;
.
Contoh di bawah ini menambahkan peta, yang berpusat di pusat kota Singapura, ke aplikasi.
Swift
import GoogleMaps class MapObjects : UIViewController { override func viewDidLoad() { super.viewDidLoad() let options = GMSMapViewOptions() options.camera = GMSCameraPosition(latitude: 1.285, longitude: 103.848, zoom: 12) options.frame = self.view.bounds; let mapView = GMSMapView(options:options) self.view = mapView } }
Objective-C
- (void)viewDidLoad { [super viewDidLoad]; GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init]; options.camera = [GMSCameraPosition cameraWithLatitude:1.285 longitude:103.848 zoom:12]; options.frame = self.view.bounds; GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; self.view = mapView; }
Setelah mengikuti langkah-langkah ini, Anda dapat mengonfigurasi objek GMSMapView
lebih lanjut.
Langkah selanjutnya
Setelah menyelesaikan langkah-langkah ini, Anda dapat mengonfigurasi setelan peta.