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:
- Instal Xcode dan SDK.
- Dapatkan kunci API.
- Tambahkan kunci API ke aplikasi.
- 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:
- 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.)
- Buat file bernama
Podfile
dalam direktori project Anda. File ini mendefinisikan dependensi project Anda. - 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
- Simpan
Podfile
. Buka terminal dan pilih direktori yang berisi
Podfile
:cd <path-to-project>
Jalankan perintah
pod install
. Ini akan menginstal API yang ditentukan diPodfile
, beserta dependensi yang mungkin dimiliki.pod install
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.
- Download file sumber SDK: GoogleMaps-3.10.0.
- Buka ekstensi file sumber.
- 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.
- 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
. - Klik kanan
GoogleMaps.framework
di project Anda, dan pilih Show in Finder. - Tarik
GoogleMaps.bundle
dari folderResources
ke project Anda. Jika diminta, pastikan Copy items into destination group's folder tidak dipilih. - Pilih project Anda dari Navigator Project, lalu pilih sasaran aplikasi Anda.
- 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
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.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.
MemulaiAlternatifnya, ikuti langkah-langkah ini untuk mendapatkan kunci API:
- Buka Google Cloud Platform Console.
- Dari menu drop-down Project, pilih project Premium Plan.*
- Klik Lanjutkan.
- 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. - Dari dialog yang menampilkan kunci API, pilih Batasi kunci untuk menetapkan pembatasan iOS pada kunci API.
- Di bagian Pembatasan, pilih Aplikasi iOS, lalu masukkan ID paket aplikasi Anda. Contoh:
com.example.hellomap
. - 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:
- Tambahkan pernyataan impor berikut:
import GoogleMaps
- Tambahkan hal berikut ke metode
application(_:didFinishLaunchingWithOptions:)
Anda, yang menggantikan YOUR_API_KEY dengan kunci API Anda:GMSServices.provideAPIKey("YOUR_API_KEY")
- 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:
- Tambahkan pernyataan impor berikut:
@import GoogleMaps;
- Tambahkan hal berikut ke metode
application:didFinishLaunchingWithOptions:
Anda, yang menggantikan YOUR_API_KEY dengan kunci API Anda:[GMSServices provideAPIKey:@"YOUR_API_KEY"];
- 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.