Set the vehicle's destination

This section documents how to set the vehicle's destination after your server matches a trip to a vehicle.

Before you begin

This section requires you to have completed the following:

Set the destination in the driver app

After you have paired a consumer with a driver, you must configure the trip's destination in the driver app by performing the following steps:

Retrieve the vehicle's destination from its waypoints collection in Fleet Engine, which is returned by GetTrip() , UpdateTrip() and GetVehicle() .
Set the destination by calling the Navigation SDK for iOS method setDestinations() .

Note: For the consumer app to properly render the trip, make sure the geographic latitude/longitude coordinates supplied to setDestinations() match those in the trip's waypoint. For more information, see the tutorial Navigate a route .

The following examples show how to set the destination in the driver app.

Swift

  private 
  
 func 
  
 startNavigation 
 () 
  
 { 
  
 let 
  
 destinations 
  
 = 
  
 [ 
  
 GMSNavigationWaypoint 
 ( 
  
 placeID 
 : 
  
 "ChIJnUYTpNASkFQR_gSty5kyoUk" 
 , 
  
 title 
 : 
  
 "PCC Natural Market" 
 ), 
  
 GMSNavigationWaypoint 
 ( 
  
 placeID 
 : 
  
 "ChIJJ326ROcSkFQRBfUzOL2DSbo" 
 , 
  
 title 
 : 
  
 "Marina Park" 
 ), 
  
 ] 
  
 mapView 
 . 
 navigator 
 ?. 
 setDestinations 
 ( 
 destinations 
 , 
  
 callback 
 : 
  
 { 
  
 routeStatus 
  
 in 
  
 guard 
  
 routeStatus 
  
 == 
  
 . 
 OK 
  
 else 
  
 { 
  
 // Error starting navigation. 
  
 return 
  
 } 
  
 mapView 
 . 
 locationSimulator 
 ?. 
 simulateLocationsAlongExistingRoute 
 () 
  
 mapView 
 . 
 navigator 
 ?. 
 isGuidanceActive 
  
 = 
  
 true 
  
 mapView 
 . 
 navigator 
 ?. 
 sendsBackgroundNotifications 
  
 = 
  
 true 
  
 mapView 
 . 
 cameraMode 
  
 = 
  
 . 
 following 
  
 }) 
 }

Objective-C

  - 
 ( 
 void 
 ) 
 startNavigation 
  
 { 
  
 NSArray<GMSNavigationWaypoint 
  
 * 
>  
 * 
 destinations 
  
 = 
  
 @[ 
 [[ 
 GMSNavigationWaypoint 
  
 alloc 
 ] 
  
 initWithPlaceID 
 : 
 @"ChIJnUYTpNASkFQR_gSty5kyoUk" 
  
 title 
 : 
 @"PCC Natural Market" 
 ], 
  
 [[ 
 GMSNavigationWaypoint 
  
 alloc 
 ] 
  
 initWithPlaceID 
 : 
 @"ChIJJ326ROcSkFQRBfUzOL2DSbo" 
  
 title 
 : 
 @"Marina Park" 
 ] 
 ] 
 ; 
  
 [ 
 _mapView 
 . 
 navigator 
  
 setDestinations 
 : 
 destinations 
  
 callback 
 : 
 ^ 
 ( 
 GMSRouteStatus 
  
 routeStatus 
 ) 
  
 { 
  
 if 
  
 ( 
 routeStatus 
  
 != 
  
 GMSRouteStatusOK 
 ) 
  
 { 
  
 // Error starting navigation. 
  
 return 
 ; 
  
 } 
  
 [ 
 _mapView 
 . 
 locationSimulator 
  
 simulateLocationsAlongExistingRoute 
 ]; 
  
 _mapView 
 . 
 navigator 
 . 
 guidanceActive 
  
 = 
  
 YES 
 ; 
  
 _mapView 
 . 
 navigator 
 . 
 sendsBackgroundNotifications 
  
 = 
  
 YES 
 ; 
  
 _mapView 
 . 
 cameraMode 
  
 = 
  
 GMSNavigationCameraModeFollowing 
 ; 
  
 }]; 
 }