Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Menambahkan Peta dengan Penanda

Tutorial ini menunjukkan cara menambahkan peta Google ke aplikasi iOS Anda. Peta tersebut mencakup penanda, yang juga disebut pin, untuk menunjukkan lokasi tertentu.

Mendapatkan kode

Clone atau download repositori contoh iOS Google Maps dari GitHub.

Menyiapkan project pengembangan

Ikuti langkah-langkah berikut untuk menginstal Maps SDK for iOS:

  1. Download dan instal Xcode versi 13.0 atau yang lebih baru.
  2. Jika Anda belum memiliki CocoaPods, instal di macOS dengan menjalankan perintah berikut dari terminal:
    sudo gem install cocoapods
  3. Clone atau download repositori contoh iOS Google Maps.
  4. Arahkan ke direktori tutorials/map-with-marker.
  5. Jalankan perintah pod install. Ini akan menginstal API yang ditentukan di Podfile, beserta dependensi yang mungkin dimiliki.
  6. Buka (klik dua kali) file map-with-Marker.xcworkspace project untuk membukanya di Xcode. Anda harus menggunakan file .xcworkspace untuk membuka project.

Mendapatkan kunci API dan mengaktifkan API yang diperlukan

Untuk menyelesaikan tutorial ini, Anda memerlukan kunci Google API yang diotorisasi untuk menggunakan Maps SDK for iOS. Klik tombol di bawah untuk mendapatkan kunci dan mengaktifkan API.

Mulai

Untuk mengetahui detail selengkapnya, lihat Mendapatkan kunci API.

Menambahkan kunci API ke aplikasi

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

  1. Perhatikan bahwa pernyataan impor berikut telah ditambahkan ke file:
    import GoogleMaps
  2. Edit baris berikut dalam metode application(_:didFinishLaunchingWithOptions:) Anda, dengan mengganti YOUR_API_KEY dengan kunci API Anda:
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

Tambahkan kunci API ke AppDelegate.m sebagai berikut:

  1. Perhatikan bahwa pernyataan impor berikut telah ditambahkan ke file:
    @import GoogleMaps;
  2. Edit baris berikut dalam metode application(_:didFinishLaunchingWithOptions:) Anda, dengan mengganti YOUR_API_KEY dengan kunci API Anda:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

Membuat dan menjalankan aplikasi

  1. Hubungkan perangkat iOS ke komputer Anda, atau pilih simulator dari menu pop-up skema Xcode.
  2. Jika Anda menggunakan perangkat, pastikan layanan lokasi diaktifkan. Jika Anda menggunakan simulator, pilih lokasi dari menu Features.
  3. Di Xcode, klik opsi menu Product/Run (atau ikon tombol putar).

Xcode mem-build aplikasi, lalu menjalankan aplikasi di perangkat atau di simulator.

Anda akan melihat peta dengan penanda yang berpusat di Sydney di pantai timur Australia, mirip dengan gambar di halaman ini.

Pemecahan masalah:

  • Jika Anda tidak melihat peta, pastikan bahwa Anda telah mendapatkan kunci API dan menambahkannya ke aplikasi, seperti yang dijelaskan di atas. Periksa konsol debug Xcode untuk pesan error tentang kunci API.
  • Jika Anda telah membatasi kunci API dengan ID paket iOS, edit kunci untuk menambahkan ID paket untuk aplikasi tersebut: com.google.examples.map-with-marker.
  • Pastikan Anda memiliki koneksi Wi-Fi atau GPS yang bagus.
  • Gunakan xdebug debugging tools untuk melihat log dan melakukan debug pada aplikasi.

Memahami kode

  1. Buat peta dan tetapkan sebagai tampilan di loadView().

    Swift

    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
    let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
    view = mapView
          

    Objective-C

    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                            longitude:151.20
                                                                 zoom:6.0];
    GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
    self.view = mapView;
          
  2. Tambahkan penanda ke peta di loadView().

    Swift

    // Creates a marker in the center of the map.
    let marker = GMSMarker()
    marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
    marker.title = "Sydney"
    marker.snippet = "Australia"
    marker.map = mapView
          

    Objective-C

    // Creates a marker in the center of the map.
    GMSMarker *marker = [[GMSMarker alloc] init];
    marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
    marker.title = @"Sydney";
    marker.snippet = @"Australia";
    marker.map = mapView;
          

Secara default, Maps SDK for iOS menampilkan konten jendela info saat pengguna mengetuk penanda. Anda tidak perlu menambahkan pemroses klik untuk penanda jika sudah puas menggunakan perilaku default.

Selamat! Anda telah membuat aplikasi iOS yang menampilkan peta Google dengan penanda untuk menunjukkan lokasi tertentu. Anda juga telah mempelajari cara menggunakan Maps SDK for iOS.

Langkah berikutnya

Pelajari lebih lanjut objek peta, dan apa yang dapat Anda lakukan dengan penanda.