Setelah mengaktifkan penagihan dan membuat kunci API, Anda siap menyiapkan Xcode project yang Anda gunakan untuk mengembangkan aplikasi.
Catatan rilis tersedia untuk setiap data.
Langkah 1: Instal software yang diperlukan
Untuk membuat project menggunakan Maps SDK for iOS, Anda harus mendownload dan menginstal:
- Xcode versi 15.0 atau yang lebih baru
Langkah 2: Buat project Xcode dan instal Maps SDK for iOS
Swift Package Manager
Maps SDK for iOS dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda memiliki menghapus semua dependensi Maps SDK for iOS yang ada.
Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:
-
Buka
project
atauworkspace
Xcode, lalu buka File > Menambahkan Dependensi Paket. - Masukkan https://github.com/googlemaps/ios-maps-sdk sebagai URL, tekan Enter untuk menarik paket, dan klik "{i>Add Package<i}".
-
Untuk menginstal
version
tertentu, setel kolom Dependency Rule ke salah satu opsi berbasis versi. Untuk proyek baru, sebaiknya tentukan versi terbaru dan menggunakan "Versi Persis" sebelumnya. Setelah selesai, klik "Add Package". -
Dari jendela Choose Package Products, verifikasi
GoogleMaps
(untuk versi sebelum 9.0.0, verifikasiGoogleMaps
,GoogleMapsBase
, danGoogleMapsCore
) akan ditambahkan ke targetmain
yang Anda tetapkan. Setelah selesai, klik "Add Package". -
Untuk memverifikasi penginstalan, buka panel
General
target Anda. Di Frameworks, Libraries, and Embedded Content, Anda akan melihat paket yang diinstal. Anda juga dapat melihat "{i>Package Dependencies<i}" bagian "Navigator Proyek" untuk memverifikasi paket dan versinya.
Untuk mengupdate package
untuk project yang sudah ada, ikuti langkah-langkah berikut:
Jika mengupgrade dari versi yang lebih lama dari 9.0.0, Anda harus menghapus dependensi berikut:
GoogleMapsBase
,GoogleMapsCore
, danGoogleMapsM4B
setelah mengupgrade. Jangan hapus dependensi untukGoogleMaps
. Untuk informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.Dari setelan konfigurasi proyek Xcode Anda, temukan Frameworks, Libraries, dan Konten yang Disematkan. Gunakan tanda minus(-) untuk menghapus framework berikut:
GoogleMapsBase
(Hanya untuk upgrade dari versi sebelum 9.0.0)GoogleMapsCore
(Hanya untuk upgrade dari versi sebelum 9.0.0)GoogleMapsM4B
(Hanya untuk upgrade dari versi sebelum 9.0.0)
- Dari Xcode, buka "File > Paket > Update Ke Versi Paket Terbaru".
- Untuk memverifikasi penginstalan, buka bagian Package Dependencies Project Navigator untuk memverifikasi paket dan versinya.
Untuk menghapus dependensi Maps SDK for iOS yang ditambahkan menggunakan
CocoaPods
, ikuti langkah berikut:
- Tutup ruang kerja Xcode Anda. Buka terminal dan jalankan perintah berikut:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Hapus
Podfile
,Podfile.resolved
, dan Xcodeworkspace
jika Anda tidak menggunakannya untuk hal apa pun selain CocoaPods.
-
Dari setelan konfigurasi proyek Xcode Anda, temukan Frameworks, Libraries,
dan Konten yang Disematkan. Gunakan tanda minus(-) untuk menghapus framework berikut:
GoogleMaps
GoogleMapsBase
(Hanya untuk penginstalan yang lebih lama dari versi 9.0.0)GoogleMapsCore
(Hanya untuk penginstalan yang lebih lama dari versi 9.0.0)GoogleMapsM4B
(Hanya untuk penginstalan yang lebih lama dari versi 9.0.0)
-
Dari direktori level teratas project Xcode Anda, hapus
GoogleMaps
paket.
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 proyek Xcode, buat sekarang dan simpan ke
komputer lokal Anda. Jika Anda baru mengenal pengembangan iOS:
- Membuat project baru.
- Pilih iOS > Template aplikasi.
- Di layar opsi project:
- Masukkan Project Name.
- Catat nilai kolom ID paket. Anda dapat menggunakan nilai tersebut untuk membatasi kunci API di bawah.
- Tetapkan Interface project ke Storyboard.
- Setel Language ke Swift atau Objective-C.
- Buat file bernama
Podfile
dalam direktori project Anda. File ini mendefinisikan dependensi project Anda. - Edit
Podfile
dan tambahkan dependensi Anda beserta dependensi versi. Berikut ini contoh yang menyertakan dependensi yang Anda butuhkan untuk Maps SDK for iOS: Pastikan untuk menjalankansource 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.4.0' end
pod outdated
secara rutin guna mendeteksi jika ada versi yang lebih baru versi lama untuk memastikan Anda selalu mendapatkan info terbaru. Jika perlu, upgrade ke versi terbaru. - Simpan
Podfile
. Buka terminal, lalu buka 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.
Untuk mengupdate API project yang sudah ada, ikuti langkah-langkah berikut:
- Buka terminal, lalu buka direktori project yang berisi
Podfile
. - Jalankan perintah
pod update
. Tindakan ini akan mengupdate semua API yang ditentukan dalamPodfile
ke versi terbaru.
Penginstalan Manual
Panduan ini menunjukkan cara menambahkan XCFrameworks yang berisi Maps SDK for iOS secara manual ke project Anda dan mengonfigurasi setelan build di Xcode. XCFramework adalah paket biner yang dapat digunakan di berbagai platform, termasuk mesin yang menggunakan Apple silicon.- Download file resource dan biner SDK berikut:
- Ekstrak file tersebut untuk mengakses XCFrameworks dan resource.
- Jika Anda belum memiliki proyek Xcode, buat sekarang dan simpan ke
komputer lokal Anda. Jika Anda baru mengenal pengembangan iOS:
- Membuat project baru.
- Pilih iOS > Template aplikasi.
- Di layar opsi project:
- Masukkan Project Name.
- Catat nilai kolom ID paket. Anda dapat menggunakan nilai tersebut untuk membatasi kunci API di bawah.
- Tetapkan Interface project ke Storyboard.
- Setel Language ke Swift atau Objective-C.
-
Buka tab General. Tarik XCFrameworks berikut ke project Anda
di bagian Frameworks, Libraries, and Embedded Content. Pastikan
untuk memilih Do Not Embed untuk setiap XCFramework:
GoogleMaps.xcframework
GoogleMapsBase.xcframework
GoogleMapsCore.xcframework
-
Salin
GoogleMaps.bundle
dari GoogleMapsResources yang Anda unduh ke direktori level atas proyek Xcode Anda. Pastikan untuk memilih Salin item ke folder grup tujuan saat diminta. - Pilih proyek Anda dari Navigator Proyek, dan pilih target aplikasi Anda.
-
Buka tab Build Phases untuk target aplikasi Anda.
Dalam Link Binary with Libraries, tambahkan perintah berikut
framework dan library:
Accelerate.framework
Contacts.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
Metal.framework
OpenGLES.framework
(Hanya jika Anda menggunakan OpenGL)QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
-
Pilih proyek Anda, bukan target tertentu, dan buka Tab Build Settings. Pada kotak Linking - General -> Penaut Lainnya Tanda, tambahkan
-ObjC
ke "Debug" dan "{i>Release<i}". Jika setelan tidak terlihat, ubah filter di panel Build Settings dari Dasar ke Semua. -
Untuk menginstal XCFramework Places SDK for iOS, lihat Memulai dengan Places SDK for iOS.
Langkah 3: Periksa file Manifes Privasi Apple
Apple mewajibkan detail privasi aplikasi untuk aplikasi di App Store. Kunjungi halaman Detail Privasi Apple App Store untuk pembaruan dan informasi selengkapnya.
File Manifes Privasi Apple disertakan dalam paket resource untuk SDK. Untuk memverifikasi bahwa File Manifes Privasi telah disertakan, dan untuk memeriksa kontennya, buat arsip aplikasi dan buat laporan privasi dari arsip.
Langkah 4: Tambahkan kunci API Anda ke project
Di bagian Mendapatkan kunci API, Anda membuat kunci API untuk aplikasi Anda. Sekarang tambahkan kunci tersebut ke project Xcode Anda.
Pada contoh berikut, ganti YOUR_API_KEY
dengan kunci API Anda.
Swift
Tambahkan kunci API ke AppDelegate.swift
sebagai berikut:
- Tambahkan pernyataan impor berikut:
import GoogleMaps
- Tambahkan kode berikut ke
application(_:didFinishLaunchingWithOptions:)
Anda , dengan menggunakan 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 kode berikut ke
application:didFinishLaunchingWithOptions:
Anda , dengan menggunakan 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"];
Langkah 5: Tambahkan peta
Swift
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 options = GMSMapViewOptions() options.camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0) options.frame = self.view.bounds let mapView = GMSMapView(options: options) 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
#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. GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init]; options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683 longitude:151.2086 zoom:6]; options.frame = self.view.bounds; GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; [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
Langkah 5 (Opsional): Deklarasikan skema URL yang digunakan oleh API
Mulai dari iOS 9 dan Xcode 7, aplikasi dapat mendeklarasikan skema URL yang
ingin dibuka, dengan menentukan skema di file Info.plist
aplikasi. Tujuan
Maps SDK for iOS membuka aplikasi seluler Google Maps saat pengguna mengklik
logo Google di peta, sehingga aplikasi Anda dapat mendeklarasikan URL yang relevan
skema baru.
Untuk mendeklarasikan skema URL yang digunakan oleh Maps SDK for iOS, tambahkan metode
baris berikut ke Info.plist
Anda:
Tangkapan layar berikut menampilkan konfigurasi dalam antarmuka pengguna Xcode:
Tanpa deklarasi di atas, error berikut dapat terjadi saat pengguna mengetuk logo Google pada peta:
- -canOpenURL: gagal untuk URL: "comgooglemaps://" - error: "Aplikasi ini tidak diizinkan untuk mengkueri comgooglemaps skema"
- -canOpenURL: gagal untuk URL: "googlechromes://" - error: "Aplikasi ini tidak diizinkan untuk mengkueri googlechromes skema"
Untuk menghilangkan error ini, tambahkan deklarasi ke Info.plist
Anda.
Langkah berikutnya
Setelah memiliki kunci API dan project Xcode, Anda dapat membuat dan menjalankan aplikasi. Navigation SDK untuk iOS menyediakan banyak tutorial dan aplikasi contoh yang dapat membantu Anda memulai. Untuk mengetahui detail selengkapnya, lihat: