Sürücü SDK'sı, sürücü uygulamanıza entegre edebileceğiniz bir kitaplıktır. Evet Fleet Engine'i sürücünün konumu, rotası, rotası ve TVS'yi gösterir. Ayrıca, navigasyon SDK'sı ile entegre olarak sürücü için adım adım navigasyon talimatları sağlar.
Minimum sistem gereksinimleri
Ön koşullar
Bu kılavuzda, uygulamanızın halihazırda Gezinme SDK'sı Filo Motoru arka ucun ayarlandı ve kullanılabilir durumda olduğundan emin olun. Ancak örnek kod, nasıl kuracağınıza dair Gezinme SDK'sı.
iOS için Haritalar SDK'sını da etkinleştirmeniz gerekir. Google Cloud projenize bağlayın ve API Anahtarı Alın.
Yerel gelişim
Yerel geliştirme için Google Cloud SDK
gcloud
gcloud auth login
Giriş yapmak için kullanılan e-posta adresi, Workspace Grubu'nun bir üyesi olmalıdır.
Otomasyon (sistem derleme veya sürekli entegrasyon)
Otomasyon ana makinelerinizi aşağıdakilere göre ayarlayın: en iyi uygulamalar:
İşleminiz bir Google Cloud ortamında çalışıyorsa otomatik kimlik bilgisi algılama.
Aksi takdirde, hizmet hesabı anahtar dosyasını ana makinenin dosya sistemini belirler ve GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini uygun şekilde kullanın.
Kimlik bilgileriyle ilişkili hizmet hesabı e-posta adresi, şu hizmetin üyesi olmalıdır: Workspace Goup.
Proje yapılandırması
Swift Paket Yöneticisi
Sürücü SDK'sı aracılığıyla yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için mevcut Driver SDK bağımlılıklarını kaldırın.
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-driver-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,
GoogleRidesharingDriver
öğ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
.
Yüklü mevcut Driver SDK'sını kaldırmak için manuel olarak yüklemek istemiyorsanız aşağıdaki adımları uygulayın:
Xcode proje yapılandırma ayarlarınızdan Frameworks, Kitaplıklar ve Yerleştirilmiş İçerikler. Kaldırmak için eksi işaretini
(-)
kullanın. şu çerçeveyi kullanabilirsiniz:GoogleRidesharingDriver.xcframework
Xcode projenizin üst düzey dizininden şunu kaldırın:
GoogleRidesharingDriver
paketi.
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çın ve aşağıdaki komuttan yararlanabilirsiniz.
sudo gem install cocoapods
Driver SDK için bir Podfile oluşturun ve bunu kullanarak API'yi ve bağımlılıkları: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleyin ve ve bildirmeyi konuştuk. 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
Bağımlılık olarak Driver SDK'sı:
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çın ve şunu içeren dizine gidin: Podfile:
cd <path-to-project>
Kapsül yükleme komutunu çalıştırın. Bu işlem, ve sahip oldukları bağımlılıkları gösterir.
pod install
Xcode'u kapatın ve ardından projenizin .xcworkspace dosyasını açın (çift tıklayın) dosyasını seçin. Bu noktadan itibaren .xcworkspace uzantılı dosyayı açın.
Daha fazla bilgi için CocoaPods rehberini inceleyin. bolca fırsat sunuyor.
Manuel yükleme
XCFramework, Sürücü SDK'sı. Bu paketi birden fazla Apple'ı kullanan makineleri de dahil olmak üzere silicon. Bu kılavuzda, öğesini içeren XCFramework'ü Projenize sürücü SDK'sı ekleyin ve derlemenizi yapılandırın Xcode'daki ayarları değiştirebilirsiniz.
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 bir proje oluşturun belirler. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS'i seçin Uygulama şablonu.
Proje grubunuz yoksa bir Çerçeveler grubu oluşturun zaten.
Sürücü SDK'sını yüklemek için
GoogleRidesharingDriver.xcframework
dosyasını Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler. İstendiğinde, Gerekirse öğeleri kopyalayın.İndirilen
GoogleRidesharingDriver.bundle
öğesini üst düzeye sürükleyin Xcode projenizin dizinini oluşturur. İstendiğindeCopy items if needed
cihazını seçin.Project Navigator'dan projenizi seçin ve hedefi belirleyebilirsiniz.
Derleme Aşamaları sekmesini açın ve İkili Program'ı Kitaplıklarla Bağla bölümünde mevcut değilse aşağıdaki çerçeveleri ve kitaplıkları kullanın:
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 sekmesi. Diğer Bağlayıcı İşaretleri bölümünde şunun için
-ObjC
ekleyin: hata ayıklamak ve yayınlamaktır. Bu ayarlar görünmüyorsa filtreleyerek Temel'i 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
Driver uygulamanız güncellemeleri oluşturup Fleet Engine arka ucuna gönderdiğinde,
bu istekler geçerli erişim jetonları içermelidir. ve yetkilerini
bu isteklerin kimliğini doğruladığınızda, Sürücü SDK'sı
GMTDAuthorization
protokolü. Nesne, gerekli erişim jetonunu sağlamaktan sorumludur.
Uygulama geliştirici olarak jetonların nasıl oluşturulacağını siz seçersiniz. Uygulamanız şunları yapmasına imkan tanımalı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 jetonların ayrıntıları için bkz. Yetkilendirme için JSON Web Token (JWT) oluşturma.
Sağlayıcı kimliği, Google Cloud proje kimliği ile aynıdır. Fleet Engine Deliveries API Kullanıcı Rehberi'ne göz atın. konulu videomuzu izleyin.
Aşağıdaki örnekte bir erişim jetonu sağlayıcı uygulanmaktadır:
#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 {
if (!completion) {
NSAssert(NO, @"%s encountered an unexpected nil completion.", __PRETTY_FUNCTION__);
return;
}
// 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 vehicle token 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
DeliveryDriverAPI örneği oluşturma
Bir GMTDDeliveryVehicleReporter
örneği almak için öncelikle bir
providerID kullanan GMTDDeliveryDriverAPI
örneği,
toolID, driveContext ve accessTokenProvider. providerID değeri şununla aynı:
Google Cloud Proje Kimliği. Ayrıca GMTDDeliveryVehicleReporter
örneğini doğrudan sürücü API'sinden alır.
Aşağıdaki örnek bir GMTDDeliveryDriverAPI
örneği oluşturur:
#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];
GMTDDeliveryDriverAPI *deliveryDriverAPI = [[GMTDDeliveryDriverAPI alloc] initWithDriverContext:driverContext];
}
İsteğe bağlı olarak Vehicle Reporter etkinliklerini dinleme
GMTDDeliveryVehicleReporter
, aşağıdaki durumlarda aracı düzenli olarak günceller:
locationTrackingEnabled
EVET. Bu düzenli güncellemelere yanıt vermek için
nesne,GMTDDeliveryVehicleReporter
GMTDVehicleReporterListener
protokolü.
Aşağıdaki etkinlikleri yönetebilirsiniz:
vehicleReporter:didSucceedVehicleUpdate
Sürücü uygulamasına, arka uç hizmetlerinin araç konumu ve durumu güncellemesi.
vehicleReporter:didFailVehicleUpdate:withError
Dinleyiciyi bir araç güncellemesinin başarısız olduğu konusunda bilgilendirir. Konum kadar izleme etkinleştirilirse
GMTDDeliveryVehicleReporter
, en son verileri Fleet Engine arka ucuna gönderir.
Aşağıdaki örnekte bu etkinlikler ele alınmaktadır:
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 IMPLEMENTED HAVE THE SAMPLE CODE UP TO THIS STEP.
[ridesharingDriverAPI.vehicleReporter addListener:self];
}
- (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
// Handle update succeeded.
}
- (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
// Handle update failed.
}
@end
Konum izlemeyi etkinleştirin
Konum izlemeyi etkinleştirmek için uygulamanız locationTrackingEnabled
ayarını YES
yapabilir
GMTDDeliveryVehicleReporter
tarihinde. Bu durumda GMTDDeliveryVehicleReporter
=
otomatik olarak konum güncellemeleri gönderir. GMSNavigator
navigasyondayken
modu (setDestinations
aracılığıyla hedef belirlendiğinde) ve
locationTrackingEnabled
YES
olarak ayarlandı, GMTDDeliveryVehicleReporter
şunu yapacak:
rota ve TVS güncellemelerini de otomatik olarak gönder.
Bu güncellemeler sırasında belirlenen rota, sürücünün bulunduğu rotayla aynı olur
gezinme oturumunda ne olduğuna karar vermelisiniz. Dolayısıyla kargo takibinin çalışması için
-setDestinations:callback:
üzerinden ayarlanan ara noktanın,
Fleet Engine arka ucunda ayarlanan hedeftir.
Aşağıdaki örnek konum izlemeyi etkinleştirir:
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 IMPLEMENTED HAVE THE SAMPLE CODE UP TO THIS STEP.
deliveryDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}
@end
Varsayılan olarak raporlama aralığı 10 saniyedir, ancak raporlama aralığı
locationUpdateInterval
ile değiştirilir. Desteklenen minimum güncelleme aralığı
5 saniyedir. Desteklenen maksimum güncelleme aralığı 60 saniyedir. Daha sık
güncellemeler daha yavaş isteklere ve hatalara neden olabilir.
Konum güncellemelerini devre dışı bırak
Uygulamanız bir aracın konum güncellemelerini devre dışı bırakabilir. Örneğin,
sürücünün vardiyası sona erdiğinde, uygulamanız locationTrackingEnabled
ayarını NO
olarak ayarlayabilir.
_vehicleReporter.locationTrackingEnabled = NO
güncelleme_mask hatalarını işleme
GMTDDeliveryVehicleReporter
araç güncellemesi gönderdiğinde update_mask
hatası, maske boşken ortaya çıkabilir ve genellikle ilk hatanın
başlatma işleminden sonra güncellenir. 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