São viagens compartilhadas entre vários consumidores que compartilham o veículo ao mesmo tempo. Ou seja, as viagens são simultâneas, não independentes. O processo é semelhante ao dos traslados de aeroportos, mas o motorista também pode deixar os consumidores ao longo do trajeto.
A principal diferença entre viagens compartilhadas e destinos únicos é que, nesse tipo de viagem, o operador pode transportar mais de um passageiro ao mesmo tempo.
Neste tutorial, explicamos o processo de criação de uma viagem em grupo compartilhado. Ele também mostra como você pode integrar essa viagem ao seu aplicativo para consumidores, de modo que os clientes possam visualizar o andamento da viagem pelo smartphone. Essa integração é feita usando o SDK do consumidor.
Etapa 1. Criar um veículo no Fleet Engine
Os veículos são objetos que representam os veículos da sua frota. É necessário criá-los no Fleet Engine para rastreá-los no app do consumidor.
Você pode criar um veículo usando uma destas duas abordagens:
- gRPC
- Chame o método
CreateVehicle()
com a mensagem de solicitaçãoCreateVehicleRequest
. Você precisa ter privilégios de superusuário do Fleet Engine para chamarCreateVehicle()
. - REST
- Ligue para
https://fleetengine.googleapis.com/v1/providers.vehicles.create
.
Advertências
As ressalvas a seguir se aplicam quando você cria um veículo.
Defina o estado inicial do veículo como
OFFLINE
. Isso garante que o Fleet Engine possa detectar seu veículo para fazer a correspondência da viagem.O
provider_id
do veículo precisa ser igual ao ID do projeto do Google Cloud que contém as contas de serviço usadas para chamar o Fleet Engine. Várias contas de serviço podem acessar o Fleet Engine para o mesmo provedor de compartilhamento de navegação, mas o Fleet Engine atualmente não oferece suporte a contas de serviço de diferentes projetos do Google Cloud que acessam os mesmos veículos.A resposta retornada de
CreateVehicle()
contém a instânciaVehicle
. A instância será excluída após sete dias se não tiver sido atualizada usandoUpdateVehicle()
. ChameGetVehicle()
antes de chamarCreateVehicle()
apenas para confirmar que o veículo ainda não existe. SeGetVehicle()
retornar um erroNOT_FOUND
, continue chamandoCreateVehicle()
. Para mais informações, consulte Veículos e o ciclo de vida deles.
Exemplo
O exemplo de código de provedor a seguir demonstra como criar um veículo no Fleet Engine.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
Vehicle vehicle = Vehicle.newBuilder()
.setVehicleState(VehicleState.OFFLINE) // Initial state
.addSupportedTripTypes(TripType.EXCLUSIVE)
.setMaximumCapacity(4)
.setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
.build();
CreateVehicleRequest createVehicleRequest = CreateVehicleRequest.newBuilder()
.setParent(parent)
.setVehicleId("8241890") // Vehicle ID assigned by solution provider.
.setVehicle(vehicle) // Initial state.
.build();
// The Vehicle is created in the OFFLINE state, and no initial position is
// provided. When the driver app calls the rideshare provider, the state can be
// set to ONLINE, and the driver app updates the vehicle location.
try {
Vehicle createdVehicle = vehicleService.createVehicle(createVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
Para criar um Vehicle
compatível com viagens de pool compartilhado, adicione TripType.SHARED
à lista de tipos de viagem compatíveis no objeto Vehicle
transmitido para CreateVehicleRequest
.
Vehicle vehicle = Vehicle.newBuilder()
.setVehicleState(VehicleState.OFFLINE)
.addSupportedTripTypes(TripType.SHARED)
.setMaximumCapacity(4)
.setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
.build();
Etapa 2: Ativar rastreamento de localização
O rastreamento de localização se refere ao local do veículo durante a viagem, em que o app do motorista envia telemetria para o Fleet Engine, que contém a localização atual do veículo. Esse fluxo de informações de posição constantemente atualizado é usado para transmitir o progresso do veículo ao longo do trajeto da viagem. Quando você ativa o rastreamento de localização, o app do driver começa a enviar essa telemetria a uma frequência padrão de uma vez a cada cinco segundos.
Ative o acompanhamento de local para Android e iOS da seguinte maneira:
Chame o método
enableLocationTracking()
do SDK do Driver para Android.Defina a propriedade booleana
locationTrackingEnabled
do SDK do Driver para iOS comotrue
.
Exemplo
O exemplo de código a seguir demonstra como ativar o monitoramento de localização.
Java
RidesharingVehicleReporter vehicleReporter = ...;
vehicleReporter.enableLocationTracking();
Kotlin
val vehicleReporter = ...
vehicleReporter.enableLocationTracking()
Swift
vehicleReporter.locationTrackingEnabled = true
Objective-C
_vehicleReporter.locationTrackingEnabled = YES;
Etapa 3. Definir o estado do veículo como on-line
Para colocar um veículo em serviço (ou seja, disponibilizá-lo para uso), defina o estado dele como on-line, mas não faça isso antes de ativar o rastreamento de localização.
Defina o estado do veículo como on-line para Android e iOS da seguinte maneira:
Chame o método
setVehicleState(VehicleState.ONLINE)
do SDK do Driver para Android.Chame o método
vehicleReporter.update(.online)
do SDK do Driver para iOS.
Exemplo
O exemplo de código abaixo demonstra como definir o estado do veículo como
ONLINE
.
Java
vehicleReporter.setVehicleState(VehicleState.ONLINE);
Kotlin
vehicleReporter.setVehicleState(VehicleState.ONLINE)
Swift
vehicleReporter.update(.online)
Objective-C
[_vehicleReporter updateVehicleState:GMTDVehicleStateOnline];
Etapa 4. Criar uma viagem no Fleet Engine
Para criar uma viagem de pool compartilhado, crie um objeto Trip
exatamente como faria para uma viagem de destino único.
Uma viagem é um objeto que representa uma jornada, que é uma coleção de pontos de coordenadas geográficas, incluindo origem, waypoints e pontos de desembarque.
Você precisa criar um objeto Trip
para cada solicitação de viagem, para que ela possa ser associada a um veículo e depois rastreada.
- Para criar uma viagem, chame o método
CreateTrip()
com a mensagem de solicitaçãoCreateTripRequest
.
Forneça os atributos obrigatórios
Os campos a seguir são obrigatórios para criar uma viagem em pool compartilhado.
parent
- Uma string que inclui o ID do provedor. Precisa ser o mesmo ID do projeto do Google Cloud que contém as contas de serviço usadas para chamar o Fleet Engine
trip_id
- Uma string que você cria e que identifica exclusivamente essa viagem.
trip
Trip
objeto a ser criado.
Os seguintes campos precisam ser definidos no objeto Trip
transmitido para CreateTripRequest
:
trip_type
TripType.SHARED
pickup_point
- O ponto de origem da viagem.
dropoff_point
- O ponto de desembarque da viagem. Esse campo não é obrigatório na criação da viagem e pode ser definido mais tarde chamando
UpdateTrip
.
Exemplo
O exemplo de integração de back-end a seguir demonstra como criar uma viagem e atribuir automaticamente a um veículo como pool compartilhado.
// Vehicle with VEHICLE_ID ID is already created and it is assigned Trip A.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "shared-trip-A";
static final String VEHICLE_ID = "your-vehicle-id";
static final String TRIP_A_ID = "trip-a-id";
static final String TRIP_B_ID = "trip-b-id";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
LatLng tripBPickup =
LatLng.newBuilder().setLatitude(-12.12314).setLongitude(88.142123).build();
LatLng tripBDropoff =
LatLng.newBuilder().setLatitude(-14.12314).setLongitude(90.142123).build();
TerminalLocation tripBPickupTerminalLocation =
TerminalLocation.newBuilder().setPoint(tripBPickup).build();
TerminalLocation tripBDropoffTerminalLocation =
TerminalLocation.newBuilder().setPoint(tripBDropoff).build();
// TripA already exists and it's assigned to a vehicle with VEHICLE_ID ID.
Trip tripB = Trip.newBuilder()
.setTripType(TripType.SHARED)
.setVehicleId(VEHICLE_ID)
.setPickupPoint(tripBPickupTerminalLocation)
.setDropoffPoint(tripBDropoffTerminalLocation)
.addAllVehicleWaypoints(
// This is where you define the arrival order for unvisited waypoints.
// If you don’t specify an order, then the Fleet Engine adds Trip B’s
// waypoints to the end of Trip A’s.
ImmutableList.of(
// Trip B’s pickup point.
TripWaypoint.newBuilder()
.setLocation(tripBPickupTerminalLocation)
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
.build(),
// Trip A’s drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripA.getDropoffPoint())
.setTripId(TRIP_A_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build(),
// Trip B’s drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripBDropoffTerminalLocation)
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build()))
.build();
// Create Trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_B_ID)
.setTrip(tripB)
.build();
try {
// createdTrip.remainingWaypoints will contain shared-pool waypoints.
// [tripB.pickup, tripA.dropoff, tripB.dropoff]
Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
Etapa 5. Atualize a viagem com o ID do veículo e waypoints.
Você precisa configurar a viagem com um ID de veículo para que o Fleet Engine possa rastrear o veículo ao longo do trajeto.
- É possível atualizar a viagem com o ID do veículo chamando o endpoint
UpdateTrip
com umUpdateTripRequest
. Use o campoupdate_mask
para especificar que você está atualizando o ID do veículo.
Você precisa apresentar uma ordem para os waypoints não visitados na coleção de waypoints do veículo (Trip.vehicle_waypoints
). O Fleet Engine usa essa lista para atualizar automaticamente os waypoints de todas as viagens no pool compartilhado.
Por exemplo, considere duas viagens em pool compartilhado: Viagem A e Viagem B. A Viagem A está a caminho do local de desembarque. Em seguida, a Viagem B é adicionada ao mesmo veículo. Em uma UpdateTripRequest
da Viagem B,
você define a vehicleId
e também a Trip.vehicle_waypoints
para a ordem ideal
do waypoint: B Retirada
→ A Desembarque →
B Desembarque.
- Chamar
getVehicle()
retorna uma lista de waypoints restantes (remainingWaypoints
) que contém
B Retirada → A Desembarque → B Desistência. - O callback
getTrip()
ouonTripRemainingWaypointsUpdated
para a Viagem A retorna uma lista de waypoints restantes (remainingWaypoints
) que contém B Retirada → A Desembarque. - O callback
getTrip()
ouonTripRemainingWaypointsUpdated
para a Viagem B retorna uma lista de waypoints restantes (remainingWaypoints
) que contém B Retirada → A Desembarque → B Desembarque.
Exemplo
O exemplo de integração de back-end a seguir demonstra como atualizar uma viagem com o ID do veículo e waypoints para duas viagens em pool compartilhado.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_A_ID = "share-trip-A";
static final String TRIP_B_ID = "share-trip-B";
static final String VEHICLE_ID = "Vehicle";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_B_ID;
// Get Trip A and Trip B objects from either the Fleet Engine or storage.
Trip tripA = …;
Trip tripB = …;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// The trip settings to update.
Trip trip = Trip.newBuilder()
.setVehicleId(VEHICLE_ID)
.addAllVehicleWaypoints(
// This is where you define the arrival order for unvisited waypoints.
// If you don’t specify an order, then the Fleet Engine adds Trip B’s
// waypoints to the end of Trip A’s.
ImmutableList.of(
// Trip B’s pickup point.
TripWaypoint.newBuilder()
.setLocation(tripB.getPickupPoint())
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
.build(),
// Trip A’s drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripA.getDropoffPoint())
.setTripId(TRIP_A_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build(),
// Trip B’s drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripB.getDropoffPoint())
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build()))
.build();
// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(FieldMask.newBuilder()
.addPaths("vehicle_id")
.addPaths("vehicle_waypoints"))
.build();
// Error handling. If Fleet Engine has both a trip and vehicle with the IDs,
// and if the credentials validate, and if the given vehicle_waypoints list
// is valid, then the service updates the trip.
try {
Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND: // Either the trip or vehicle does not exist.
break;
case PERMISSION_DENIED:
break;
case INVALID_REQUEST: // vehicle_waypoints is invalid.
break;
}
return;
}
Etapa 6. Detectar atualizações de viagens no app para consumidores
No Android, você pode detectar atualizações de dados de uma viagem acessando um objeto
TripModel
doTripModelManager
e registrando um listenerTripModelCallback
.No iOS, você pode detectar atualizações de dados de uma viagem acessando um objeto
GMTCTripModel
doGMTCTripService
e registrando um assinanteGMTCTripModelSubscriber
.
Um listener TripModelCallback
e um assinante GMTCTripModelSubscriber
permitem que o app receba atualizações periódicas do andamento da viagem em cada atualização com base no intervalo da atualização automática.
Somente os valores que mudam podem acionar o callback. Caso contrário, o callback
permanecerá silencioso.
Os métodos TripModelCallback.onTripUpdated()
e tripModel(_:didUpdate:updatedPropertyFields:)
são sempre chamados, independentemente de qualquer mudança de dados.
Exemplo 1
O exemplo de código abaixo demonstra como conseguir um TripModel
de
TripModelManager
/GMTCTripService
e definir um listener.
Java
// Start journey sharing after a trip has been created via Fleet Engine.
TripModelManager tripModelManager = consumerApi.getTripModelManager();
// Get a TripModel object.
TripModel tripModel = tripModelManager.getTripModel(tripName);
// Register a listener on the trip.
TripModelCallback tripCallback = new TripModelCallback() {
...
};
tripModel.registerTripCallback(tripCallback);
// Set the refresh interval.
TripModelOptions tripModelOptions = TripModelOptions.builder()
.setRefreshInterval(5000) // interval in milliseconds, so 5 seconds
.build();
tripModel.setTripModelOptions(tripModelOptions);
// The trip stops auto-refreshing when all listeners are unregistered.
tripModel.unregisterTripCallback(tripCallback);
Kotlin
// Start journey sharing after a trip has been created via Fleet Engine.
val tripModelManager = consumerApi.getTripModelManager()
// Get a TripModel object.
val tripModel = tripModelManager.getTripModel(tripName)
// Register a listener on the trip.
val tripCallback = TripModelCallback() {
...
}
tripModel.registerTripCallback(tripCallback)
// Set the refresh interval.
val tripModelOptions =
TripModelOptions.builder()
.setRefreshInterval(5000) // interval in milliseconds, so 5 seconds
.build()
tripModel.setTripModelOptions(tripModelOptions)
// The trip stops auto-refreshing when all listeners are unregistered.
tripModel.unregisterTripCallback(tripCallback)
Swift
let tripService = GMTCServices.shared().tripService
// Create a tripModel instance for listening for updates from the trip
// specified by the trip name.
let tripModel = tripService.tripModel(forTripName: tripName)
// Register for the trip update events.
tripModel.register(self)
// Set the refresh interval (in seconds).
tripModel.options.autoRefreshTimeInterval = 5
// Unregister for the trip update events.
tripModel.unregisterSubscriber(self)
Objective-C
GMTCTripService *tripService = [GMTCServices sharedServices].tripService;
// Create a tripModel instance for listening for updates from the trip
// specified by the trip name.
GMTCTripModel *tripModel = [tripService tripModelForTripName:tripName];
// Register for the trip update events.
[tripModel registerSubscriber:self];
// Set the refresh interval (in seconds).
tripModel.options.autoRefreshTimeInterval = 5;
// Unregister for the trip update events.
[tripModel unregisterSubscriber:self];
Exemplo 2
O exemplo de código a seguir demonstra como configurar um listener TripModelCallback
e um assinante GMTCTripModelSubscriber
.
Java
// Implements a callback for the trip model so your app can listen for trip
// updates from Fleet Engine.
TripModelCallback subscriber =
new TripModelCallback() {
@Override
public void onTripStatusUpdated(TripInfo tripInfo, @TripStatus int status) {
// ...
}
@Override
public void onTripActiveRouteUpdated(TripInfo tripInfo, List<LatLng> route) {
// ...
}
@Override
public void onTripVehicleLocationUpdated(
TripInfo tripInfo, @Nullable VehicleLocation vehicleLocation) {
// ...
}
@Override
public void onTripPickupLocationUpdated(
TripInfo tripInfo, @Nullable TerminalLocation pickup) {
// ...
}
@Override
public void onTripPickupTimeUpdated(TripInfo tripInfo, @Nullable Long timestampMillis) {
// ...
}
@Override
public void onTripDropoffLocationUpdated(
TripInfo tripInfo, @Nullable TerminalLocation dropoff) {
// ...
}
@Override
public void onTripDropoffTimeUpdated(TripInfo tripInfo, @Nullable Long timestampMillis) {
// ...
}
@Override
public void onTripETAToNextWaypointUpdated(
TripInfo tripInfo, @Nullable Long timestampMillis) {
// ...
}
@Override
public void onTripActiveRouteRemainingDistanceUpdated(
TripInfo tripInfo, @Nullable Integer distanceMeters) {
// ...
}
@Override
public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
// ...
}
@Override
public void onTripUpdated(TripInfo tripInfo) {
// ...
}
@Override
public void onTripRemainingWaypointsUpdated(
TripInfo tripInfo, List<TripWaypoint> waypointList) {
// ...
}
@Override
public void onTripIntermediateDestinationsUpdated(
TripInfo tripInfo, List<TerminalLocation> intermediateDestinations) {
// ...
}
@Override
public void onTripRemainingRouteDistanceUpdated(
TripInfo tripInfo, @Nullable Integer distanceMeters) {
// ...
}
@Override
public void onTripRemainingRouteUpdated(TripInfo tripInfo, List<LatLng> route) {
// ...
}
};
Kotlin
// Implements a callback for the trip model so your app can listen for trip
// updates from Fleet Engine.
val subscriber =
object : TripModelCallback() {
override fun onTripStatusUpdated(tripInfo: TripInfo, status: @TripStatus Int) {
// ...
}
override fun onTripActiveRouteUpdated(tripInfo: TripInfo, route: List<LatLng>) {
// ...
}
override fun onTripVehicleLocationUpdated(
tripInfo: TripInfo,
vehicleLocation: VehicleLocation?
) {
// ...
}
override fun onTripPickupLocationUpdated(tripInfo: TripInfo, pickup: TerminalLocation?) {
// ...
}
override fun onTripPickupTimeUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
// ...
}
override fun onTripDropoffLocationUpdated(tripInfo: TripInfo, dropoff: TerminalLocation?) {
// ...
}
override fun onTripDropoffTimeUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
// ...
}
override fun onTripETAToNextWaypointUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
// ...
}
override fun onTripActiveRouteRemainingDistanceUpdated(
tripInfo: TripInfo,
distanceMeters: Int?
) {
// ...
}
override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
// ...
}
override fun onTripUpdated(tripInfo: TripInfo) {
// ...
}
override fun onTripRemainingWaypointsUpdated(
tripInfo: TripInfo,
waypointList: List<TripWaypoint>
) {
// ...
}
override fun onTripIntermediateDestinationsUpdated(
tripInfo: TripInfo,
intermediateDestinations: List<TerminalLocation>
) {
// ...
}
override fun onTripRemainingRouteDistanceUpdated(tripInfo: TripInfo, distanceMeters: Int?) {
// ...
}
override fun onTripRemainingRouteUpdated(tripInfo: TripInfo, route: List<LatLng>) {
// ...
}
}
Swift
class TripModelSubscriber: NSObject, GMTCTripModelSubscriber {
func tripModel(_: GMTCTripModel, didUpdate trip: GMTSTrip?, updatedPropertyFields: GMTSTripPropertyFields) {
// Update the UI with the new `trip` data.
updateUI(with: trip)
...
}
func tripModel(_: GMTCTripModel, didUpdate tripStatus: GMTSTripStatus) {
// Handle trip status did change.
}
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.
}
...
}
Objective-C
@interface TripModelSubscriber : NSObject <GMTCTripModelSubscriber>
@end
@implementation TripModelSubscriber
- (void)tripModel:(GMTCTripModel *)tripModel
didUpdateTrip:(nullable GMTSTrip *)trip
updatedPropertyFields:(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
didUpdateActiveRoute:(nullable NSArray<GMTSLatLng *> *)activeRoute {
// Handle trip 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.
}
…
@end
Você pode acessar informações sobre a viagem a qualquer momento da seguinte maneira:
Chame o método
TripModel.getTripInfo()
do SDK do consumidor para Android. Chamar esse método não força uma atualização de dados, embora os dados ainda continuem a ser atualizados na frequência de atualização.Faça o download da propriedade
GMTCTripModel.currentTrip
do SDK do consumidor para iOS.
Etapa 7. Mostre a jornada no app para o consumidor
Acesse as APIs do elemento da interface do usuário Rides e Deliveries da seguinte maneira:
Faça o download do objeto
ConsumerController
do SDK do consumidor para Android. Para mais informações, consulte Como usar as APIs do elemento da interface do usuário.Acesse o objeto
GMTCMapView
do SDK do consumidor para iOS. Para mais informações, consulte Como usar as APIs do elemento da interface do usuário.
Exemplo
O exemplo de código a seguir demonstra como iniciar a jornada da interface do usuário.
Java
JourneySharingSession session = JourneySharingSession.createInstance(tripModel);
consumerController.showSession(session);
Kotlin
val session = JourneySharingSession.createInstance(tripModel)
consumerController.showSession(session)
Swift
let journeySharingSession = GMTCJourneySharingSession(tripModel: tripModel)
mapView.show(journeySharingSession)
Objective-C
GMTCJourneySharingSession *journeySharingSession =
[[GMTCJourneySharingSession alloc] initWithTripModel:tripModel];
[self.mapView showMapViewSession:journeySharingSession];
Por padrão, o SDK do consumidor mostra apenas o trecho ativo no trajeto, mas você tem a opção de mostrar o trecho restante, que inclui o destino.
Se você quiser mostrar informações sobre waypoints de outras viagens, pode acessar todos os waypoints relevantes para uma viagem da seguinte maneira:
Chame o método
TripModel.getTripInfo()
do SDK do consumidor para Android. Em seguida, chameTripInfo.getRemainingWaypoints()
para receber asTripWaypoint
s. Cada objetoTripWaypoint
contém o ID da viagem, o local e o tipo do waypoint.Faça o download da propriedade
GMTCTripModel.currentTrip
do SDK do consumidor para iOS. Em seguida, acesse a matrizGMTSTrip.remainingWaypoints
para acessar osGMTSTripWaypoint
s. Cada objetoGMTSTripWaypoint
contém o ID da viagem, o local e o tipo do waypoint.
Etapa 8. Gerenciar o estado da viagem no Fleet Engine
Especifique o estado de uma viagem usando um dos valores de enumeração TripStatus
. Quando o estado de uma viagem muda (por exemplo, de ENROUTE_TO_PICKUP
para ARRIVED_AT_PICKUP
), você precisa atualizar o estado da viagem usando o Fleet Engine. O estado da viagem sempre começa com o valor NEW
e termina com COMPLETE
ou CANCELED
. Para mais informações, consulte
trip_status
.
Exemplo
O exemplo de integração de back-end a seguir demonstra como atualizar o estado da viagem no Fleet Engine.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// Trip settings to be updated.
Trip trip = Trip.newBuilder()
.setTripStatus(TripStatus.ARRIVED_AT_PICKUP)
.build();
// Trip update request
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(FieldMask.newBuilder().addPaths("trip_status"))
.build();
// Error handling.
try {
Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND: // The trip doesn't exist.
break;
case FAILED_PRECONDITION: // The given trip status is invalid.
break;
case PERMISSION_DENIED:
break;
}
return;
}