stopGuidance

Command

Stops the current navigation

Send this JSON-RPC message in the BND_MESSAGE extra of an Intent with the action ACTION_RNC_BROADCAST, to BeNav's activity or receiver: see Sending commands.

Ends the current guidance session. BeNav stops giving instructions and returns to tracking mode, where it keeps showing the vehicle's position on the map without directing it anywhere.

This is the client application cancelling a journey it started (a job withdrawn, a round re-planned, a driver sent elsewhere) as opposed to the driver stopping navigation themselves, which arrives as onGuidanceStopped.

Worth knowing

If no guidance is running the command returns 7 not.in.guidance.
The map stays on screen and keeps following the vehicle; this ends the route, it does not close the application.

Command#

json

{
  "jsonrpc": "2.0",
  "method": "stopGuidance",
  "id": "1"
}

Response#

Success#

json

{
  "jsonrpc": "2.0",
  "result": {},
  "id": "1"
}

Error#

Generic errors, plus 7 not.in.guidance when no navigation is running (or when the stop itself fails).