Memulai Premium Plan di iOS

Catatan: Premium Plan Google Maps Platform tidak lagi tersedia untuk pendaftar atau pelanggan baru.

Lisensi Premium Plan Google Maps Platform Anda memberikan dukungan yang disempurnakan untuk Maps SDK for iOS. Dokumen ini menjelaskan cara membuat aplikasi iOS yang menggunakan Maps SDK for iOS dengan Premium Plan.

Ringkasan

Ikuti petunjuk di halaman ini untuk mendownload SDK, menyiapkan project, dan menambahkan peta. Inilah rangkuman langkah-langkah yang diperlukan:

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

Menginstal Xcode dan SDK

Mendapatkan Xcode versi terbaru

Untuk membuat project menggunakan Maps SDK for iOS, Anda memerlukan versi 11.7 atau yang lebih baru dari Xcode.

Menginstal SDK

Menggunakan CocoaPods

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

Jika Anda belum memiliki alat CocoaPods, instal di macOS dengan menjalankan perintah berikut dari terminal. Untuk mengetahui detailnya, lihat Panduan Memulai CocoaPods.

sudo gem install cocoapods

Buat Podfile untuk Maps SDK for iOS dan gunakan untuk menginstal API beserta dependensinya:

  1. Jika Anda belum memiliki project Xcode, buatlah sekarang dan simpan ke komputer lokal Anda. (Jika Anda masih awam dengan pengembangan iOS, buat project baru lalu pilih iOS App template. Di Xcode 11.7 atau versi sebelumnya, buat Single View Application.)
  2. Buat file bernama Podfile dalam direktori project Anda. File ini mendefinisikan dependensi project Anda.
  3. Edit Podfile dan tambahkan dependensi Anda. Berikut adalah contoh yang menyertakan dependensi yang Anda perlukan untuk SDK Maps for iOS dan Places SDK for iOS (opsional):
    source 'https://github.com/CocoaPods/Specs.git'
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleMaps'
      pod 'GooglePlaces'
    end
  4. Simpan Podfile.
  5. Buka terminal dan pilih direktori yang berisi Podfile:

    cd <path-to-project>
  6. Jalankan perintah pod install. Ini akan menginstal API yang ditentukan di Podfile, beserta dependensi yang mungkin dimiliki.

    pod install
  7. Tutup Xcode, lalu buka (klik dua kali) file .xcworkspace project Anda untuk meluncurkan Xcode. Mulai saat ini dan seterusnya, Anda harus menggunakan file .xcworkspace untuk membuka project.

Menginstal secara manual

Panduan ini menampilkan cara menambahkan framework Google Maps secara manual ke project Anda dan mengonfigurasi setelan build di Xcode.

  1. Download file sumber SDK: GoogleMaps-3.10.0.
  2. Buka ekstensi file sumber.
  3. Luncurkan Xcode dan buka project yang ada, atau buat project baru. Jika Anda baru mengenal iOS, buat Single View Application, lalu nonaktifkan Use Storyboard dan aktifkan Use Automatic Reference Counting.
  4. Tarik paket berikut ke dalam project Anda (saat diminta, pilih Copy items if needed, please use the same version as above.):
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework

    Pelanggan Premium Plan juga harus menyertakan GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework.

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

  10. Untuk menginstal Places SDK for iOS, lihat Memulai SDK Places for iOS.

Mendapatkan kunci API

Untuk mengautentikasi aplikasi ke SDK Maps for iOS, Anda memerlukan kunci API yang dibatasi untuk ID paket khusus aplikasi. Kombinasi ini membuat kunci API yang dibatasi iOS.

Klik tombol di bawah, yang akan memandu Anda melalui proses untuk mendapatkan kunci API. Jika project Anda sudah memiliki kunci API dengan pembatasan iOS, Anda dapat menggunakan kunci tersebut. Penting: Di menu drop-down project, Anda harus memilih project yang dibuat untuk Anda saat membeli Premium Plan Google Maps Platform. Nama project diawali dengan Google Maps API for Business atau Google Maps for Work atau Google Maps.

Memulai

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

  1. Buka Google Cloud Platform Console.
  2. Dari menu drop-down Project, pilih project Premium Plan.*
  3. Klik Lanjutkan.
  4. Di halaman Kredensial, 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 project yang sama.
  5. Dari dialog yang menampilkan kunci API, pilih Batasi kunci untuk menetapkan pembatasan iOS pada kunci API.
  6. Di bagian Pembatasan, pilih Aplikasi iOS, lalu masukkan ID paket aplikasi Anda. Contoh: com.example.hellomap.
  7. Klik Simpan.

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

    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Anda juga dapat mencari kunci yang ada di Google Cloud Platform Console.

Untuk informasi selengkapnya tentang cara menggunakan Google Cloud Platform Console, lihat Bantuan Google Cloud Platform Console.

Menambahkan kunci API ke aplikasi

Swift

Tambahkan kunci API ke AppDelegate.swift sebagai berikut:

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

Objective-C

Tambahkan kunci API ke AppDelegate.m sebagai berikut:

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

Menambahkan peta

Kode di bawah ini menunjukkan cara menambahkan peta sederhana ke ViewController yang ada. Jika Anda membuat aplikasi baru, pertama-tama ikuti petunjuk penginstalan SDK di atas, lalu buat project baru dan pilih iOS App template. Catatan: pada versi 11.7, buat Single View Application.

Sekarang, tambahkan atau perbarui beberapa metode dalam ViewController default aplikasi Anda untuk membuat dan melakukan inisialisasi instance GMSMapView.

Swift

/*
 * Copyright 2020 Google Inc. All rights reserved.
 *
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
 * file except in compliance with the License. You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 * ANY KIND, either express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // 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: self.view.frame, camera: camera)
        self.view.addSubview(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

/*
* Copyright 2020 Google Inc. All rights reserved.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
* file except in compliance with the License. You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under
* the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
* ANY KIND, either express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/

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

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
  // Do any additional setup after loading the view.
  // 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:self.view.frame camera:camera];
  mapView.myLocationEnabled = YES;
  [self.view addSubview: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 penanda tunggal berpusat di atas Sydney, Australia. Jika Anda melihat penanda, tetapi peta tidak terlihat, pastikan bahwa Anda telah menyediakan kunci API.

Informasi selengkapnya

Persyaratan atribusi

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

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

Platform yang didukung

Mengembangkan aplikasi iOS dengan Maps SDK for iOS yang didistribusikan dengan Premium Plan memerlukan hal berikut:

  • Xcode 11.7 atau versi yang lebih baru
  • iOS SDK 11.0 atau versi yang lebih baru.

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

Membandingkan versi

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

  Maps SDK for iOS standar Premium Plan
Saluran Dukungan Dukungan dari komunitas. Akses ke dukungan Premium.
Persyaratan Tunduk pada Persyaratan Layanan Google Maps Platform. Tunduk pada Persyaratan Penggunaan Premium Plan Google Maps Platform.

Dokumentasi

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