В этом разделе показано, как подготовить автомобиль к поездкам. Вам необходимо выполнить каждый из следующих шагов, прежде чем ваш сервер сможет сопоставить транспортное средство с поездкой.
Настройка прослушивателей
После инициализации Driver SDK и создания экземпляра GMTDRidesharingDriverAPI
вы можете настроить прослушиватели событий для отслеживания успеха или сбоя обновлений транспортных средств, отправляемых в Fleet Engine и на ваш сервер. Эти прослушиватели могут инициировать действия в вашем приложении драйвера, например уведомлять водителя о сбое связи с вашим сервером.
Прослушивание событий обновления автомобиля
Когда водитель включает обновление местоположения в приложении для водителя, Driver SDK отправляет регулярные обновления транспортных средств в Fleet Engine и серверную часть клиента через класс GMTDVehicleReporter
. Вы можете заставить приложение реагировать на события обновления, настроив протокол GMTDVehicleReporterListener
.
С помощью GMTDVehicleReporterListener
вы можете обрабатывать следующие события:
vehicleReporter:didSucceedVehicleUpdate
Сообщает приложению для водителей, что серверные службы успешно получили обновление местоположения и состояния автомобиля.
vehicleReporter:didFailVehicleUpdate:withError
Сообщает прослушивателю, что обновление транспортного средства не удалось. Пока у водителя включено обновление местоположения, класс
GMTDVehicleReporter
продолжает отправлять последние данные в Fleet Engine.
В следующих примерах показано, как настроить GMTDVehicleReporterListener
для обработки этих событий:
Быстрый
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
ridesharingDriverAPI.vehicleReporter.add(self)
}
func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
// Handle update succeeded.
}
func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didFail vehicleUpdate: GMTDVehicleUpdate, withError error: Error) {
// Handle update failed.
}
}
Цель-C
/**
* 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 have implemented the sample code up to this step.
[ridesharingDriverAPI.vehicleReporter addListener:self];
}
- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
// Handle update succeeded.
}
- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
// Handle update failed.
}
@end
Слушайте обновления местоположения автомобиля
Навигационный SDK предоставляет обновления местоположения для Driver SDK через класс GMSRoadSnappedLocationProvider
. Чтобы получать эти обновления, вы должны настроить GMTDVehicleReporter
в качестве прослушивателя.
Быстрый
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
if let roadSnappedLocationProvider = mapView.roadSnappedLocationProvider {
roadSnappedLocationProvider.add(ridesharingDriverAPI.vehicleReporter)
roadSnappedLocationProvider.startUpdatingLocation()
}
}
}
Цель-C
/**
* 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 have implemented the sample code up to this step.
[_mapView.roadSnappedLocationProvider addListener:ridesharingDriverAPI.vehicleReporter];
[_mapView.roadSnappedLocationProvider startUpdatingLocation];
}
@end
Включить обновление местоположений
Чтобы включить обновление местоположения, установите для locationTrackingEnabled
значение true
в GMTDVehicleReporter
в приложении драйвера. Затем класс GMTDVehicleReporter
автоматически отправляет обновления местоположения в Fleet Engine. После того как Fleet Engine и серверные службы клиента сопоставят и назначат транспортное средство для поездки, класс GMTDVehicleReporter
автоматически отправляет обновления маршрута, когда GMSNavigator
находится в режиме навигации, то есть, когда пункт назначения задается с помощью setDestinations
.
Driver SDK устанавливает маршрут, соответствующий текущему пути навигации водителя. Чтобы обеспечить точное обновление местоположения, установите путевую точку в setDestinations
, чтобы она соответствовала пункту назначения в Fleet Engine.
В следующем примере показано, как включить обновление местоположений:
Быстрый
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = true
}
}
Цель-C
/**
* 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 have implemented the sample code up to this step.
ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}
@end
Установите интервал обновления
По умолчанию, если для locationTrackingEnabled
установлено true
, Driver SDK отправляет обновления о поездках и транспортных средствах в Fleet Engine с 10-секундным интервалом. Вы можете изменить интервал обновления с помощью locationUpdateInterval
, установив минимальный интервал обновления в 5 секунд или максимум в 60 секунд. Более частые обновления могут привести к замедлению запросов и ошибкам.
Установите состояние автомобиля в онлайн-режиме
После включения обновления местоположения установите для автомобиля состояние ONLINE
, чтобы сделать автомобиль доступным для поисковых запросов в Fleet Engine.
В следующих примерах показано, как установить состояние автомобиля в ONLINE
. Подробности см. updateVehicleState
.
Быстрый
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
ridesharingDriverAPI.vehicleReporter.update(.online)
}
}
Цель-C
#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 have implemented the sample code up to this step.
[ridesharingDriverAPI.vehicleReporter
updateVehicleState:GMTDVehicleStateOnline];
}
@end