Memulai Premium Plan di iOS

Lisensi Google Maps APIs Premium Plan Anda menyediakan dukungan yang disempurnakan untuk Google Maps SDK for iOS. Dokumen ini memberi tahu Anda cara membuat aplikasi iOS yang menggunakan Google Maps SDK for iOS dengan Premium Plan.

Ringkasan

Ikuti petunjuk pada laman ini untuk mengunduh SDK, mempersiapkan proyek Anda, dan menambahkan peta. Inilah rangkuman langkah-langkah yang diperlukan:

  1. Pasang Xcode dan SDK.
  2. Dapatkan kunci API.
  3. Tambahkan kunci API ke aplikasi Anda.
  4. Tambahkan peta.

Memasang Xcode dan SDK

Mendapatkan Xcode versi terbaru

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

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

Mendapatkan kunci API

Untuk mengautentikasi aplikasi ke Google Maps SDK for iOS, Anda memerlukan kunci API yang dibatasi pada identifier bundel khusus aplikasi. Kombinasi ini membuat kunci API yang terbatas-iOS.

Klik tombol di bawah ini yang akan memandu Anda menjalani proses memperoleh kunci API. Jika proyek Anda sudah memiliki kunci API dengan pembatasan iOS, Anda boleh menggunakan kunci itu. Penting: Dalam menu tarik-turun proyek, Anda harus memilih proyek yang telah dibuat untuk Anda saat membeli Google Maps APIs Premium Plan. Nama proyek dimulai dengan Google Maps APIs for Business or Google Maps for Work or Google Maps.

Dapatkan Kunci

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

  1. Masuklah ke Google API Console.
  2. Dari menu tarik-turun Project, pilih proyek Google Maps Premium.*
  3. Klik Continue.
  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.

Menambahkan 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"];

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

Informasi selengkapnya

Persyaratan atribusi

Anda harus menyertakan teks atribusi sebagai bagian dari pemberitahuan hukum dalam aplikasi Anda. Google menyarankan untuk menyertakan pemberitahuan hukum sebagai item menu tersendiri, atau sebagai bagian dari item menu "Tentang".

Anda bisa mendapatkan teks atribusi dengan membuat panggilan ke GMSServices.openSourceLicenseInfo().

Platform yang Didukung

Mengembangkan aplikasi iOS dengan Google Maps SDK for iOS yang didistribusikan bersama Premium Plan memerlukan yang berikut ini:

  • Xcode 7.3 atau lebih baru.
  • iOS SDK 8.0 atau lebih baru.

Aplikasi yang dikembangkan dengan SDK ini akan berfungsi di iOS 7.0 dan yang lebih baru.

Membandingkan versi

Tabel berikut menjelaskan perbedaan utama antara menggunakan Google Maps SDK for iOS standar dan menggunakan SDK dengan Premium Plan.

  Google Maps SDK for iOS Standar Premium Plan
Saluran Dukungan Dukungan berbasis Komunitas. Akses ke dukungan Premium.
Ketentuan Tunduk pada Ketentuan Layanan Google Maps/Google Earth API . Tunduk pada ketentuan penggunaan Google Maps APIs Premium Plan .

Dokumentasi

Sumber utama informasi tentang Google Maps SDK for iOS adalah dokumentasi referensi dan developer yang tersedia di tempat lain pada situs kami.