Google Maps Mobile SDK for Work Lama: iOS

Untuk pelanggan yang memiliki lisensi Google Maps APIs for Work lama atau Google Maps API for Business, Google Maps SDK for iOS dibeli sebagai bagian dari Google Maps Mobile SDK for Work. Bagian dokumentasi ini menjelaskan persiapan untuk SDK tersebut.

Laman ini hanya untuk pelanggan yang memiliki lisensi sebelumnya dari Maps APIs for Work atau lisensi Maps API for Business. Laman ini tidak berlaku untuk pelanggan yang memiliki Google Maps APIs Premium Plan baru, yang tersedia pada Januari 2016.

Ringkasan

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

  1. Unduh SDK.
  2. Tambahkan kunci API Anda ke AppDelegate.
  3. Tambahkan peta.

Unduh 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 dan menambahkan ke aplikasi Anda

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.

Kunci API mengidentifikasi Anda sebagai pelanggan Google Maps Mobile SDK for Work dan mengaktifkan dukungan dan kuota yang dibeli untuk aplikasi Anda. Anda bisa membuat kunci API pada akun yang memiliki layanan Google Maps Mobile SDK diaktifkan dengan mendaftarkan nama paket aplikasi Anda.

Verifikasi bahwa akun Anda sudah diaktifkan untuk layanan

Google Maps Mobile SDK

Tim Google Cloud Support mengaktifkan layanan Google Maps Mobile SDK saat Anda mendaftar ke Google Maps Mobile SDK for Work. Layanan ini diaktifkan pada proyek baru.

Catatan: Hanya pemilik pertama dari proyek yang bisa melihat layanan Google Maps Mobile SDK. Untuk meminta otorisasi untuk pemilik proyek tambahan untuk melihat layanan, ajukan kasus non-teknis di Google Cloud Support Portal.

Verifikasi apakah akun Anda telah diaktifkan untuk API yang diperlukan seperti berikut:

  1. Kunjungi Google API Console dan masuk dengan akun Google Anda.
  2. Pilih proyek Google Maps Mobile SDK for Work yang dibuat untuk Anda saat Anda memesan Google Maps Mobile SDK for Work. Nama proyek dimulai dengan Google Maps APIs for Business or Google Maps for Work or Google Maps. Jika Anda belum membeli akses ke SDK, hubungi [bagian penjualan].
  3. Di Dashboard, dalam daftar API, periksa apakah Google Maps Mobile SDK diaktifkan.

Mendapatkan kunci API dari Google API Console

Setelah layanan Google Maps Mobile SDK for Work diaktifkan untuk proyek Anda, Anda harus membuat kunci API baru.

  1. Masuk ke Laman kredensial Google API Console dan masuk dengan akun Google Anda.
  2. Pilih proyek Google Maps Mobile SDK for Work yang dibuat untuk Anda saat Anda memesan Google Maps Mobile SDK for Work. Nama proyek dimulai dengan Google Maps APIs for Business or Google Maps for Work or Google Maps. Jika Anda belum membeli akses ke SDK, hubungi [bagian penjualan].
  3. Dari daftar API keys, cari kunci dengan iOS restriction.
  4. Jika proyek Anda belum memiliki iOS-restricted API key, buat kunci sekarang dengan memilih Create credentials > API key.
  5. Dalam dialog yang muncul, pilih Restrict key.
  6. Dalam bagian Restrictions, pilih iOS apps, lalu masukkan satu atau beberapa identifier bundel aplikasi. Misalnya: com.example.hellomap.
  7. Klik Save.

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

    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

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

Google Places API for iOS

Anda bebas menggunakan Google Places API for iOS di proyek Anda, tetapi API ini tidak tercakup dalam lisensi Google Maps Mobile SDK for Work Anda. Artinya, Google Places API for iOS tidak tercakup oleh tambahan dukungan atau SLA yang dibeli dengan lisensi Google Maps Mobile SDK for Work , dan semua pemakaian diatur oleh ketentuan layanan API gratis dan tidak diperhitungkan terhadap kuota Google Maps Mobile SDK for Work Anda. Harap hubungi perwakilan Google untuk informasi selengkapnya tentang mengaktifkan Google Places API for iOS.

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 Google Maps Mobile SDK for Work 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 Google Maps Mobile SDK for Work.

  Google Maps SDK for iOS Standar Google Maps Mobile SDK for Work
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 Mobile SDK for Work.

Dokumentasi

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