Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps SDK for iOS

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps SDK for iOS
  3. Buat kunci yang sesuai
Lanjutkan

Memulai

Sebelum bisa mulai menangani Google Maps di iOS, Anda perlu mengunduh Google Maps SDK for iOS dan memastikan bahwa Anda memiliki kunci API.

Catatan rilis lengkap tersedia untuk setiap rilis.

Jika Anda menggunakan Google Maps SDK for iOS dengan lisensi Google Maps APIs Premium Plan, lihat panduan memulai Premium Plan sebagai gantinya.

Langkah 1: Dapatkan Xcode versi terbaru

Untuk membangun proyek menggunakan Google Maps SDK for iOS, Anda memerlukan versi 7.3 atau Xcode yang lebih baru.

Langkah 2: Pasang SDK

Gunakan CocoaPods

Google Maps SDK for iOS tersedia sebagai pod CocoaPods. CocoaPods merupakan pengelola dependensi sumber terbuka untuk proyek Swift dan Objective-C Cocoa.

Jika Anda belum memiliki alat (bantu) CocoaPods, pasang di macOS dengan menjalankan perintah berikut dari terminal. Untuk detailnya, lihat Panduan Memulai CocoaPods.

sudo gem install cocoapods

Buat Podfile untuk Google Maps SDK for iOS dan gunakan untuk memasang API serta dependensinya:

  1. Jika Anda belum memiliki proyek Xcode, buatlah sekarang dan simpan ke mesin lokal Anda. (Jika Anda masih baru dengan development iOS, buat Single View Application.)
  2. Buat file bernama Podfile dalam direktori proyek Anda. File ini mendefinisikan dependensi proyek Anda.
  3. Edit Podfile dan tambahkan dependensi Anda. Inilah contoh yang menyertakan dependensi yang Anda butuhkan untuk Google Maps SDK for iOS dan Places API for iOS (opsional):
    source 'https://github.com/CocoaPods/Specs.git'
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleMaps'
      pod 'GooglePlaces'
    end

    Pelanggan Premium Plan juga harus menambahkan: pod 'GoogleMaps/M4B'.

  4. Simpan Podfile.
  5. Buka terminal dan masuklah ke direktori berisi Podfile:

    cd <path-to-project>
  6. Jalankan perintah pod install. Ini akan memasang API yang ditetapkan dalam Podfile, beserta dependensi yang mungkin dimilikinya.

    pod install
  7. Tutup Xcode, kemudian buka (klik dua kali) file proyek .xcworkspace Anda untuk menjalankan Xcode. Untuk seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka proyek.

Pasang secara manual

Panduan ini menampilkan cara menambahkan kerangka kerja GoogleMaps secara manual ke proyek Anda dan mengonfigurasi setelan pembangunan di Xcode.

  1. Unduh file sumber SDK: GoogleMaps-2.0.1.
  2. Mekarkan file sumber.
  3. Luncurkan Xcode dan buka proyek yang ada, atau buat proyek baru. Jika Anda masih baru dengan iOS, buat Single View Application, dan nonaktifkan Use Storyboards serta aktifkan Use Automatic Reference Counting.
  4. Seret bundel berikut ke dalam proyek Anda (bila ditanya, pilih Copy items if needed):
    • Subspecs/Base/Frameworks/GoogleMapsBase.framework
    • Subspecs/Maps/Frameworks/GoogleMaps.framework
    • Subspecs/Maps/Frameworks/GoogleMapsCore.framework

    Pelanggan Premium Plan juga harus menyertakan Subspecs/M4B/Frameworks/GoogleMapsM4B.framework.

  5. Klik kanan GoogleMaps.framework di proyek Anda, dan pilih Show In Finder.
  6. Seret GoogleMaps.bundle dari folder Resources ke dalam proyek Anda. Bila dikonfirmasi, pastikan Copy items into destination group's folder tidak dipilih.
  7. Pilih proyek Anda dari Project Navigator, dan pilih sasaran aplikasi Anda.
  8. Buka tab Build Phases, dan dalam Link Binary with Libraries, tambahkan kerangka kerja berikut:
    • GoogleMapsBase.framework
    • GoogleMaps.framework
    • GoogleMapsCore.framework
    • GoogleMapsM4B.framework (Hanya pelanggan Premium Plan)
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreLocation.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  9. Pilih proyek Anda, bukan target tertentu, dan buka tab Build Settings. Di bagian Other Linker Flags, tambahkan -ObjC. Jika setelan ini tidak terlihat, ubah filter di bilah Build Settings dari Basic menjadi All.

  10. Untuk memasang Places API for iOS, lihat Mulai dengan Places API for iOS.

