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

Sürücü SDK'sı, sürücü uygulamanıza entegre ettiğiniz bir kitaplıktır. Fleet Engine'i aracın konumu, rotası, kalan mesafe ve tahmini varış süresi ile güncellemekten sorumludur. Ayrıca, sürücü için adım adım navigasyon talimatları sağlayan Navigasyon SDK'sı ile de entegredir.

Minimum sistem gereksinimleri

  • Mobil cihaz iOS 13 veya sonraki bir sürümü çalıştırıyor olmalıdır.
  • Xcode 14 veya sonraki bir sürümü.

    • Ön koşullar

    Bu kılavuzda, uygulamanızın zaten Gezinme SDK'sı uyguladığı ve Fleet Engine arka ucunun ayarlandığı ve kullanılabilir olduğu varsayılır. Ancak örnek kod, Navigasyon SDK'sının nasıl ayarlanacağına dair bir örnek sağlar.

    Ayrıca Google Cloud Projenizde iOS için Haritalar SDK'sını etkinleştirmeniz ve API Anahtarı Almanız gerekir.

    Erişim elde edin

    Google Workspace müşterisiyseniz ilk katılım sırasında google-maps-platform-sdk-users@workspacedomain.com gibi bir Workspace Grubu oluşturun ve bu adı Google'a verin. Önerilen yaklaşım budur. Ardından Workspace grubunuz doğru CocoaPods depolarına erişim izni veren bir izin verilenler listesine eklenir. Erişim gerektiren kullanıcı e-postalarının ve hizmet hesabı e-postalarının bu listeye dahil edildiğinden emin olun.

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

    Yerel geliştirme

    Yerel geliştirme için Google Cloud SDK ile giriş yapmanız yeterlidir.

    gcloud

    gcloud auth login

    Oturum açmak için kullanılan e-posta adresi, Workspace Grubunun bir üyesi olmalıdır.

    Otomasyon (sistemler oluşturma veya sürekli entegrasyon)

    Otomasyon ana makinelerinizi en iyi uygulamalara göre ayarlayın:

    • İşleminiz bir Google Cloud ortamında çalışıyorsa otomatik kimlik bilgisi algılamayı kullanın.

    • Aksi takdirde, hizmet hesabı anahtar dosyasını ana makinenin dosya sisteminde güvenli bir konumda depolayın ve GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini uygun şekilde ayarlayın.

    Kimlik bilgileriyle ilişkili hizmet hesabı e-posta adresi, Workspace Grubunun bir üyesi olmalıdır.

    Proje yapılandırması

    iOS için Sürücü SDK'sını Cocoapods kullanarak veya manuel olarak yapılandırabilirsiniz.

    Cocoapod kullanın

    iOS için Sürücü SDK'sını yapılandırmak üzere 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. shell sudo gem install cocoapods Daha fazla bilgi için CocoaPods Başlangıç Kılavuzu'na bakın.

    1. iOS için Sürücü SDK'sına yönelik bir Podfile oluşturun ve API'yi ve bağımlılıklarını yüklemek için bu SDK'yı kullanın: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile dosyasını düzenleyin ve bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örnek verelim:

      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 Podfile dosyasını içeren dizine gidin:

      cd <path-to-project>

    3. Kapsül yükleme komutunu çalıştırın. Bu işlem, Podfile dosyasında belirtilen API'leri sahip olabilecekleri bağımlılıklarla birlikte yükler.

      pod install

    4. Xcode'u kapatın ve Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu tarihten itibaren, projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

    XCFramework'ü yükleme

    SDK ikili programını ve kaynakları indirin:

    XCFramework, Sürücü 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 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.

    1. XCFramework ve kaynaklara erişmek için sıkıştırılmış dosyaları paketinden çıkarı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. Henüz mevcut değilse proje grubunuzun altında bir Frameworks 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ı Frameworks, Libraries and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) altındaki projenize 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'i 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 Bağlantı İkili Programı'nda, aşağıdaki çerçeveleri ve kitaplıkları, henüz yoksa 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 Build Settings (Derleme Ayarları) sekmesini açın. Diğer Bağlayıcı İşaretleri bölümüne hem hata ayıklama hem de sürüm için ‑ObjC ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğunda Temel olan filtreyi Tümü olarak değiştirin.

    Alfa/Beta SDK sürümleri

    iOS için Sürücü SDK'sının Alfa veya Beta sürümlerini 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

      Daha fazla bilgi için CocoaPods Başlangıç Kılavuzu'na bakın.

    • Google erişim listesindeki geliştirme hesabınız. SDK'nın Alfa ve Beta sürümlerinin kapsül deposu, herkese açık kaynak değildir. Bu sürümlere erişmek için bir Google Müşteri Mühendisi ile iletişime geçin. Mühendis, geliştirme hesabınızı erişim listesine ekler ve ardından kimlik doğrulama için bir çerez ayarlar.

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

    1. iOS için Sürücü SDK'sına yönelik bir Podfile oluşturun ve API'yi ve bağımlılıklarını yüklemek için bu SDK'yı kullanın: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile dosyasını düzenleyin ve bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örnek verelim:

      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 Podfile dosyasını içeren dizine gidin:

      cd <path-to-project>

    3. Kapsül yükleme komutunu çalıştırın. Bu komut, olabilecek bağımlılıklarla birlikte Podfile'da belirtilen API'leri yükler.

      pod install

    4. Xcode'u kapatın ve Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu tarihten itibaren, projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

    Yetkilendirme ve kimlik doğrulamayı uygulama

    Sürücü uygulamanız Fleet Engine arka ucuna güncelleme oluşturup gönderdiğinde, isteklerin geçerli erişim jetonları içermesi gerekir. Sürücü SDK'sı, bu istekleri yetkilendirmek ve kimliklerini doğrulamak için GMTDAuthorization protokolüne uygun olarak nesnenizi çağırır. Nesne, gerekli erişim jetonunu sağlamaktan sorumludur.

    Uygulama geliştiricisi olarak jetonların nasıl oluşturulacağını siz seçersiniz. Uygulamanız, aşağıdakileri yapabilmenizi sağlamalıdır:

    • Bir HTTPS sunucusundan büyük olasılıkla JSON biçiminde bir erişim jetonu alın.
    • Jetonu ayrıştırıp önbelleğe alın.
    • Süresi dolan jetonu yenileyin.

    Fleet Engine sunucusunun beklediği jetonların 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 Deliveries API Kullanıcı Kılavuzu'na bakın.

    Aşağıdaki örnekte bir erişim jetonu sağlayıcısı 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 önce providerID, vehicleID, driverContext ve accessTokenProvider kullanarak bir GMTDDeliveryDriverAPI örneği oluşturmanız gerekir. providerID, Google Cloud proje kimliği ile aynıdır. Ayrıca, GMTDDeliveryVehicleReporter örneğine doğrudan sürücü API'sinden erişebilirsiniz.

    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 VehicleReporter etkinliklerini dinleyin

    locationTrackingEnabled EVET olduğunda GMTDDeliveryVehicleReporter, aracı düzenli olarak günceller. Herhangi bir nesne, bu periyodik güncellemelere yanıt vermek için GMTDVehicleReporterListener protokolüne uyarak GMTDDeliveryVehicleReporter etkinliklerine abone olabilir.

    Aşağıdaki etkinlikleri yapabilirsiniz:

    • vehicleReporter:didSucceedVehicleUpdate

      Sürücü uygulamasına, arka uç hizmetlerinin araç konumu ve durum güncellemesini başarıyla aldığını bildirir.

    • vehicleReporter:didFailVehicleUpdate:withError

      Dinleyiciyi bir araç güncellemesinin başarısız olduğu konusunda bilgilendirir. GMTDDeliveryVehicleReporter, konum izleme etkin olduğu sürece en son verileri Fleet Engine arka ucuna göndermeye devam eder.

    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ştir

    Uygulamanız, konum izlemeyi etkinleştirmek için locationTrackingEnabled hizmetini GMTDDeliveryVehicleReporter sitesinde YES olarak ayarlayabilir. Ardından GMTDDeliveryVehicleReporter, konum güncellemelerini otomatik olarak gönderir. GMSNavigator navigasyon modundayken (setDestinations üzerinden bir hedef ayarlandığında) ve locationTrackingEnabled YES olarak ayarlandığında GMTDDeliveryVehicleReporter rota ve TVS güncellemelerini de otomatik olarak gönderir.

    Bu güncellemeler sırasında ayarlanan rota, sürücünün navigasyon oturumu sırasında gittiği rotayla aynıdır. Bu nedenle, filo izlemenin düzgün çalışması için -setDestinations:callback: üzerinden ayarlanan ara nokta, Fleet Engine arka ucunda ayarlanan hedefle eşleşmelidir.

    Aşağıdaki örnekte konum izleme etkinleştirilmiştir:

    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ştirilebilir. Desteklenen minimum güncelleme aralığı 5 saniyedir. Desteklenen maksimum güncelleme aralığı 60 saniyedir. Daha sık yapılan güncellemeler, isteklerin ve hataların daha yavaş olmasına neden olabilir.

    Konum güncellemelerini devre dışı bırak ve aracı çevrimdışı yap

    Uygulamanız bir aracın konum güncellemelerini devre dışı bırakabilir. Örneğin, sürücü mesaisi sona erdiğinde uygulamanız locationTrackingEnabled özelliğini NO olarak ayarlayabilir.

      _vehicleReporter.locationTrackingEnabled = NO