iOS için Tüketici SDK'sını Kullanmaya Başlama

İsteğe Bağlı Yolculuk ve Teslimat Çözümleri arka uç hizmetleriyle entegre temel bir tüketici uygulaması derleyip çalıştırmak için Tüketici SDK'sını kullanabilirsiniz. Etkin bir gezi görüntüleyebilen, gezi güncellemelerine yanıt verebilen ve gezi hatalarını işleyebilen bir Gezi ve Sipariş İlerleme Durumu uygulaması oluşturabilirsiniz.

Tüketici SDK'sı modüler bir mimariye sahip olduğundan uygulamanız için kullanmak istediğiniz API'nin parçalarını kullanabilir ve bunları kendi API'leriniz, Fleet Engine'in sağladığı arka uç hizmetleri ve Google Haritalar Platformu'nun ek API'leriyle entegre edebilirsiniz.

Minimum sistem gereksinimleri

  • Mobil cihaz iOS 14 veya sonraki bir sürümü çalıştırıyor olmalıdır.
  • Xcode 15 sürümü veya sonraki sürümler.
  • Proje yapılandırması

    Swift Paket Yöneticisi

    Tüketici SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Tüketici SDK'sı bağımlılıklarını kaldırdığınızdan emin olun.

    SDK'yı yeni veya mevcut bir projeye eklemek için şu adımları uygulayın:

    1. Xcode project veya workspace cihazınızı açın, ardından File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
    2. URL olarak https://github.com/googlemaps/ios-consumer-sdk girin, paketi çekmek için Enter tuşuna basın ve "Paket Ekle"yi tıklayın.
    3. 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.
    4. Paket Ürünlerini Seçin penceresinde, GoogleRidesharingConsumer ürününün belirlediğiniz main hedefine ekleneceğini doğrulayın. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
    5. Yüklemenizi doğrulamak için hedefinizin General bölmesine gidin. Çerçeveler, Kitaplıklar ve Yerleşik İçerik'te yüklü paketleri görürsünüz. Paketi ve sürümünü doğrulamak için "Project Navigator"daki "Paket Bağımlılıkları" bölümüne de bakabilirsiniz.

    Mevcut bir proje için package öğesini güncellemek üzere şu adımları uygulayın:

    1. 9.0.0'dan eski bir sürümden yükseltme yapıyorsanız şu bağımlılıkları kaldırmanız gerekir: yükseltmeden sonra GoogleMapsBase, GoogleMapsCore ve GoogleMapsM4B. 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 Frameworks, Libraries ve Embedded Content'i bulun. Eksi işaretini(-) kullanarak aşağıdaki çerçeveyi kaldırı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)
    2. Xcode'dan "Dosya > Paketler > En Son Paket Sürümlerine Güncelle"ye gidin.
    3. 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 Tüketici SDK'sı bağımlılıklarını kaldırmak için şu adımları uygulayın:

    1. 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
    2. Podfile, Podfile.resolved ve Xcode workspace öğelerini CocoaPods dışında bir şey için kullanmıyorsanız kaldırın.

    Manuel olarak yüklenen mevcut Tüketici SDK'sını kaldırmak için şu adımları uygulayın:

    1. Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleşik İçerik'i bulun. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:

      • GoogleRidesharingConsumer.xcframework
    2. Xcode projenizin en üst düzey dizininden GoogleRidesharingConsumer paketini kaldırın.

    CocoaPods

    Tüketici SDK'sını CocoaPods kullanarak yapılandırmak için aşağıdakilere 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 ayrıntı için CocoaPods Başlangıç Kılavuzuna bakın.

    1. Tüketici SDK'sı için bir Podfile oluşturun ve API'yi ve bağımlılıklarını yüklemek için bu dosyayı kullanın. İlk olarak proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Daha sonra Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Aşağıda, bağımlılıkları içeren bir örnek verilmiştir:

        source "https://github.com/CocoaPods/Specs.git"
      
        target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
          pod 'GoogleRidesharingConsumer'
        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 ve olabilecek bağımlılıklarını yükler.

      pod install
      
    4. Xcode'u başlatmak için Xcode'u kapatın ve projenizin .xcworkspace dosyasını çift tıklayarak açın (çift tıklayın). Projeyi daha sonra açmak için .xcworkspace dosyasını kullanın.

    Manuel yükleme

    XCFramework, Tüketici 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, Consumer SDK'yı 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ı indirin:

    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 uygulama şablonunu seçin.

    3. Henüz mevcut değilse proje grubunuzun altında bir Çerçeveler grubu oluşturun.

    4. Tüketici SDK'sını yüklemek için GoogleRidesharingConsumer.xcframework dosyasını Frameworks, Libraries and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) altından projenize sürükleyin. İstendiğinde, gerekirse Öğeleri kopyala'yı seçin.

    5. İndirilen GoogleRidesharingConsumer.bundle dosyasını, Xcode projenizin en üst düzey dizinine sürükleyin. İstendiğinde Copy items if needed'i seçin.

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

    7. 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
      • CoreData.framework
      • CoreGraphics.framework
      • CoreImage.framework
      • CoreLocation.framework
      • CoreTelephony.framework
      • CoreText.framework
      • GLKit.framework
      • ImageIO.framework
      • libc++.tbd
      • libz.tbd
      • Metal.framework
      • OpenGLES.framework
      • QuartzCore.framework
      • SystemConfiguration.framework
      • UIKit.framework
    8. Belirli bir hedef yerine projenizi seçin ve Build Settings (Ayarları Derleme) sekmesini açın. Diğer Bağlayıcı İşaretleri bölümüne hata ayıklama ve sürüm için -ObjC ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki Temel olan filtreyi Tümü olarak değiştirin.

    Apple Gizlilik Manifest Dosyası Ekle

    Apple, App Store'daki uygulamalar için uygulama gizliliğiyle ilgili ayrıntıları zorunlu kılar. Güncellemeler ve daha fazla bilgi için Apple App Store Gizlilik Ayrıntıları sayfasını ziyaret edin.

    1. iOS için Tüketici SDK'sı için Gizlilik Manifest paketini indirin: GoogleRidesharingConsumerPrivacy'yi indirin.
    2. GoogleRidesharingConsumerPrivacy.bundle dosyasına erişmek için dosyayı çıkarın.
    3. Bu yöntemlerden birini kullanarak Xcode Proje gezginine GoogleRidesharingConsumerPrivacy.bundle ekleyin. Uygulamanızın hedefi için "Hedeflere ekle" kutusunun işaretlendiğinden emin olun. Eklendikten sonra PrivacyInfo dosyası Proje gezgininde görünür ve değerleri inceleyebilirsiniz.
    4. Xcode Gizlilik Bilgisi Ekran Görüntüsü
    5. Uygulamanızın bir arşivini oluşturup arşivden bir gizlilik raporu oluşturarak gizlilik manifestinin eklendiğini doğrulayın.

    Uygulama entegrasyonu

    Kimlik doğrulama jetonu sağlayın

    Tüketici uygulamanız Fleet Engine'den seyahat güncellemeleri istediğinde bu istekler geçerli erişim jetonları içermelidir. Tüketici SDK'sı, bu istekleri yetkilendirmek ve kimliklerini doğrulamak için GMTCAuthorization protokolüne uygun şekilde 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'i Kullanmaya Başlama bölümüne bakın.

    Aşağıdaki örnekte bir erişim jetonu sağlayıcısı uygulanmaktadır:

    Swift

    /*
    
        *   SampleAccessTokenProvider.swift
     */
    import GoogleRidesharingConsumer
    
    private let providerURL = "INSERT_YOUR_TOKEN_PROVIDER_URL"
    
    class SampleAccessTokenProvider: NSObject, GMTCAuthorization {
      private struct AuthToken {
        // The cached trip token.
        let token: String
        // Keep track of when the token expires for caching.
        let expiration: TimeInterval
        // Keep track of the trip ID the cached token is for.
        let tripID: String
      }
    
      enum AccessTokenError: Error {
        case missingAuthorizationContext
        case missingData
      }
    
      private var authToken: AuthToken?
    
      func fetchToken(
        with authorizationContext: GMTCAuthorizationContext?,
        completion: @escaping GMTCAuthTokenFetchCompletionHandler
      ) {
        // Get the trip ID from the authorizationContext. This is set by the Consumer SDK.
        guard let authorizationContext = authorizationContext else {
          completion(nil, AccessTokenError.missingAuthorizationContext)
          return
        }
        let tripID = authorizationContext.tripID
    
        // If appropriate, use the cached token.
        if let authToken = authToken,
          authToken.expiration > Date.now.timeIntervalSince1970 && authToken.tripID == tripID
        {
          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 tripTokenKey = "TRIP_TOKEN_KEY"
          let tokenExpirationKey = "TOKEN_EXPIRATION"
          guard let data = data,
            let fetchData = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
            let token = fetchData[tripTokenKey] as? String,
            let expiration = fetchData[tokenExpirationKey] as? Double
          else {
            completion(nil, AccessTokenError.missingData)
            return
          }
    
          strongSelf.authToken = AuthToken(token: token, expiration: expiration, tripID: tripID)
          completion(token, nil)
        }
        task.resume()
      }
    }
    

    Objective-C

    /*
    
        *   SampleAccessTokenProvider.h
     */
    #import <Foundation/Foundation.h>
    #import <GoogleRidesharingConsumer/GoogleRidesharingConsumer.h>
    
    NS_ASSUME_NONNULL_BEGIN
    
    @interface SampleAccessTokenProvider : NSObject <GMTCAuthorization>
    
    @end
    
    NS_ASSUME_NONNULL_END
    
    /*
    
        *   SampleAccessTokenProvider.m
     */
    #import "SampleAccessTokenProvider.h"
    #import "GoogleRidesharingConsumer/GoogleRidesharingConsumer.h"
    
    static NSString *const PROVIDER_URL = @"INSERT_YOUR_TOKEN_PROVIDER_URL";
    
    // SampleAccessTokenProvider.m
    @implementation SampleAccessTokenProvider {
      // The cached token with claims to the current trip.
      NSString *_cachedTripToken;
      // Keep track of the Trip ID the cached token is for.
      NSString *_lastKnownTripID;
      // Keep track of when tokens expire for caching.
      NSTimeInterval _tokenExpiration;
    }
    
    -   (void)fetchTokenWithContext:(nullable GMTCAuthorizationContext *)authorizationContext
                       completion:(nonnull GMTCAuthTokenFetchCompletionHandler)completion {
      // Get the trip ID from the authorizationContext. This is set by the Consumer SDK.
      NSString *tripID = authorizationContext.tripID;
    
      // Clear cached trip token if trip ID has changed.
      if (![_lastKnownTripID isEqual:tripID]) {
        _tokenExpiration = 0.0;
        _cachedTripToken = nil;
      }
      _lastKnownTripID = tripID;
    
      // Clear cached tripToken if it has expired.
      if ([[NSDate date] timeIntervalSince1970] > _tokenExpiration) {
        _cachedTripToken = nil;
      }
    
      // If appropriate, use the cached token.
      if (_cachedTripToken) {
        completion(_cachedTripToken, 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 *tripTokenKey = @"TRIP_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->_cachedTripToken = JSONResponse[tripTokenKey];
              completion(JSONResponse[tripTokenKey], 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
    

    Uygulama başlatma

    Swift

    /*
    
        *   AppDelegate.swift
     */
    import GoogleRidesharingConsumer
    import GoogleMaps
    
    @UIApplicationMain
    class AppDelegate: UIResponder, UIApplicationDelegate {
    
      func application(_ application: UIApplication,
          didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Register your API key for GMSServices.
        GMSServices.provideAPIKey(yourMapsAPIKey)
    
        // Set the instance of the SampleAccessTokenProvider.
        GMTCServices.setAccessTokenProvider(SampleAccessTokenProvider(), providerID: yourProviderID)
    
        // Other initialization code ...
        return true
      }
    }
    

    Objective-C

    /*
    
        *   AppDelegate.m
     */
    #import <GoogleMaps/GoogleMaps.h>
    #import <GoogleRidesharingConsumer/GoogleRidesharingConsumer.h>
    
    @implementation AppDelegate
    
    -   (BOOL)application:(UIApplication *)application
        didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
      //Register your API key for GMSServices.
      [GMSServices provideAPIKey:yourMapsAPIKey];
    
      //Set the instance of the AccessTokenFactory.
      [GMTCServices setAccessTokenProvider:[[SampleAccessTokenProvider alloc] init]
                                providerID:yourProviderID];
    
      // Other initialization code ...
      return YES;
    }
    
    @end
    

    Harita görünümü entegrasyonu

    Harita görünümünü başlatma

    Aşağıdaki örnekte GMTCMapView öğesinin nasıl başlatılacağı gösterilmektedir.

    Swift

    /*
    
        *   MapViewController.swift
     */
    class ViewController: UIViewController, GMTCMapViewDelegate {
      private var rideSharingMap: GMTCMapView?
    
      override func viewDidLoad() {
        super.viewDidLoad()
    
        self.rideSharingMap = GMTCMapView(frame: UIScreen.main.bounds)
        self.rideSharingMap.delegate = self
        self.rideSharingMap?.settings.myLocationButton = true
        self.view.addSubview(self.rideSharingMap!)
        ...
      }
    

    Objective-C

    /*
    
        *   MapViewController.h
     */
    @interface MapViewController : UIViewController<GMTCMapViewDelegate>
    ...
    @end
    
    /*
    
        *   MapViewController.m
     */
    @implementation MapViewController
    
    -   (void)viewDidLoad {
      [super viewDidLoad];
      ...
      self.mapView = [[GMTCMapView alloc] initWithFrame:CGRectZero];
      self.mapView.settings.myLocationButton = YES;
      self.mapView.delegate = self;
      ...
    }
    
    ...
    
    @end
    

    Harita görünümü etkinliklerini işleme

    Aşağıdaki örnekte, müşteri durumu etkinliklerini işlemek için bir yetkinin nasıl uygulanacağı gösterilmektedir.

    Swift

    func mapViewDidInitialize(_ mapview: GMTCMapView) {
      // Handle the update to the state of the map view to browsing.
    }
    
    func mapView(_ mapView: GMSMapView, didTapConsumerMarker mapMarker: GMSMarker, markerType: GMTCMapViewMarkerType) -> Bool {
      // Handle the mapView marker was tapped.
    }
    

    Objective-C

    /*
    
        *   MapViewController.m
     */
    #pragma mark - GMTCMapViewDelegate implementation
    
    // Handle state update of map view.
    
    -   (void)mapViewDidInitializeCustomerState:(GMTCMapView *)mapview {
      // Handle the update to the state of the map view to browsing.
    }
    
    -   (void)mapView:(GMSMapView *)mapView
        didTapConsumerMarker:(nonnull GMSMarker *)mapMarker
                  markerType:(GMTCMapViewMarkerType)markerType {
      // Handle the mapView marker was tapped.
    }
    

    Yolculuk paylaşımı

    Görünüm yüklendiğinde yeni bir gezi başlat

    Aşağıdaki örnekte, görünüm yüklendikten hemen sonra yolculuk paylaşımının nasıl başlatılacağı gösterilmektedir. Teslim etme ve teslim alma konumları gibi tüm kullanıcı girişlerini bir ViewController öğesinden toplayabilir ve daha sonra, yolculuğu doğrudan paylaşmaya başlamak için yeni bir ViewController oluşturabilirsiniz.

    Swift

    /*
    
        *   MapViewController.swift
     */
    override func viewDidLoad() {
      super.viewDidLoad()
      ...
      self.mapView = GMTCMapView(frame: UIScreen.main.bounds)
      self.mapView.delegate = self
      self.view.addSubview(self.mapView)
    }
    
    func mapViewDidInitializeCustomerState(_: GMTCMapView) {
      self.mapView.pickupLocation = self.selectedPickupLocation
      self.mapView.dropoffLocation = self.selectedDropoffLocation
    
      self.startConsumerMatchWithLocations(
        pickupLocation: self.mapView.pickupLocation!,
        dropoffLocation: self.mapView.dropoffLocation!
      ) { [weak self] (tripName, error) in
        guard let strongSelf = self else { return }
        if error != nil {
          // print error message.
          return
        }
        let tripService = GMTCServices.shared().tripService
        // Create a tripModel instance for listening the update of the trip
        // specified by this trip name.
        let tripModel = tripService.tripModel(forTripName: tripName)
        // Create a journeySharingSession instance based on the tripModel
        let journeySharingSession = GMTCJourneySharingSession(tripModel: tripModel)
        // Add the journeySharingSession instance on the mapView for UI updating.
        strongSelf.mapView.show(journeySharingSession)
        // Register for the trip update events.
        tripModel.register(strongSelf)
    
        strongSelf.currentTripModel = tripModel
        strongSelf.currentJourneySharingSession = journeySharingSession
        strongSelf.hideLoadingView()
      }
    
      self.showLoadingView()
    }
    

    Objective-C

    /*
    
        *   MapViewController.m
     */
    -   (void)viewDidLoad {
      [super viewDidLoad];
      ...
      self.mapView = [[GMTCMapView alloc] initWithFrame:CGRectZero];
      self.mapView.delegate = self;
      [self.view addSubview:self.mapView];
    }
    
    // Handle the callback when the GMTCMapView did initialized.
    
    -   (void)mapViewDidInitializeCustomerState:(GMTCMapView *)mapview {
      self.mapView.pickupLocation = self.selectedPickupLocation;
      self.mapView.dropoffLocation = self.selectedDropoffLocation;
    
      __weak __typeof(self) weakSelf = self;
      [self startTripBookingWithPickupLocation:self.selectedPickupLocation
                               dropoffLocation:self.selectedDropoffLocation
                                    completion:^(NSString *tripName, NSError *error) {
                                      __typeof(self) strongSelf = weakSelf;
                                      GMTCTripService *tripService = [GMTCServices sharedServices].tripService;
                                      // Create a tripModel instance for listening to updates to the trip specified by this trip name.
                                      GMTCTripModel *tripModel = [tripService tripModelForTripName:tripName];
                                      // Create a journeySharingSession instance based on the tripModel.
                                      GMTCJourneySharingSession *journeySharingSession =
                                        [[GMTCJourneySharingSession alloc] initWithTripModel:tripModel];
                                      // Add the journeySharingSession instance on the mapView for updating the UI.
                                      [strongSelf.mapView showMapViewSession:journeySharingSession];
                                      // Register for trip update events.
                                      [tripModel registerSubscriber:self];
    
                                      strongSelf.currentTripModel = tripModel;
                                      strongSelf.currentJourneySharingSession = journeySharingSession;
                                      [strongSelf hideLoadingView];
                                    }];
        [self showLoadingView];
    }
    

    Etkin yolculuğu iptal et

    Aşağıdaki örnekte, mevcut etkin gezinin nasıl sıfırlanacağı gösterilmektedir.

    Swift

    /*
    
        *   MapViewController.swift
     */
    func cancelCurrentActiveTrip() {
      // Stop the tripModel
      self.currentTripModel.unregisterSubscriber(self)
    
      // Remove the journey sharing session from the mapView's UI stack.
      self.mapView.hide(journeySharingSession)
    }
    

    Objective-C

    /*
    
        *   MapViewController.m
     */
    -   (void)cancelCurrentActiveTrip {
      // Stop the tripModel
      [self.currentTripModel unregisterSubscriber:self];
    
      // Remove the journey sharing session from the mapView's UI stack.
      [self.mapView hideMapViewSession:journeySharingSession];
    }
    

    Gezi güncellemelerini dinleyin

    Aşağıdaki örnekte tripModel geri çağırma işlevinin nasıl kaydedileceği gösterilmektedir.

    Swift

    /*
    
        *   MapViewController.swift
     */
    override func viewDidLoad() {
      super.viewDidLoad()
      // Register for trip update events.
      self.currentTripModel.register(self)
    }
    

    Objective-C

    /*
    
        *   MapViewController.m
     */
    -   (void)viewDidLoad {
      [super viewDidLoad];
      // Register for trip update events.
      [self.currentTripModel registerSubscriber:self];
      ...
    }
    

    Aşağıdaki örnekte, tripModel geri çağırma kaydının nasıl iptal edileceği gösterilmektedir.

    Swift

    /*
    
        *   MapViewController.swift
     */
    deinit {
      self.currentTripModel.unregisterSubscriber(self)
    }
    

    Objective-C

    /*
    
        *   MapViewController.m
     */
    -   (void)dealloc {
      [self.currentTripModel unregisterSubscriber:self];
      ...
    }
    

    Aşağıdaki örnekte, gezi durumu güncellendiğinde geri çağırmaların işlenmesi için GMTCTripModelSubscriber protokolünün nasıl uygulanacağı gösterilmektedir.

    Swift

    /*
    
        *   MapViewController.swift
     */
    func tripModel(_: GMTCTripModel, didUpdate trip: GMTSTrip?, updatedPropertyFields: GMTSTripPropertyFields) {
      // Update the UI with the new `trip` data.
      self.updateUI(with: trip)
    }
    
    func tripModel(_: GMTCTripModel, didUpdate tripStatus: GMTSTripStatus) {
      // Handle trip status did change.
    }
    
    func tripModel(_: GMTCTripModel, didUpdateActiveRouteRemainingDistance activeRouteRemainingDistance: Int32) {
      // Handle remaining distance of active route did update.
    }
    
    func tripModel(_: GMTCTripModel, didUpdateActiveRoute activeRoute: [GMTSLatLng]?) {
      // Handle trip active route did update.
    }
    
    func tripModel(_: GMTCTripModel, didUpdate vehicleLocation: GMTSVehicleLocation?) {
      // Handle vehicle location did update.
    }
    
    func tripModel(_: GMTCTripModel, didUpdatePickupLocation pickupLocation: GMTSTerminalLocation?) {
      // Handle pickup location did update.
    }
    
    func tripModel(_: GMTCTripModel, didUpdateDropoffLocation dropoffLocation: GMTSTerminalLocation?) {
      // Handle drop off location did update.
    }
    
    func tripModel(_: GMTCTripModel, didUpdatePickupETA pickupETA: TimeInterval) {
      // Handle the pickup ETA did update.
    }
    
    func tripModel(_: GMTCTripModel, didUpdateDropoffETA dropoffETA: TimeInterval) {
      // Handle the drop off ETA did update.
    }
    
    func tripModel(_: GMTCTripModel, didUpdateRemaining remainingWaypoints: [GMTSTripWaypoint]?) {
      // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
    }
    
    func tripModel(_: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
      // Handle the error.
    }
    
    func tripModel(_: GMTCTripModel, didUpdateIntermediateDestinations intermediateDestinations: [GMTSTerminalLocation]?) {
      // Handle the intermediate destinations being updated.
    }
    
    func tripModel(_: GMTCTripModel, didUpdateActiveRouteTraffic activeRouteTraffic: GMTSTrafficData?) {
      // Handle trip active route traffic being updated.
    }
    

    Objective-C

    /*
    
        *   MapViewController.m
     */
    #pragma mark - GMTCTripModelSubscriber implementation
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
                didUpdateTrip:(nullable GMTSTrip *)trip
        updatedPropertyFields:(enum GMTSTripPropertyFields)updatedPropertyFields {
      // Update the UI with the new `trip` data.
      [self updateUIWithTrip:trip];
      ...
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel didUpdateTripStatus:(enum GMTSTripStatus)tripStatus {
      // Handle trip status did change.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
        didUpdateActiveRouteRemainingDistance:(int32_t)activeRouteRemainingDistance {
       // Handle remaining distance of active route did update.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
        didUpdateActiveRoute:(nullable NSArray<GMTSLatLng *> *)activeRoute {
      // Handle trip active route did update.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
        didUpdateVehicleLocation:(nullable GMTSVehicleLocation *)vehicleLocation {
      // Handle vehicle location did update.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
        didUpdatePickupLocation:(nullable GMTSTerminalLocation *)pickupLocation {
      // Handle pickup location did update.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
        didUpdateDropoffLocation:(nullable GMTSTerminalLocation *)dropoffLocation {
      // Handle drop off location did update.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel didUpdatePickupETA:(NSTimeInterval)pickupETA {
      // Handle the pickup ETA did update.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
        didUpdateRemainingWaypoints:(nullable NSArray<GMTSTripWaypoint *> *)remainingWaypoints {
      // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel didUpdateDropoffETA:(NSTimeInterval)dropoffETA {
      // Handle the drop off ETA did update.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(nullable NSError *)error {
      // Handle the error.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
        didUpdateIntermediateDestinations:
            (nullable NSArray<GMTSTerminalLocation *> *)intermediateDestinations {
      // Handle the intermediate destinations being updated.
    }
    
    -   (void)tripModel:(GMTCTripModel *)tripModel
        didUpdateActiveRouteTraffic:(nullable GMTSTrafficData *)activeRouteTraffic {
      // Handle trip active route traffic being updated.
    }
    

    Hata işleme

    tripModel'e abone olduysanız ve bir hata oluşursa tripModel(_:didFailUpdateTripWithError:) yetkilendirme yöntemini uygulayarak tripModel'in geri çağırmasını alabilirsiniz. Fleet Engine, Google Cloud Hata standardına uygun hata mesajını oluşturdu. Ayrıntılı hata mesajı tanımı ve tüm hata kodları için Google Cloud Hataları belgelerine bakın.

    Özellikle gezi izleme için geçerli bir kimlik doğrulama jetonu sağlanması gerekir. Jetonun süresinin dolması gibi geçerli bir kimlik doğrulama bilgisi yoksa 401 UNAUTHENTICATED yükseltilir.Arayanın belirli bir API'yi çağırma izni yoksa (örneğin, tüketici rolüne sahip olan kullanıcı updateTrip'i çağırmaya çalışıyorsa) veya isteğin JWT jetonunda geçerli bir tool_id/trip_id yoksa 403 PERMISSION_DENIED yükseltilir.

    Daha fazla bilgi için Tüketici SDK'sı Hatalarını Ele Alma bölümüne bakın.

    Kullanıcı Arayüzü Özelleştirmesi

    Özel çoklu çizgi kullanıcı arayüzü seçeneklerini alma ve ayarlama

    Aşağıdaki örnekte, çoklu çizgiler için özel kullanıcı arayüzü seçeneklerinin nasıl ayarlanacağı gösterilmektedir.

    Swift

    /** MapViewController.swift */
    
    func updatePolylineUIOptions() {
      // The polyline type that you would like to set custom UI options for.
      let customizablePolylineType = GMTCPolylineType.activeRoute
    
      let polylineStyleOptions = GMTCMutablePolylineStyleOptions()
      polylineStyleOptions.strokeWidth = 8.0
      polylineStyleOptions.strokeColor = .blue
      polylineStyleOptions.isVisible = true
      polylineStyleOptions.zIndex = 1000
      polylineStyleOptions.isGeodesic = true
      let coordinator = self.mapView.consumerMapStyleCoordinator
      coordinator.setPolylineStyleOptions(polylineStyleOptions, polylineType:customizablePolylineType)
    }
    

    Objective-C

    /** MapViewController.m */
    
    -   (void)updatePolylineUIOptions {
      // The polyline type that you would like to set custom UI options for.
      GMTCPolylineType customizablePolylineType = GMTCPolylineTypeActiveRoute;
    
      GMTCMutablePolylineStyleOptions *polylineStyleOptions =
          [[GMTCMutablePolylineStyleOptions alloc] init];
      polylineStyleOptions.strokeWidth = 8.0;
      polylineStyleOptions.strokeColor = [UIColor blueColor];
      polylineStyleOptions.isVisible = YES;
      polylineStyleOptions.zIndex = 1000;
      polylineStyleOptions.isGeodesic = YES;
      [[_mapView consumerMapStyleCoordinator] setPolylineStyleOptions:polylineStyleOptions
                                                    polylineType:customizablePolylineType];
    }
    

    Özel işaretçi kullanıcı arayüzü seçeneklerini alma ve ayarlama

    Aşağıdaki örnekte, işaretçiler için özel kullanıcı arayüzü seçeneklerinin nasıl ayarlanacağı gösterilmektedir.

    Swift

    /** MapViewController.swift */
    
    func updateMarkerUIOptions() {
      let customizableMarkerType = GMTCCustomizableMarkerType.tripVehicle
      let markerStyleOptions = GMTCMutableMarkerStyleOptions()
      markerStyleOptions.groundAnchor = groundAnchor
      markerStyleOptions.isVisible = true
      markerStyleOptions.icon = icon
      markerStyleOptions.zIndex = 100
      markerStyleOptions.isFlat = false
      let coordinator = self.mapView.consumerMapStyleCoordinator
      coordinator.setMarkerStyleOptions(markerStyleOptions, markerType: customizableMarkerType)
    }
    

    Objective-C

    /** MapViewController.m */
    
    -   (void)updateMarkerUIOptions {
      // The marker type that you would like to set custom UI options for.
      GMTCCustomizableMarkerType customizableMarkerType = GMTCCustomizableMarkerTypeTripVehicle;
    
      GMTCMutableMarkerStyleOptions *markerStyleOptions =
          [[GMTCMutableMarkerStyleOptions alloc] init];
      markerStyleOptions.groundAnchor = groundAnchor;
      markerStyleOptions.isVisible = YES;
      markerStyleOptions.icon = icon;
      markerStyleOptions.zIndex = 100;
      markerStyleOptions.isFlat = NO;
    
      [[_mapView consumerMapStyleCoordinator] setMarkerStyleOptions:markerStyleOptions markerType:customizableMarkerType];
    }
    

    Kamera yakınlaştırmasını ayarlama

    iOS için Haritalar SDK'sındaki Konumum düğmesi, kamerayı cihaz konumuna ortalar.

    Etkin bir Yolculuk Paylaşımı oturumu varsa kamerayı yalnızca cihaz konumu yerine yolculuğa odaklanacak şekilde ortalayabilirsiniz.

    Tüketici SDK'sı, varsayılan olarak etkinleştirilen bir otomatik kamera özelliği sunar. Kamera, yolculuğun paylaşıldığı rotaya ve bir sonraki gezi ara noktasına odaklanmak için görüntüyü yakınlaştırır.

    AutoCamera

    Kamera davranışı üzerinde daha fazla kontrole ihtiyacınız varsa isAllowCameraAutoUpdate özelliğini kullanarak otomatik kamera özelliğini devre dışı bırakabilir veya etkinleştirebilirsiniz.

    Daha fazla kamera özelleştirmesi için iOS için Kamerayı hareket ettirme özelliği için Haritalar SDK'sı sayfasına göz atın.