Langkah 4: Dapatkan kunci API

Klik tombol di bawah ini, yang akan memandu Anda menjalani proses mengaktifkan Google Maps SDK for iOS dan memperoleh kunci API. Jika proyek Anda sudah memiliki kunci API terbatas-iOS, Anda boleh menggunakan kunci itu.

Dapatkan Kunci

Alternatifnya, ikuti langkah-langkah ini untuk mendapatkan kunci API:

  1. Masuklah ke Google API Console.
  2. Buat atau pilih sebuah proyek.
  3. Klik Continue untuk mengaktifkan Google Maps SDK for iOS.
  4. Pada laman Credentials, dapatkan kunci API.
    Catatan: Jika Anda memiliki kunci dengan pembatasan iOS, Anda boleh menggunakan kunci itu. Anda bisa menggunakan kunci yang sama dengan salah satu aplikasi iOS Anda dalam proyek yang sama.
  5. Dari dialog yang menampilkan kunci API, pilih Restrict key untuk menyetel pembatasan iOS atas kunci API.
  6. Di bagian Restrictions, pilih iOS apps, kemudian masukkan identifier bundel aplikasi Anda. Misalnya: com.example.hellomap.
  7. Klik Save.

    Kunci API terbatas-iOS Anda yang baru akan muncul dalam daftar kunci API untuk proyek Anda. Kunci API adalah string karakter, seperti ini:

    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Anda juga bisa mencari kunci yang sudah ada di Google API Console.

Untuk informasi selengkapnya mengenai penggunaan Google API Console, lihat Bantuan API Console.

Langkah 5: Tambahkan kunci API ke aplikasi Anda

Swift

Tambahkan kunci API Anda ke AppDelegate.swift seperti berikut:

  1. Tambahkan pernyataan import berikut:
    import GoogleMaps
  2. Tambahkan yang berikut ini ke metode application(_:didFinishLaunchingWithOptions:) Anda , dengan mengganti YOUR_API_KEY dengan kunci API Anda:
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Jika Anda juga menggunakan Places API, tambahkan lagi kunci Anda seperti yang ditampilkan di sini:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Tambahkan kunci API Anda ke AppDelegate.m seperti berikut:

  1. Tambahkan pernyataan import berikut:
    @import GoogleMaps;
  2. Tambahkan yang berikut ini ke metode application:didFinishLaunchingWithOptions: Anda , dengan mengganti YOUR_API_KEY dengan kunci API Anda:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Jika Anda juga menggunakan Places API, tambahkan lagi kunci Anda seperti yang ditampilkan di sini:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Langkah 6: Tambahkan peta

Kode di bawah ini memperagakan cara menambahkan peta sederhana ke ViewController yang ada. Jika Anda sedang membuat aplikasi baru, ikuti dahulu petunjuk pemasangan di atas, dan buat Single View Application baru; menonaktifkan Use Storyboards namun mengaktifkan Use Automatic Reference Counting (ARC).

Kini, tambah atau perbarui beberapa metode dalam ViewController default aplikasi Anda untuk membuat dan menginisialisasi sebuah instance GMSMapView.

Swift

import UIKit
import GoogleMaps

class YourViewController: UIViewController {

  // You don't need to modify the default init(nibName:bundle:) method.

