iOS के लिए Driver SDK टूल का इस्तेमाल शुरू करना

ड्राइवर SDK टूल एक लाइब्रेरी है, जिसे ड्राइवर ऐप्लिकेशन के साथ इंटिग्रेट किया जा सकता है. हां यह फ़्लीट इंजन को वाहन की जगह, रास्ता, और दूरी और ETA. यह नेविगेशन SDK टूल के साथ भी काम करता है, यह ड्राइवर के लिए मोड़-दर-मोड़ रास्ते की जानकारी देता है.

सिस्टम में कम से कम यह कॉन्फ़िगरेशन होना चाहिए

ज़रूरी शर्तें

यह गाइड मान लेती है कि आपका ऐप्लिकेशन नेविगेशन SDK टूल और फ़्लीट इंजन बैकएंड सेट अप हो गया है और उपलब्ध है. हालांकि, उदाहरण कोड नेविगेशन SDK टूल सेट अप करने का तरीका जानें.

आपको iOS के लिए Maps SDK टूल भी चालू करना होगा को ऐक्सेस करें और एपीआई पाएं कुंजी.

लोकल डेवलपमेंट

लोकल डेवलपमेंट के लिए, Cloud SDK टूल.

gcloud auth login

साइन इन करने के लिए इस्तेमाल किया जाने वाला ईमेल पता, Workspace ग्रुप का सदस्य होना चाहिए.

ऑटोमेशन (सिस्टम बनाना या लगातार इंटिग्रेशन करना)

ऑटोमेशन होस्ट को इसके हिसाब से सेट अप करना सबसे सही तरीके:

• अगर आपकी प्रोसेस Google Cloud के एनवायरमेंट में चलती है, तो इसका इस्तेमाल करें ऑटोमैटिक क्रेडेंशियल की पहचान करें.

• अगर ऐसा नहीं है, तो सेवा खाते की कुंजी वाली फ़ाइल को होस्ट का फ़ाइल-सिस्टम है और GOOGLE_APPLICATION_CREDENTIALS एनवायरमेंट वैरिएबल में सही तरीके से बदलाव किया हो.

क्रेडेंशियल से जुड़े सेवा खाते का ईमेल पता, शामिल हैं.

प्रोजेक्ट कॉन्फ़िगरेशन

   sudo gem install cocoapods

Apple की निजता मेनिफ़ेस्ट फ़ाइल की जांच करें

Apple को App Store पर मौजूद ऐप्लिकेशन के लिए, ऐप्लिकेशन की निजता से जुड़ी जानकारी की ज़रूरत होती है. अपडेट और ज़्यादा जानकारी के लिए, Apple App Store के निजता से जुड़ी जानकारी वाले पेज पर जाएं.

Apple Privacy मेनिफ़ेस्ट फ़ाइल, SDK टूल के लिए संसाधनों के बंडल में शामिल होती है. यह पुष्टि करने के लिए कि निजता मेनिफ़ेस्ट फ़ाइल शामिल की गई है और इसके कॉन्टेंट की जांच करने के लिए, अपने ऐप्लिकेशन का संग्रह बनाएं और संग्रह से निजता रिपोर्ट जनरेट करें.

अनुमति देने और पुष्टि करने की प्रोसेस लागू करें

जब आपका ड्राइवर ऐप्लिकेशन, Fleet Engine बैकएंड को अपडेट जनरेट करके भेजता है, तो अनुरोध में मान्य ऐक्सेस टोकन शामिल होने चाहिए. अधिकृत करने और इन अनुरोधों की पुष्टि करने के बाद, ड्राइवर SDK टूल आपके ऑब्जेक्ट GMTDAuthorization के मुताबिक है प्रोटोकॉल का इस्तेमाल करना चाहिए. ऑब्जेक्ट, ज़रूरी ऐक्सेस टोकन देने के लिए ज़िम्मेदार है.

ऐप्लिकेशन डेवलपर के तौर पर, आपको यह चुनना होता है कि टोकन कैसे जनरेट किए जाएं. लागू किया गया के तहत ये काम किए जा सकते हैं:

• किसी एचटीटीपीएस सर्वर से ऐक्सेस टोकन फ़ेच करें. इस टोकन को JSON फ़ॉर्मैट में फ़ेच किया जा सकता है.
• टोकन को पार्स और कैश मेमोरी में सेव करें.
• टोकन की समयसीमा खत्म होने पर उसे रीफ़्रेश करें.

फ़्लीट इंजन सर्वर से मिलने वाले टोकन की जानकारी के लिए, देखें अनुमति पाने के लिए JSON वेब टोकन (JWT) बनाना.

