Menambahkan peta

Maps direpresentasikan dalam API oleh class GMSMapView, yaitu subclass dari UIView. Peta adalah objek yang paling signifikan di Maps SDK for iOS, dan menyediakan metode yang diperlukan untuk menambahkan, menghapus, dan 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 dengan peta yang Anda lihat di aplikasi iOS Google Maps, dan SDK mengekspos banyak fitur yang sama.

Selain fungsi pemetaan, API ini 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 ketuk dan ketuk dua kali.

Class kunci saat menggunakan 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 ditampilkan oleh class GMSMapView. GMSMapView memungkinkan Anda menambahkan dan menghapus penanda, overlay bumi, dan polyline, mengubah jenis peta yang ditampilkan, serta mengontrol apa yang ditampilkan di peta melalui class GMSCameraPosition.

Mem-build Peta dengan SwiftUI

SwiftUI menawarkan cara tambahan untuk membuat UI menggunakan pendekatan deklaratif. Anda memberi tahu SwiftUI tampilan yang Anda inginkan 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 berdasarkan UIKit dan tidak menyediakan tampilan yang kompatibel dengan SwiftUI. Menambahkan peta di SwiftUI memerlukan kepatuhan terhadap UIViewRepresentable atau UIViewControllerRepresentable. Untuk mempelajari lebih lanjut, lihat Codelab menambahkan peta ke aplikasi iOS dengan SwiftUI.

Menambahkan peta

Langkah-langkah dasar untuk menambahkan peta:

1. Untuk mendapatkan SDK, mendapatkan kunci API, dan menambahkan framework yang diperlukan, ikuti langkah-langkah di:

   1. Menyiapkan di konsol Google Cloud

   2. Menggunakan kunci API

   3. Menyiapkan Project Xcode

   4. Di AppDelegate, berikan kunci API Anda ke metode class provideAPIKey: di GMSServices.

   5. Buat atau perbarui ViewController. Jika peta ditampilkan saat pengontrol tampilan ini menjadi terlihat, pastikan untuk membuatnya dalam metode viewDidLoad.

   6. Saat melakukan inisialisasi tampilan peta, tetapkan opsi konfigurasi dengan GMSMapViewOptions. Properti mencakup frame, camera, mapID,backgroundColor, atau screen.

   7. Tetapkan properti camera opsi peta dengan objek GMSCameraPosition. Tindakan ini menentukan pusat dan tingkat zoom peta.

   8. Buat dan buat instance class GMSMapView menggunakan metode GMSMapView options:. Jika peta ini akan digunakan sebagai tampilan hanya pengontrol tampilan, nilai default frame opsi peta CGRectZero dapat digunakan sebagai tampilan frame — ukuran peta akan diubah secara otomatis.

   9. 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.

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
  }
}

- (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 berikutnya

Setelah menyelesaikan langkah-langkah ini, Anda dapat mengonfigurasi setelan peta.