iOS용 드라이버 SDK 시작하기

Driver SDK는 드라이버 앱에 통합하는 라이브러리입니다. 그것은 차량 위치, 경로, 날짜 및 시간 정보를 포함하여 남은 거리 및 예상 도착 시간을 계산할 수 있습니다. 또한 Navigation SDK와 통합되어 운전자에게 세부 경로 안내 내비게이션 안내를 제공합니다.

최소 시스템 요구사항

기본 요건

이 가이드에서는 앱에서 이미 Navigation SDK와 Fleet 엔진 사용 가능한 상태가 됩니다 하지만 예시 코드는 Navigation SDK를 설정하는 방법

iOS용 Maps SDK도 사용 설정해야 합니다. Google Cloud 프로젝트에서 API를 가져옵니다. 키.

로컬 개발

로컬 개발의 경우 Cloud SDK

gcloud auth login

로그인하는 데 사용하는 이메일이 Workspace 그룹의 구성원이어야 합니다.

자동화 (빌드 시스템 또는 지속적 통합)

다음에 따라 자동화 호스트를 설정합니다. 권장사항:

• 프로세스가 Google Cloud 환경 내에서 실행되는 경우 자동 사용자 인증 정보 감지

• 그렇지 않으면 서비스 계정 키 파일을 호스트의 파일 시스템에 액세스하고 GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 적절하게 변경해야 합니다

사용자 인증 정보와 연결된 서비스 계정 이메일은 다음의 구성원이어야 합니다. Workspace 그룹에 액세스할 수 있습니다

프로젝트 구성

   sudo gem install cocoapods

Apple 개인 정보 보호 매니페스트 파일 검사

Apple은 App Store의 앱에 대한 앱 개인 정보 보호 세부정보를 요구합니다. 업데이트 및 자세한 내용은 Apple App Store 개인 정보 보호 세부정보 페이지를 참고하세요.

Apple 개인 정보 보호 매니페스트 파일은 SDK의 리소스 번들에 포함되어 있습니다. 개인 정보 보호 매니페스트 파일이 포함되었는지 확인하고 콘텐츠를 검사하려면 앱의 보관 파일을 만들고 보관 파일에서 개인 정보 보호 보고서를 생성하세요.

승인 및 인증 구현

드라이버 앱에서 업데이트를 생성하고 Fleet Engine 백엔드로 전송하면 요청에 유효한 액세스 토큰이 포함되어야 합니다. 승인하고 이러한 요청을 인증하면 드라이버 SDK가 GMTDAuthorization를 준수하는 객체 사용할 수 있습니다 객체는 필요한 액세스 토큰을 제공하는 역할을 합니다.

앱 개발자는 토큰이 생성되는 방식을 선택합니다. 구현 다음 작업을 할 수 있는 기능을 제공해야 합니다.

• HTTPS 서버에서 액세스 토큰(JSON 형식)을 가져옵니다.
• 토큰을 파싱하고 캐시합니다.
• 토큰이 만료되면 새로고침합니다.

Fleet Engine 서버에서 예상하는 토큰에 대한 자세한 내용은 다음을 참고하세요. 승인을 위한 JSON 웹 토큰 (JWT) 만들기

제공업체 ID는 Google Cloud 프로젝트 ID와 동일합니다. Fleet Engine Deliveries 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 프로젝트 ID입니다. GMTDDeliveryVehicleReporter에 액세스할 수도 있습니다. 드라이버 API에서 직접 가져올 수 있습니다.

다음 예시에서는 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];
}

원하는 경우 VehicleReporter 이벤트를 수신 대기합니다.

GMTDDeliveryVehicleReporter는 다음 시점에 차량을 주기적으로 업데이트합니다. locationTrackingEnabled이(가) '예'입니다. 이러한 주기적인 업데이트에 대응하기 위해 객체는 GMTDDeliveryVehicleReporter 이벤트를 수신할 수 있도록 GMTDVehicleReporterListener 프로토콜

다음과 같은 이벤트를 처리할 수 있습니다.

• vehicleReporter:didSucceedVehicleUpdate

  드라이버 앱에 백엔드 서비스가 차량 위치 및 상태 업데이트.

• vehicleReporter:didFailVehicleUpdate:withError

  리스너에 차량 업데이트 실패를 알립니다. 위치가 있는 경우 추적이 사용 설정되면 GMTDDeliveryVehicleReporter에서 계속해서 최신 데이터를 Fleet Engine 백엔드에 추가할 수 있습니다

다음 예에서는 이러한 이벤트를 처리합니다.

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(으)로 설정합니다. 경로 및 도착예정시간 업데이트도 자동으로 전송합니다.

이러한 업데이트 중에 설정된 경로는 운전자가 사용하는 경로와 동일합니다. 내비게이션 세션 중 로 이동합니다. 따라서 Fleet 추적이 작동하려면 -setDestinations:callback:를 통해 설정된 경유지가 Fleet Engine 백엔드에 설정된 대상입니다.

다음 예에서는 위치 추적을 사용 설정합니다.

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