प्रोवाइडर आईडी और Google Cloud प्रोजेक्ट आईडी एक ही होते हैं. Fleet Engine Deliveryies API की उपयोगकर्ता गाइड देखें हमारा वीडियो देखें.

यहां दिए गए उदाहरण में, ऐक्सेस टोकन देने वाली कंपनी के बारे में बताया गया है:

#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 इंस्टेंस बनाएं

GMTDDeliveryVehicleReporter इंस्टेंस पाने के लिए, आपको पहले providerID, vehicleID, का इस्तेमाल करके GMTDDeliveryDriverAPI इंस्टेंस driverContext, और accessTokenProvider. providerID और Google Cloud प्रोजेक्ट आईडी. साथ ही, GMTDDeliveryVehicleReporter को ऐक्सेस किया जा सकता है सीधे ड्राइवर एपीआई से इंस्टेंस.

नीचे दिए गए उदाहरण में, GMTDDeliveryDriverAPI इंस्टेंस बनाया गया है:

#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];
}

वाहन के बारे में जानकारी देने वाली सुविधा के इवेंट भी सुनें

GMTDDeliveryVehicleReporter समय-समय पर वाहन को तब अपडेट करता है, जब locationTrackingEnabled का जवाब हां है. इन समय-समय पर होने वाले अपडेट का जवाब देने के लिए, किसी भी समय ऑब्जेक्ट, GMTDDeliveryVehicleReporter इवेंट की सदस्यता ले सकता है. इसके लिए, वह GMTDVehicleReporterListener प्रोटोकॉल का.

आपके पास इन इवेंट को मैनेज करने का विकल्प होता है:

• vehicleReporter:didSucceedVehicleUpdate

  इससे ड्राइवर ऐप्लिकेशन को यह सूचना मिलती है कि बैकएंड सेवाओं को गाड़ी की जगह और स्थिति की जानकारी अपडेट करें.

• vehicleReporter:didFailVehicleUpdate:withError

  लिसनर को सूचना दी जाती है कि गाड़ी को अपडेट नहीं किया जा सका. जगह के तौर पर ट्रैकिंग चालू है, तो GMTDDeliveryVehicleReporter फ़्लीट इंजन बैकएंड का नया डेटा.

नीचे दिए गए उदाहरण में, इन इवेंट को हैंडल किया गया है:

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

जगह की जानकारी ट्रैक करने की सुविधा चालू करें

जगह की जानकारी ट्रैक करने की सुविधा चालू करने के लिए, आपका ऐप्लिकेशन locationTrackingEnabled को YES पर सेट कर सकता है GMTDDeliveryVehicleReporter को. इसके बाद, GMTDDeliveryVehicleReporter चुकाएं अपने आप स्थान अपडेट भेजता है. जब GMSNavigator नेविगेशन में हो मोड (जब डेस्टिनेशन setDestinations के ज़रिए सेट किया गया हो) और locationTrackingEnabled को YES और GMTDDeliveryVehicleReporter पर सेट किया गया है रास्ते की जानकारी और ETA के अपडेट भी अपने-आप भेजता है.

इन अपडेट के दौरान सेट किया गया रास्ता वही है जो ड्राइवर के पास होता है पर नेविगेट करना चाहिए. इससे, जहाज़ों को ट्रैक करने की सुविधा काम करती है, -setDestinations:callback: से होकर गुज़रने वाला वेपॉइंट डेस्टिनेशन को फ़्लीट इंजन बैकएंड में सेट किया गया है.

यहां दिए गए उदाहरण में, जगह की जानकारी ट्रैक करने की सुविधा चालू की गई है:

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

डिफ़ॉल्ट रूप से, रिपोर्टिंग अंतराल 10 सेकंड का होता है, लेकिन रिपोर्टिंग अंतराल locationUpdateInterval के साथ बदला जाएगा. अपडेट करने के लिए, तय इंटरवल का कम से कम इस्तेमाल 5 सेकंड का है. अपडेट के लिए ज़्यादा से ज़्यादा 60 सेकंड का इंटरवल इस्तेमाल किया जा सकता है. ज़्यादा बार अपडेट की वजह से, अनुरोध धीमे हो सकते हैं और गड़बड़ियां हो सकती हैं.

जगह की जानकारी के अपडेट बंद करें और वाहन को ऑफ़लाइन ले जाएं

आपका ऐप्लिकेशन, वाहन की जगह की जानकारी अपडेट करने की सुविधा बंद कर सकता है. उदाहरण के लिए, जब किसी ड्राइवर की शिफ़्ट खत्म हो रही है, आपका ऐप्लिकेशन locationTrackingEnabled को NO पर सेट कर सकता है.

  _vehicleReporter.locationTrackingEnabled = NO