Seyahat ve Sipariş İlerlemesi uygulamanıza gelişmiş gezinme ve izleme sağlamak için Sürücü SDK'sını kullanabilirsiniz. Sürücü SDK'sı, İsteğe Bağlı Yolculuklar ve Teslimatlar Çözüm Filosu Motoru'nda araç konumu ve görev güncellemeleri sağlar.
Sürücü SDK'sı, Fleet Engine hizmetlerini ve özel hizmetlerinizi aracın konumundan ve durumundan haberdar eder. Örneğin, araç ONLINE
veya OFFLINE
olabilir ve gezi ilerledikçe aracın konumu değişir.
Minimum sistem gereksinimleri
Ön koşullar
Bu kılavuzda, uygulamanızın zaten gezinme SDK'sını uyguladığı ve Fleet Engine arka ucunun ayarlanıp kullanılabilir olduğu varsayılmıştır. Ancak bu örnek kod, Gezinme SDK'sının nasıl ayarlanacağına dair bir örnek sunar.
Ayrıca Google Cloud projenizde iOS için Haritalar SDK'sını etkinleştirmeniz ve bir API anahtarı almanız gerekir.
Proje Yapılandırması
Swift Paket Yöneticisi
Driver SDK, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Driver SDK bağımlılıklarını kaldırdığınızdan emin olun.
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ı Ekle'ye gidin. - URL olarak https://github.com/googlemaps/ios-driver-sdk girin, paketi almak için Enter tuşuna basın ve "Paket Ekle"yi tıklayın.
-
Belirli bir
version
yüklemek için Bağımlılık Kuralı alanını sürüm tabanlı seçeneklerden birine ayarlayın. Yeni projeler için en son sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. İşlem tamamlandığında "Paket Ekle"yi tıklayın. -
Paket Ürünlerini Seçin penceresinden
GoogleRidesharingDriver
ürününün, belirlediğinizmain
hedefine ekleneceğini doğrulayın. İş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. Paketi ve sürümünü doğrulamak için "Project Navigator"ın "Paket Bağımlılıkları" bölümünü de görüntüleyebilirsiniz.
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 şu bağımlılıkları kaldırmanız gerekir: yeni sürüme geçtikten sonra
GoogleMapsBase
,GoogleMapsCore
veGoogleMapsM4B
.GoogleMaps
için bağımlılığı kaldırmayın. Daha fazla bilgi için 9.0.0 Sürüm Notları'na bakın.Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler'i bulun. 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 > Packages > Update to En Son Paket Sürümlerine Güncelle"ye gidin.
- Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.
CocoaPods
kullanılarak eklenen mevcut Driver SDK bağımlılıklarını kaldırmak için 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
veworkspace
Xcode'larını CocoaPods dışında bir amaçla kullanmıyorsanız kaldırın.
Manuel olarak yüklenmiş mevcut Driver SDK'sını kaldırmak için aşağıdaki adımları uygulayın:
Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler'i bulun. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini
(-)
kullanın:GoogleRidesharingDriver.xcframework
Xcode projenizin üst düzey dizininden
GoogleRidesharingDriver
paketini kaldırın.
CocoaPods
CocoaPods'u kullanarak Sürücü SDK'sını yapılandırmak için aşağıdaki öğelere ihtiyacınız vardır:
- CocoaPods aracı: Bu aracı yüklemek için Terminal'i açıp aşağıdaki komutu çalıştırın.
sudo gem install cocoapods
Sürücü SDK'sı için bir Podfile oluşturun ve bu API'yi ve bağımlılıklarını yüklemek için kullanın: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örnek aşağıda verilmiştir:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
Sürücü SDK'sı için Alfa ve Beta kapsüllerini bağımlılık olarak içeren bir örneği aşağıda bulabilirsiniz:
source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git" source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
Podfile'ı kaydedin. Bir terminal penceresi açıp Podfile dosyasını içeren dizine gidin:
cd <path-to-project>
Kapsül yükleme komutunu çalıştırın. Bu işlem, Podfile'da belirtilen API'leri ve bu API'lerin sahip olabileceği tüm bağımlılıkları yükler.
pod install
Xcode'u kapatın ve ardından Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu noktadan itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.
Daha fazla bilgi için CocoaPods Başlangıç kılavuzuna bakın.
Manuel yükleme
XCFramework, Driver SDK'sını yüklemek için kullandığınız bir ikili programdır. Bu paketi, Apple silicon kullanan makineler dahil birden fazla platformda kullanabilirsiniz. Bu kılavuzda, Sürücü SDK'sını içeren XCFramework'ü projenize manuel olarak nasıl ekleyeceğiniz ve Xcode'da derleme ayarlarınızı nasıl yapılandıracağınız gösterilmektedir.
SDK ikili programını ve kaynaklarını indirin:
XCFramework'e ve kaynaklara erişmek için dosyaları çıkarın.
Xcode'u başlatın ve mevcut bir projeyi açın veya yeni proje oluşturun. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.
Henüz yoksa proje grubunuz altında bir Çerçeveler grubu oluşturun.
Sürücü SDK'sını yüklemek için
GoogleRidesharingDriver.xcframework
dosyasını projenizde Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler bölümüne sürükleyin. İstendiğinde, Öğeleri kopyala'yı seçin.İndirilen
GoogleRidesharingDriver.bundle
dosyasını Xcode projenizin üst düzey dizinine sürükleyin. İstendiğindeCopy items if needed
cihazını seçin.Project Navigator'dan projenizi ve uygulamanızın hedefini seçin.
Derleme Aşamaları sekmesini açın ve Kitaplıklarla İkili Program'ı Bağla'da mevcut değilse aşağıdaki çerçeveleri ve kitaplıkları ekleyin:
Accelerate.framework
AudioToolbox.framework
AVFoundation.framework
CoreData.framework
CoreGraphics.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libxml2.tbd
libz.tbd
LocalAuthentication.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
WebKit.framework
Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlayıcı İşaretleri bölümünde hata ayıklama ve sürüm için
-ObjC
ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel yerine Tümü olarak değiştirin.
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.
Yetkilendirme ve kimlik doğrulamayı uygulama
Sürücü uygulamanız güncellemeleri oluşturup Fleet Engine arka ucuna gönderdiğinde isteklerin geçerli erişim jetonları içermesi gerekir. Sürücü SDK'sı, bu istekleri yetkilendirmek ve doğrulamak için GMTDAuthorization
protokolüne uygun şekilde nesnenizi çağırır. Nesne, gerekli erişim jetonunu sağlamaktan sorumludur.
Uygulama geliştirici olarak jetonların nasıl oluşturulacağını siz seçersiniz. Uygulamanız aşağıdakileri yapma imkanı sağlamalıdır:
- Bir HTTPS sunucusundan JSON biçiminde erişim jetonu alın.
- Jetonu ayrıştırıp önbelleğe alın.
- Jetonu süresi dolduğunda yenileyin.
Fleet Engine sunucusunun beklediği jetonlarla ilgili ayrıntılar için Yetkilendirme için JSON Web Jetonu (JWT) oluşturma bölümüne bakın.
Sağlayıcı kimliği, Google Cloud proje kimliği ile aynıdır. Daha fazla bilgi için Fleet Engine Hızlı Başlangıç Kılavuzu'na bakın.
Aşağıdaki örnekte bir erişim jetonu sağlayıcı uygulanmaktadır:
Swift
import GoogleRidesharingDriver
private let providerURL = "INSERT_YOUR_TOKEN_PROVIDER_URL"
class SampleAccessTokenProvider: NSObject, GMTDAuthorization {
private struct AuthToken {
// The cached vehicle token.
let token: String
// Keep track of when the token expires for caching.
let expiration: TimeInterval
// Keep track of the vehicle ID the cached token is for.
let vehicleID: String
}
enum AccessTokenError: Error {
case missingAuthorizationContext
case missingData
}
private var authToken: AuthToken?
func fetchToken(
with authorizationContext: GMTDAuthorizationContext?,
completion: @escaping GMTDAuthTokenFetchCompletionHandler
) {
// Get the vehicle ID from the authorizationContext. This is set by the Driver SDK.
guard let authorizationContext = authorizationContext else {
completion(nil, AccessTokenError.missingAuthorizationContext)
return
}
let vehicleID = authorizationContext.vehicleID
// If appropriate, use the cached token.
if let authToken = authToken,
authToken.expiration > Date.now.timeIntervalSince1970 && authToken.vehicleID == vehicleID
{
completion(authToken.token, nil)
return
}
// Otherwise, try to fetch a new token from your server.
let request = URLRequest(url: URL(string: providerURL))
let task = URLSession.shared.dataTask(with: request) { [weak self] data, _, error in
guard let strongSelf = self else { return }
guard error == nil else {
completion(nil, error)
return
}
// Replace the following key values with the appropriate keys based on your
// server's expected response.
let vehicleTokenKey = "VEHICLE_TOKEN_KEY"
let tokenExpirationKey = "TOKEN_EXPIRATION"
guard let data = data,
let fetchData = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
let token = fetchData[vehicleTokenKey] as? String,
let expiration = fetchData[tokenExpirationKey] as? Double
else {
completion(nil, AccessTokenError.missingData)
return
}
strongSelf.authToken = AuthToken(
token: token, expiration: expiration, vehicleID: vehicleID)
completion(token, nil)
}
task.resume()
}
}
Objective-C
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
// SampleAccessTokenProvider.h
@interface SampleAccessTokenProvider : NSObject<GMTDAuthorization>
@end
static NSString *const PROVIDER_URL = @"INSERT_YOUR_TOKEN_PROVIDER_URL";
// SampleAccessTokenProvider.m
@implementation SampleAccessTokenProvider{
// The cached vehicle token.
NSString *_cachedVehicleToken;
// Keep track of the vehicle ID the cached token is for.
NSString *_lastKnownVehicleID;
// Keep track of when tokens expire for caching.
NSTimeInterval _tokenExpiration;
}
- (void)fetchTokenWithContext:(nullable GMTDAuthorizationContext *)authorizationContext
completion:(nonnull GMTDAuthTokenFetchCompletionHandler)completion {
// Get the vehicle ID from the authorizationContext. This is set by the Driver SDK.
NSString *vehicleID = authorizationContext.vehicleID;
if (!vehicleID) {
NSAssert(NO, @"Vehicle ID is missing from authorizationContext.");
return;
}
// Clear cached vehicle token if vehicle ID has changed.
if (![_lastKnownVehicleID isEqual:vehicleID]) {
_tokenExpiration = 0.0;
_cachedVehicleToken = nil;
}
_lastKnownVehicleID = vehicleID;
// Clear cached vehicletoken if it has expired.
if ([[NSDate date] timeIntervalSince1970] > _tokenExpiration) {
_cachedVehicleToken = nil;
}
// If appropriate, use the cached token.
if (_cachedVehicleToken) {
completion(_cachedVehicleToken, nil);
return;
}
// Otherwise, try to fetch a new token from your server.
NSURL *requestURL = [NSURL URLWithString:PROVIDER_URL];
NSMutableURLRequest *request =
[[NSMutableURLRequest alloc] initWithURL:requestURL];
request.HTTPMethod = @"GET";
// Replace the following key values with the appropriate keys based on your
// server's expected response.
NSString *vehicleTokenKey = @"VEHICLE_TOKEN_KEY";
NSString *tokenExpirationKey = @"TOKEN_EXPIRATION";
__weak typeof(self) weakSelf = self;
void (^handler)(NSData *_Nullable data, NSURLResponse *_Nullable response,
NSError *_Nullable error) =
^(NSData *_Nullable data, NSURLResponse *_Nullable response, NSError *_Nullable error) {
typeof(self) strongSelf = weakSelf;
if (error) {
completion(nil, error);
return;
}
NSError *JSONError;
NSMutableDictionary *JSONResponse =
[NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:&JSONError];
if (JSONError) {
completion(nil, JSONError);
return;
} else {
// Sample code only. No validation logic.
id expirationData = JSONResponse[tokenExpirationKey];
if ([expirationData isKindOfClass:[NSNumber class]]) {
NSTimeInterval expirationTime = ((NSNumber *)expirationData).doubleValue;
strongSelf->_tokenExpiration = [[NSDate date] timeIntervalSince1970] + expirationTime;
}
strongSelf->_cachedVehicleToken = JSONResponse[vehicleTokenKey];
completion(JSONResponse[vehicleTokenKey], nil);
}
};
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *mainQueueURLSession =
[NSURLSession sessionWithConfiguration:config delegate:nil
delegateQueue:[NSOperationQueue mainQueue]];
NSURLSessionDataTask *task = [mainQueueURLSession dataTaskWithRequest:request completionHandler:handler];
[task resume];
}
@end
RideshareDriverAPI örneği oluşturma
GMTDVehicleReporter
örneği almak için önce providerID, toolID, driverContext ve accessTokenProvider kullanarak GMTDRidesharingDriverAPI
örneği oluşturmanız gerekir. providerID, Google Cloud proje kimliği ile aynıdır. Ayrıca GMTDVehicleReporter
örneğine doğrudan drive API'sinden erişebilirsiniz.
Aşağıdaki örnek bir GMTDRidesharingDriverAPI
örneği oluşturur:
Swift
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController {
private let mapView: GMSMapView
override func viewDidLoad() {
super.viewDidLoad()
let vehicleID = "INSERT_CREATED_VEHICLE_ID"
let accessTokenProvider = SampleAccessTokenProvider()
let driverContext = GMTDDriverContext(
accessTokenProvider: accessTokenProvider,
providerID: providerID,
vehicleID: vehicleID,
navigator: mapView.navigator)
let ridesharingDriverAPI = GMTDRidesharingDriverAPI(driverContext: driverContext)
}
}
Objective-C
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
@implementation SampleViewController {
GMSMapView *_mapView;
}
- (void)viewDidLoad {
NSString *vehicleID = @"INSERT_CREATED_VEHICLE_ID";
SampleAccessTokenProvider *accessTokenProvider =
[[SampleAccessTokenProvider alloc] init];
GMTDDriverContext *driverContext =
[[GMTDDriverContext alloc] initWithAccessTokenProvider:accessTokenProvider
providerID:PROVIDER_ID
vehicleID:vehicleID
navigator:_mapView.navigator];
GMTDRidesharingDriverAPI *ridesharingDriverAPI = [[GMTDRidesharingDriverAPI alloc] initWithDriverContext:driverContext];
}
İsteğe bağlı olarak Vehicle Reporter etkinliklerini dinleme
GMTDVehicleReporter
, locationTrackingEnabled
true
olduğunda aracı düzenli aralıklarla günceller. Bu periyodik güncellemelere yanıt vermek için herhangi bir nesne, GMTDVehicleReporterListener
protokolüne uygun olarak GMTDVehicleReporter
etkinliklerine abone olabilir.
Aşağıdaki etkinlikleri yönetebilirsiniz:
vehicleReporter(_:didSucceed:)
Driver uygulamasına, arka uç hizmetlerinin araç konumu ve durum güncellemesini başarıyla aldığını bildirir.
vehicleReporter(_:didFail:withError:)
Dinleyiciyi bir araç güncellemesinin başarısız olduğu konusunda bilgilendirir. Konum izleme etkin olduğu sürece
GMTDVehicleReporter
, Fleet Engine arka ucuna en yeni verileri göndermeye devam eder.
Aşağıdaki örnekte bu etkinlikler ele alınmaktadır:
Swift
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
ridesharingDriverAPI.vehicleReporter.add(self)
}
func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
// Handle update succeeded.
}
func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didFail vehicleUpdate: GMTDVehicleUpdate, withError error: Error) {
// Handle update failed.
}
}
Objective-C
/*
* SampleViewController.h
*/
@interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
@end
/*
* SampleViewController.m
*/
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
@implementation SampleViewController {
GMSMapView *_mapView;
}
- (void)viewDidLoad {
// Assumes you have implemented the sample code up to this step.
[ridesharingDriverAPI.vehicleReporter addListener:self];
}
- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
// Handle update succeeded.
}
- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
// Handle update failed.
}
@end
GMTDVehiclereporter'ı GMSRoadSnappedLocationProvider dinleyicisi olarak ekleme
Sürücü SDK'sına konum güncellemeleri sağlamak için GMTDVehicleReporter
, GMSRoadSnappedLocationProvider
dinleyicisi olarak ayarlanmalıdır.
Swift
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
if let roadSnappedLocationProvider = mapView.roadSnappedLocationProvider {
roadSnappedLocationProvider.add(ridesharingDriverAPI.vehicleReporter)
roadSnappedLocationProvider.startUpdatingLocation()
}
}
}
Objective-C
/*
* SampleViewController.h
*/
@interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
@end
/*
* SampleViewController.m
*/
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
@implementation SampleViewController {
GMSMapView *_mapView;
}
- (void)viewDidLoad {
// Assumes you have implemented the sample code up to this step.
[_mapView.roadSnappedLocationProvider addListener:ridesharingDriverAPI.vehicleReporter];
[_mapView.roadSnappedLocationProvider startUpdatingLocation];
}
@end
Konum izlemeyi etkinleştirin
Konum izlemeyi etkinleştirmek için uygulamanız GMTDVehicleReporter
üzerinde locationTrackingEnabled
ayarını true
olarak yapabilir. GMTDVehicleReporter
, konum güncellemelerini
otomatik olarak gönderir. Hizmetler eşleşip aracı bir seyahate atadıktan sonra, GMSNavigator
navigasyon modundayken (setDestinations
üzerinden bir hedef ayarlandığında) GMTDVehicleReporter
tarafından rota güncellemelerini otomatik olarak gönderir.
Yolculuk güncellemesi sırasında ayarlanan rota, sürücünün navigasyon oturumu sırasında izlediği rota ile aynı olur. Bu nedenle, yolculuk paylaşımının düzgün çalışması için setDestinations
ile ayarlanan ara nokta, Fleet Engine arka ucunda ayarlanan hedefle eşleşmelidir.
locationTrackingEnabled
, true
olarak ayarlanırsa gezi ve araç güncellemeleri, locationUpdateInterval
için ayarlanan değere göre düzenli aralıklarla Fleet Engine arka ucuna gönderilir. locationTrackingEnabled
, false
değerine ayarlanırsa güncellemeler durdurulur ve araç durumunu GMTDVehicleState.offline
olarak ayarlamak için Fleet Engine arka ucuna son bir araç güncelleme isteği gönderilir. locationTrackingEnabled
, false
olarak ayarlandığında oluşan hataların işlenmesiyle ilgili özel noktalar için updateVehicleState
sayfasına bakın.
Aşağıdaki örnek konum izlemeyi etkinleştirir:
Swift
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = true
}
}
Objective-C
/*
* SampleViewController.m
*/
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
@implementation SampleViewController {
GMSMapView *_mapView;
}
- (void)viewDidLoad {
// Assumes you have implemented the sample code up to this step.
ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}
@end
Varsayılan olarak raporlama aralığı 10 saniyedir ancak raporlama aralığı locationUpdateInterval
ile değiştirilebilir. Desteklenen minimum güncelleme aralığı 5 saniyedir. Desteklenen maksimum güncelleme aralığı 60 saniyedir. Daha sık güncelleme yapılması daha yavaş isteklere ve hatalara neden olabilir.
Aracın durumunu güncelleyin
Aşağıdaki örnekte, araç durumunun ONLINE
olarak nasıl ayarlanacağı gösterilmektedir. Ayrıntılar için updateVehicleState
sayfasına göz atın.
Swift
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
ridesharingDriverAPI.vehicleReporter.update(.online)
}
}
Objective-C
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
@implementation SampleViewController {
GMSMapView *_mapView;
}
- (void)viewDidLoad {
// Assumes you have implemented the sample code up to this step.
[ridesharingDriverAPI.vehicleReporter
updateVehicleState:GMTDVehicleStateOnline];
}
@end
Maske boş olduğunda update_mask
hatası oluşabilir ve genellikle başlatmadan sonraki ilk güncellemede oluşur. Aşağıdaki örnekte bu hatanın nasıl işleneceği gösterilmektedir:
Swift
import GoogleRidesharingDriver
class VehicleReporterListener: NSObject, GMTDVehicleReporterListener {
func vehicleReporter(
_ vehicleReporter: GMTDVehicleReporter,
didFail vehicleUpdate: GMTDVehicleUpdate,
withError error: Error
) {
let fullError = error as NSError
if let innerError = fullError.userInfo[NSUnderlyingErrorKey] as? NSError {
let innerFullError = innerError as NSError
if innerFullError.localizedDescription.contains("update_mask cannot be empty") {
emptyMaskUpdates += 1
return
}
}
failedUpdates += 1
}
override init() {
emptyMaskUpdates = 0
failedUpdates = 0
}
}
Objective-C
#import "VehicleReporterListener.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
@implementation VehicleReporterListener {
NSInteger emptyMaskUpdates = 0;
NSInteger failedUpdates = 0;
}
- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter
didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate
withError:(NSError *)error {
for (NSError *underlyingError in error.underlyingErrors) {
if ([underlyingError.localizedDescription containsString:@"update_mask cannot be empty"]) {
emptyMaskUpdates += 1;
return;
}
}
failedUpdates += 1
}
@end
Konum güncellemelerini devre dışı bırakın ve aracı çevrimdışı yapın
Uygulamanız güncellemeleri devre dışı bırakıp aracı çevrimdışına alabilir. Örneğin, sürücü vardiyası sona erdiğinde uygulamanız locationTrackingEnabled
öğesini false
olarak ayarlayabilir.
Güncellemelerin devre dışı bırakılması da Fleet Engine arka ucunda aracın durumunu OFFLINE
olarak ayarlar.
Swift
vehicleReporter.locationTrackingEnabled = false
Objective-C
_vehicleReporter.locationTrackingEnabled = NO;