Faturalandırmayı etkinleştirip bir API anahtarı oluşturduktan sonra Xcode'u kurmaya hazır olursunuz. kullanacağınız bir başka proje olabilir.
Her sürüm için sürüm notları mevcuttur kullanabilirsiniz.
1. Adım: Gerekli yazılımı yükleyin
iOS için Navigasyon SDK'sını kullanarak proje oluşturmak istiyorsanız şunları indirip yüklemeniz gerekir:
- Xcode 15.0 sürümü veya sonraki sürümler
2. Adım: Xcode projesini oluşturun ve Navigation SDK'yı yükleyin
Swift Paket Yöneticisi
Navigasyon SDK'sı aracılığıyla yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için mevcut Gezinme SDK'sı bağımlılıklarını kaldırmıştır.
SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:
-
Xcode
project
veyaworkspace
dosyanızı açın, ardından Dosya > Paket Bağımlılıkları Ekleyin. - URL olarak https://github.com/googlemaps/ios-navigation-sdk adresini girin ve Enter'a basın paketi çekin ve "Paket Ekle"yi tıklayın.
-
Belirli bir
version
yüklemek için Bağımlılık Kuralı alanını sürüm temelli seçeneklerdir. Yeni projeler için en son sürümü ve "Tam Sürüm"ü kullanarak seçeneğini belirleyin. İşlem tamamlandığında "Paket Ekle"yi tıklayın. -
Paket Ürünlerini Seçin penceresinde,
GoogleNavigation
öğesinin şuraya ekleneceğini doğrulayın: belirlediğinizmain
hedefidir. İşlem tamamlandığında "Paket Ekle"yi tıklayın. -
Yüklemenizi doğrulamak için hedefinizin
General
bölmesine gidin. Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler bölümünde yüklü paketleri göreceksiniz. "Paket Bağımlılıkları"nı da görüntüleyebilirsiniz "Project Navigator"ın bölümü .
Mevcut bir projenin package
öğesini güncellemek için şu adımları izleyin:
9.0.0'dan önceki bir sürümden yeni sürüme geçiyorsanız şunları kaldırmanız gerekir: şu bağımlılıklar:
GoogleMapsBase
,GoogleMapsCore
ve Yükseltme işleminden sonraGoogleMapsM4B
. Bağımlılığı kaldırmayın:GoogleMaps
Daha fazla bilgi için Sürüm 9.0.0 Sürüm Notları.Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar, ve yerleştirilmiş içerik gibi diğer özelliklerden de faydalanabilirsiniz. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:
GoogleMapsBase
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)GoogleMapsCore
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)GoogleMapsM4B
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
- Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
- Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .
CocoaPods
, aşağıdaki adımları uygulayın:
- Xcode çalışma alanınızı kapatın. Terminali açın ve aşağıdaki komutu yürütün:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Podfile
,Podfile.resolved
ve CocoaPods dışında bir şey için kullanmıyorsanız Xcodeworkspace
.
-
Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar,
ve yerleştirilmiş içerik gibi diğer özelliklerden de faydalanabilirsiniz. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:
GoogleMaps.xcframework
GoogleMapsBase.xcframework
GoogleMapsCore.xcframework
GoogleNavigation.xcframework
-
Xcode projenizin üst düzey dizininden
GoogleMaps
öğesini kaldırın. paket.
CocoaPods
iOS için Navigasyon SDK'sı CocoaPods kapsülü. CocoaPods, Swift ve Objective-C için açık kaynaklı bir bağımlılık yöneticisidir. Kakao projeleri.
CocoaPods aracınız henüz yoksa şu tarihe kadar macOS'e yükleyin: aşağıdaki komutu terminalden çalıştırın. Ayrıntılar için CocoaPods Başlangıç kılavuzu.
sudo gem install cocoapods
iOS için Navigasyon SDK'sı için bir Podfile
oluşturun ve
yüklemeniz gerekir:
- Henüz bir Xcode projeniz yoksa şimdi bir tane oluşturun ve
yerel makinenize bakın. iOS uygulaması geliştirme konusunda yeniyseniz:
- Yeni proje oluşturun.
- iOS > Uygulama şablonu.
- Proje seçenekleri ekranında:
- Proje Adı'nı girin.
- Paket tanımlayıcısı alanının değerini kaydedin. Aşağıdaki API anahtarınızı kısıtlamak için bu değeri kullanabilirsiniz.
- Interface projesini Resimli Taslak olarak ayarlayın.
- Dil'i Swift veya Objective-C olarak ayarlayın.
- Proje dizininizde
Podfile
adlı bir dosya oluşturun. Bu projenizin bağımlılıklarını tanımlar. Podfile
öğesini düzenleyin ve bağımlılıklarınızla birlikte ekleyin. sürümlerini ziyaret edin. Aşağıda, iOS için Navigasyon SDK'sı: # Cocoapods yükleme referansı numarası Daha yenilerini tespit etmek içinsource 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleNavigation', '9.1.0' end
pod outdated
uygulamasını düzenli olarak çalıştırdığınızdan emin olun sürümleri vardır. Gerekirse, yeni sürüme geçin yükleyin.Podfile
dosyasını kaydedin.Bir terminal penceresi açın ve
Podfile
öğesini içeren dizine gidin:cd <path-to-project>
pod install
komutunu çalıştırın. Bu işlem, Bağımlılıklarla birliktePodfile
öğesinde belirtilen API'ler.pod install
Xcode'u kapatın ve ardından projenizin klasörünü açın (çift tıklayın)
.xcworkspace
dosyasını kullanarak Xcode'u başlatın. Bu andan itibaren, projeyi açmak için.xcworkspace
dosyasını kullanmanız gerekir.
Mevcut bir projenin API'sini güncellemek için şu adımları izleyin:
- Bir terminal penceresi açın ve
Podfile
öğesini içeren proje dizinine gidin. pod update
komutunu çalıştırın. Bu işlem tüm API'leri güncellerPodfile
sürümdeki en son sürüme güncelleyin.
Manuel yükleme
Bu kılavuzda, iOS için Navigasyon SDK'sını ve iOS için Haritalar SDK'sını projenize ekleyin ve derleme ayarlarınızı Xcode'da yapılandırın. XCFramework, M1 yonga seti kullanan makineler dahil olmak üzere birden fazla platformda kullanabileceğiniz bir ikili programdır.
iOS için Navigasyon SDK'sı için XCFrameworks'ü yüklemek üzere şu adımları uygulayın: ve iOS için Haritalar SDK'sı:
- Aşağıdaki SDK ikili programlarını ve kaynak dosyalarını indirin:
- Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun belirler. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS uygulaması şablonu.
- Projeden mevcut tüm Haritalar, Navigasyon ve Yerler referanslarını kaldırın.
- Aşağıdaki XCFrameworks'ü projenize sürükleyin
Hem Google Haritalar'ı hem de Google Haritalar'ı yüklemek için Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik
ve Gezinme SDK'ları (istendiğinde Gerekirse öğeleri kopyala'yı seçin):
GoogleMaps.xcframework
GoogleMapsBase.xcframework
GoogleMapsCore.xcframework
GoogleNavigation.xcframework
GoogleMaps.bundle
adlı yeri, indirdiğiniz GoogleMapsResources'tan sürükleyin Xcode projenizin en üst düzey dizinine dizin. İstendiğinde Gerekirse öğeleri kopyala'nın seçili olduğundan emin olun.- İndirdiğiniz GoogleNavigationResources'ndan
GoogleNavigation.bundle
simgesini sürükleyin Xcode projenizin en üst düzey dizinine dizin. İstendiğinde Öğeleri hedef grubun klasörüne kopyala seçili. - Project Navigator'dan projenizi seçin ve hedefi belirleyebilirsiniz.
- Derleme Aşamaları sekmesini açın ve
İkili Program'ı Kitaplıklarla Bağla'yı seçtikten sonra aşağıdaki çerçeveleri ve kitaplıkları ekleyin:
Accelerate.framework
AudioToolbox.framework
AVFoundation.framework
Contacts.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libxml2.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
Security.framework
SystemConfiguration.framework
UIKit.framework
UserNotifications.framework
WebKit.framework
- Uygulamanızın hedefinde Özellikler sekmesini seçin,
Arka Plan Modları'nı açın ve aşağıdaki modları etkinleştirin:
- Ses, AirPlay ve Pencere İçinde Pencere
- Konum güncellemeleri
- Belirli bir hedef yerine projenizi seçin ve Derleme
Ayarlar sekmesi. Diğer Bağlayıcı İşaretleri bölümünde
Hem hata ayıklama hem de yayınlama için
‑ObjC
ekleyin. Bu ayarlar görünmüyorsa filtreyi Derleme Ayarları çubuğunu Temel yerine Tümü olarak ayarlayın. Info.plist
dosyasını açın ve aşağıdaki anahtar/değer çiftlerini ekleyin:- Anahtar:
NSLocationWhenInUseUsageDescription
(Gizlilik - Kullanımda Olduğunda Konum Kullanım Açıklaması)
Değer: "Bu uygulamanın adım adım navigasyon için konumunuzu kullanması için izin gerekiyor." - Anahtar:
NSLocationAlwaysAndWhenInUseUsageDescription
(Gizlilik - Konum Her Zaman ve Kullanıldığında Kullanım Açıklaması)
Değer: "Bu uygulamanın adım adım navigasyon için konumunuzu kullanması için izin gerekiyor."
- Anahtar:
3. Adım: Apple Gizlilik Manifest dosyasını inceleyin
Apple, App Store'daki uygulamalar için uygulama gizlilik ayrıntılarını zorunlu kılar. Güncellemeler ve daha fazla bilgi için Apple App Store Gizlilik Ayrıntıları sayfasını ziyaret edin.
Apple Gizlilik Manifest dosyası, SDK'nın kaynak paketinde yer almaktadır. Gizlilik Manifest Dosyasının dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın arşivini oluşturup arşivden bir gizlilik raporu oluşturun.
4. Adım: API anahtarınızı projeye ekleyin
Aşağıdaki örneklerde, Xcode'da projenize API anahtarının nasıl ekleneceği gösterilmiştir:
Swift
API anahtarınızı AppDelegate.swift
cihazınıza aşağıdaki şekilde ekleyin:
- Aşağıdaki import (içe aktarma) ifadelerini ekleyin:
import GoogleMaps import GoogleNavigation
- Şunları ekleyin:
application(_:didFinishLaunchingWithOptions:)
yöntem:GMSServices.provideAPIKey("YOUR_API_KEY")
Objective-C
API anahtarınızı AppDelegate.m
cihazınıza aşağıdaki şekilde ekleyin:
- Aşağıdaki import (içe aktarma) ifadelerini ekleyin:
@import GoogleMaps; @import GoogleNavigation;
- Şunları ekleyin:
application:didFinishLaunchingWithOptions:
yöntem:[GMSServices provideAPIKey:@"YOUR_API_KEY"];
5. Adım: Bir harita ekleyin
Bu kod, mevcut bir ViewController
öğesine basit bir haritanın nasıl ekleneceğini göstermektedir.
ve gezinmeye ilişkin bazı ilk ayarlar dahil.
Navigasyonun etkinleştirilebilmesi için kullanıcı, şartları ve koşulları
koşullar. Kullanıcıya istem göndermek için şu numarayı arayın:
GMSNavigationServices.showTermsAndConditionsDialogIfNeeded()
, ardından kontrol edin
şartların kabul edilip edilmediğini kontrol edin. Kullanıcı şartları reddederse
mapView.isNavigationEnabled = true
etkisi yoktur ve mapView.navigator
için geçerlidir
nil.
Swift
import UIKit import GoogleNavigation class ViewController: UIViewController { var mapView: GMSMapView! var locationManager: CLLocationManager! override func loadView() { locationManager = CLLocationManager() locationManager.requestAlwaysAuthorization() let options = GMSMapViewOptions() options.camera = camera options.frame = .zero mapView = GMSMapView(options: options) // Show the terms and conditions. let termsAndConditionsOptions = GMSNavigationTermsAndConditionsOptions(companyName: "Ride Share Co.") GMSNavigationServices.showTermsAndConditionsDialogIfNeeded(with: termsAndConditionsOptions) { termsAccepted in if termsAccepted { // Enable navigation if the user accepts the terms. self.mapView.isNavigationEnabled = true } else { // Handle the case when the user rejects the terms and conditions. } } view = mapView } // TODO: Add navigation code. }
Objective-C
#import "ViewController.h" @import GoogleNavigation; @interface ViewController () @end @implementation ViewController GMSMapView *_mapView; CLLocationManager *_locationManager; - (void)loadView { _locationManager = [[CLLocationManager alloc] init]; [_locationManager requestAlwaysAuthorization]; GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.67 longitude:-122.20 zoom:14]; GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init]; options.frame = CGRectZero; options.camera = camera; options.mapID = mapID; _mapView = [[GMSMapView alloc] initWithOptions:options]; // Show the terms and conditions. GMSNavigationTermsAndConditionsOptions *termsAndConditionsOptions = [[GMSNavigationTermsAndConditionsOptions alloc] initWithCompanyName:@"Ride Sharing Co."]; [GMSNavigationServices showTermsAndConditionsDialogIfNeededWithOptions:termsAndConditionsOptions callback:^(BOOL termsAccepted) { if (termsAccepted) { // Enable navigation if the user accepts the terms. _mapView.navigationEnabled = YES; } else { // Handle the case when the user rejects the terms and conditions. } }]; self.view = _mapView; } // TODO: Add navigation code. @end
Uygulamanızı çalıştırın. Kirkland, Washington'ın merkezinde bir harita göreceksiniz.
Harita görünmüyorsa aşağıdakileri deneyin:
- Doğru API anahtarını sağladığınızdan emin olun.
- Cloud Console'da NavSDK'nın etkin olduğundan emin olun.
- Nav SDK yüklüyse ancak projeniz Nav SDK API'lerini kullanmıyorsa onu ikili programınızdan kaldırın.
Mobilite Hizmetleri müşterisiyseniz
Mobilite Hizmetleri müşterisiyseniz faturalandırma hakkında bilgi edinin. Mobilite belgelerini inceleyin. Kaydetme hakkında daha fazla bilgi için işlemleri görmek için Faturalandırma ayarlarını yapın. Gezinme SDK'sı uygulamanıza nasıl işlem kimliği ekleyeceğinizi öğrenmek için şu sayfayı ziyaret edin: Hizmet kullanımınızı Mobilite işlemleriyle ilişkilendirin.
Sırada ne var?
Artık bir API anahtarınız ve Xcode projeniz var. Şimdi uygulamalar oluşturup çalıştırabilirsiniz. iOS için Navigasyon SDK'sı, . Ayrıntılı bilgi için:
- Eğitici içerikler