iOS için Drive SDK'sını kullanmaya başlama

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

  • Mobil cihazda iOS 14 veya daha yeni bir sürüm yüklü olmalıdır.
  • X kodu sürüm 15 veya sonraki bir sürüme sahip olmanız gerekir.

    • Ö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.

    Erişim elde edin

    Google Workspace müşterisiyseniz Workspace Grubu: İlk katılım sırasında google-maps-platform-sdk-users@workspacedomain.com ve adı Google'a verir. Bu, önerilen yaklaşımdır. Workspace Grubunuz, şu özelliklere sahip bir izin verilenler listesine eklenir: doğru CocoaPods depolarına erişim izni verir. Kullanıcının erişimi gereken hizmet hesabı e-postaları ve hizmet hesabı e-postaları bu listede yer alır.

    Kuruluşunuz Workspace Grupları oluşturamıyorsa Google'a bir liste gönderin Bu yapılara erişmesi gereken kullanıcı ve hizmet hesabı e-postalarının sayısı.

    Yerel geliştirme

    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ı

    Sürücü SDK'sını CocoaPods kullanarak yapılandırabilirsiniz.

    CocoaPods'u kullanma

    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. shell sudo gem install cocoapods. Daha fazla bilgi için CocoaPods Başlangıç kılavuzu inceleyebilirsiniz.

    1. Sürücü SDK'sı için bir Podfile oluşturun ve API ve bağımlılıkları: Projenizde Podfile adlı bir dosya oluşturun dizin. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleme ve bağımlılıklarınızı ekleyeceksiniz. Elektronik tablo kullanarak yapılmış ve bağımlılıkları vardır:

      source "https://github.com/CocoaPods/Specs.git"

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleRidesharingDriver'
end

    2. Podfile'ı kaydedin. Bir terminal penceresi açın ve şunu içeren dizine gidin: Podfile:

      cd <path-to-project>

    3. Kapsül yükleme komutunu çalıştırın. Bu işlem, ve sahip oldukları bağımlılıkları gösterir.

      pod install

    4. Xcode'u kapatın ve ardından projenizin .xcworkspace dosyasını açın (çift tıklayın) Xcode'u başlatmak istiyorum. Bu noktadan itibaren, .xcworkspace dosyasını kullanmanız gerekir tıklayın.

    Alfa/Beta SDK sürümleri

    İhtiyacınız olan iOS için Driver SDK'sının Alfa veya Beta sürümlerini yapılandırmak üzere şu öğeler:

    • CocoaPods aracı: Bu aracı yüklemek için Terminal'i açın ve aşağıdaki komuttan yararlanabilirsiniz.

      sudo gem install cocoapods

      Daha fazla bilgi için CocoaPods başlangıç kılavuzu inceleyebilirsiniz.

    • Google erişim listesindeki geliştirme hesabınız. Kapsül deposu SDK'nın Alfa ve Beta sürümleri herkese açık kaynak değil. Alıcı: Google Müşteri Mühendisi ile iletişim kurmanız gerekir. Mühendis, geliştirme hesabınızı erişim listesine ekler ve ardından çerez ayarladığı kimlik doğrulama.

    Projeniz erişim listesinde olduktan sonra kapsüle erişebilirsiniz.

    1. iOS için Driver SDK'sı için bir Podfile oluşturun ve bunu kullanarak API ve bağımlılıkları: Projenizde Podfile adlı bir dosya oluşturun dizin. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleme ve bağımlılıklarınızı ekleyeceksiniz. Elektronik tablo kullanarak yapılmış ve bağımlılıkları vardır:

      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

    2. Podfile'ı kaydedin. Bir terminal penceresi açın ve şunu içeren dizine gidin: Podfile:

      cd <path-to-project>

    3. Kapsül yükleme komutunu çalıştırın. Bu işlem, ve sahip oldukları bağımlılıkları gösterir.

      pod install

    4. Xcode'u kapatın ve ardından projenizin .xcworkspace dosyasını açın (çift tıklayın) Xcode'u başlatmak istiyorum. Bu noktadan itibaren, .xcworkspace dosyasını kullanmanız gerekir tıklayın.

    XCFramework'ü yükleme

    XCFramework, Driver SDK'sını yüklemek için kullandığınız bir ikili program paketidir. Bu paketi, M1 yonga setini kullanan makineler de dahil olmak üzere birden çok 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:

    1. XCFramework ve kaynaklara erişmek için sıkıştırılmış dosyaları açın.

    2. Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.

    3. Zaten proje grubunuz yoksa bir Çerçeveler grubu oluşturun.

    4. İndirilen gRPCCertificates.bundle dosyasını Xcode projenizin en üst düzey dizinine sürükleyin. İstendiğinde, gerekirse Öğeleri kopyala'yı seçin.

    5. 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, gerekirse Öğeleri kopyala'yı seçin.

    6. İndirilen GoogleRidesharingDriver.bundle dosyasını Xcode projenizin en üst düzey dizinine sürükleyin. İstendiğinde Copy items if needed cihazını seçin.

    7. Project Navigator'dan projenizi seçin ve uygulamanızın hedefini belirleyin.

    8. Derleme Aşamaları sekmesini açın ve Kitaplıklarla İkili Program'ı Bağla'da, halihazırda 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

    9. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlayıcı İşaretleri bölümünde hem hata ayıklama hem de 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

    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