  override func loadView() {
    // 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)
    mapView.isMyLocationEnabled = true
    view = mapView

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

#import "YourViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@implementation YourViewController

// You don't need to modify the default initWithNibName:bundle: method.

- (void)loadView {
  // 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];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.myLocationEnabled = YES;
  self.view = mapView;

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

@end

Jalankan aplikasi Anda. Anda seharusnya melihat peta dengan marker tunggal berpusat di atas Sydney, Australia. Jika Anda melihat marker, namun peta tidak terlihat, konfirmasikan bahwa Anda telah menyediakan kunci API.

Langkah 7: Deklarasikan skema URL yang digunakan oleh API

Dimulai dari iOS 9 dan Xcode 7, aplikasi harus mendeklarasikan skema URL yang ingin dibuka, dengan menetapkan skema dalam file Info.plist aplikasi. Google Maps SDK for iOS akan membuka aplikasi seluler Google Maps bila pengguna mengeklik logo Google di peta, dan karena itu aplikasi Anda harus mendeklarasikan skema URL yang relevan.

Untuk mendeklarasikan skema URL yang digunakan oleh Google Maps SDK for iOS, tambahkan baris berikut ke Info.plist Anda:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>googlechromes</string>
    <string>comgooglemaps</string>
</array>

Tangkapan layar berikut menampilkan konfigurasi dalam antarmuka pengguna Xcode:

Konfigurasi LSApplicationQueriesSchemes dalam Xcode

Tanpa deklarasi di atas, kesalahan berikut akan terjadi bila pengguna mengetuk logo Google pada peta:

-canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
-canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

Untuk menghilangkan kesalahan ini, tambahkan deklarasi ke Info.plist Anda seperti dijelaskan di atas.

Bereksperimen dengan proyek demo Google Maps SDK

Cobalah demo SDK menggunakan pod try GoogleMaps. Untuk detail selengkapnya, lihat panduan untuk contoh kode.

Peningkatan versi dari versi sebelumnya

Ikuti petunjuk ini untuk meningkatkan versi proyek yang ada ke versi terbaru Google Maps SDK for iOS.

Catatan: Google Maps SDK for iOS versi 1.9.2 dan sebelumnya tersedia dalam bentuk file zip yang berisi kerangka kerja statis. Ada juga opsi untuk memasang versi terbaru dari pod CocoaPods. Dari versi 1.10.0 dan selanjutnya, Google Maps SDK for iOS hanya bisa dipasang melalui CocoaPods.

Jika Anda sebelumnya telah memasang Google Maps SDK for iOS dari file zip yang berisi kerangka kerja statis:

  1. Buang semua referensi ke kerangka kerja sebelumnya dari proyek Xcode Anda.
  2. Ikuti petunjuk di catatan di atas untuk memasang Google Maps SDK for iOS menggunakan CocoaPods.
  3. Buat perubahan yang diperlukan sebagai akibat peningkatan versi. Lihat catatan rilis untuk mengetahui daftar perubahan dalam setiap rilis.
  4. Bersihkan dan bangun kembali proyek Anda dengan memilih Product > Clean kemudian Product > Build.

Jika Anda sebelumnya telah memasang Google Maps SDK for iOS dari pod Google-Maps-iOS-SDK:

  1. Ubah nama pod Anda menjadi GoogleMaps.
  2. Jalankan pod install.
  3. Buat perubahan yang diperlukan sebagai akibat peningkatan versi. Lihat catatan rilis untuk mengetahui daftar perubahan dalam setiap rilis.
  4. Bersihkan dan bangun kembali proyek Anda dengan memilih Product > Clean kemudian Product > Build.

Jika Anda sebelumnya telah memasang Google Maps SDK for iOS dari pod GoogleMaps:

  1. Periksa Podfile Anda untuk mengetahui pembatas versi, dan pastikan membuang atau memperbarui versi tersebut untuk memastikan Anda mendapatkan versi yang dibutuhkan. Lihat catatan rilis untuk mengetahui daftar nomor versi.
  2. Jalankan pod update.
  3. Buat perubahan yang diperlukan sebagai akibat peningkatan versi. Lihat catatan rilis untuk mengetahui daftar perubahan dalam setiap rilis.
  4. Bersihkan dan bangun kembali proyek Anda dengan memilih Product > Clean kemudian Product > Build.

Kirim masukan tentang...

Google Maps SDK for iOS
Google Maps SDK for iOS
Butuh bantuan? Kunjungi halaman dukungan kami.