Class NavigationClient

constructor

• new NavigationClient(
      client: RobotClient,
      name: string,
      options?: Options,
  ): NavigationClient

  Parameters

  • client: RobotClient
  • name: string
  • options: Options = {}

  Returns NavigationClient

callOptions

Readonlyname

addWayPoint

• addWayPoint(
      location: PlainMessage,
      extra?: {},
      callOptions?: CallOptions,
  ): Promise<void>

  Add a waypoint to the service's data storage.

  Parameters

  • location: PlainMessage

    A waypoint described by latitude and longitude values.
  • extra: {} = {}
  • callOptions: CallOptions = ...

  Returns Promise<void>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  const location = { latitude: 40.7128, longitude: -74.006 };
  await navigation.addWayPoint(location);
  Copy

  For more information, see Navigation API.

doCommand

• doCommand(command: Struct, callOptions?: CallOptions): Promise<JsonValue>

  Send/Receive arbitrary commands to the resource.

  Parameters

  • command: Struct

    The command to execute.
  • callOptions: CallOptions = ...

  Returns Promise<JsonValue>

  Example

  import { Struct } from '@viamrobotics/sdk';
  
  const result = await resource.doCommand(
    Struct.fromJson({
      myCommand: { key: 'value' },
    })
  );
  Copy

getLocation

• getLocation(
      extra?: {},
      callOptions?: CallOptions,
  ): Promise<navigationApi.GetLocationResponse>

  Get the current location of the robot.

  Parameters

  • extra: {} = {}
  • callOptions: CallOptions = ...

  Returns Promise<navigationApi.GetLocationResponse>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  const location = await navigation.getLocation();
  Copy

  For more information, see Navigation API.

getMode

• getMode(extra?: {}, callOptions?: CallOptions): Promise<navigationApi.Mode>

  Get the mode the robot is operating in.

  Parameters

  • extra: {} = {}
  • callOptions: CallOptions = ...

  Returns Promise<navigationApi.Mode>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  const mode = await navigation.getMode();
  Copy

  For more information, see Navigation API.

getObstacles

• getObstacles(
      extra?: {},
      callOptions?: CallOptions,
  ): Promise<commonApi.GeoGeometry[]>

  Get a list of obstacles.

  Parameters

  • extra: {} = {}
  • callOptions: CallOptions = ...

  Returns Promise<commonApi.GeoGeometry[]>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  const obstacles = await navigation.getObstacles();
  Copy

  For more information, see Navigation API.

getPaths

• getPaths(extra?: {}, callOptions?: CallOptions): Promise<navigationApi.Path[]>

  Gets the list of paths known to the navigation service.

  Parameters

  • extra: {} = {}
  • callOptions: CallOptions = ...

  Returns Promise<navigationApi.Path[]>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  const paths = await navigation.getPaths();
  Copy

  For more information, see Navigation API.

getProperties

• getProperties(
      callOptions?: CallOptions,
  ): Promise<navigationApi.GetPropertiesResponse>

  Gets information on the properties of the current navigation service.

  Parameters

  • callOptions: CallOptions = ...

  Returns Promise<navigationApi.GetPropertiesResponse>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  const properties = await navigation.getProperties();
  Copy

  For more information, see Navigation API.

getWayPoints

• getWayPoints(
      extra?: {},
      callOptions?: CallOptions,
  ): Promise<navigationApi.Waypoint[]>

  Get an array of waypoints currently in the service's data storage.

  Parameters

  • extra: {} = {}
  • callOptions: CallOptions = ...

  Returns Promise<navigationApi.Waypoint[]>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  const waypoints = await navigation.getWayPoints();
  Copy

  For more information, see Navigation API.

removeWayPoint

• removeWayPoint(id: string, extra?: {}, callOptions?: CallOptions): Promise<void>

  Remove a waypoint from the service's data storage.

  Parameters

  • id: string

    The MongoDB ObjectID of the waypoint to remove from the service's data storage.
  • extra: {} = {}
  • callOptions: CallOptions = ...

  Returns Promise<void>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  // Remove the first waypoint
  if (waypoints.length > 0) {
    await navigation.removeWayPoint(waypoints[0].id);
  }
  Copy

  For more information, see Navigation API.

setMode

• setMode(
      mode: navigationApi.Mode,
      extra?: {},
      callOptions?: CallOptions,
  ): Promise<void>

  Set the mode the robot is operating in.

  Parameters

  • mode: navigationApi.Mode

    The mode for the service to operate in.

    • 0: MODE_UNSPECIFIED
    • 1: MODE_MANUAL
    • 2: MODE_WAYPOINT
    • 3: MODE_EXPLORE
  • extra: {} = {}
  • callOptions: CallOptions = ...

  Returns Promise<void>

  Example

  const navigation = new VIAM.NavigationClient(machine, 'my_navigation');
  
  // Set the mode to 2 which corresponds to WAYPOINT
  await navigation.setMode(2);
  Copy

  For more information, see Navigation API.