Package com.viam.service.navigation.v1

Class NavigationServiceGrpc.NavigationServiceBlockingStub

java.lang.Object

io.grpc.stub.AbstractStub<NavigationServiceGrpc.NavigationServiceBlockingStub>

io.grpc.stub.AbstractBlockingStub<NavigationServiceGrpc.NavigationServiceBlockingStub>

com.viam.service.navigation.v1.NavigationServiceGrpc.NavigationServiceBlockingStub

Enclosing class:

NavigationServiceGrpc

public static final class NavigationServiceGrpc.NavigationServiceBlockingStub
extends io.grpc.stub.AbstractBlockingStub<NavigationServiceGrpc.NavigationServiceBlockingStub>

A stub to allow clients to do limited synchronous rpc calls to service NavigationService.

 A NavigationService declares the gRPC contract for a Navigation service.
 Each service instance is bound to exactly one controllable base and one map
 type (local SLAM or GPS). Apps save named locations, routes, and zones, then
 navigate with plan-then-drive or direct go-to motion.
 

Nested Class Summary

Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub

io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>>

Method Summary

Modifier and Type	Method	Description
Navigation.AddLocationResponse	addLocation(Navigation.AddLocationRequest request)	AddLocation saves a named position on the active map.
Navigation.AddRouteResponse	addRoute(Navigation.AddRouteRequest request)	AddRoute creates a named route from an ordered list of waypoints.
Navigation.AddZoneResponse	addZone(Navigation.AddZoneRequest request)	AddZone creates a keep-out or speed-limit zone on the active map.
protected NavigationServiceGrpc.NavigationServiceBlockingStub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
Navigation.CancelResponse	cancel(Navigation.CancelRequest request)	Cancel stops all motion and discards both the active goal and any suspended goal.
Navigation.DeleteLocationResponse	deleteLocation(Navigation.DeleteLocationRequest request)	DeleteLocation deletes a saved location.
Navigation.DeleteRouteResponse	deleteRoute(Navigation.DeleteRouteRequest request)	DeleteRoute deletes a route.
Navigation.DeleteZoneResponse	deleteZone(Navigation.DeleteZoneRequest request)	DeleteZone deletes a zone.
Common.DoCommandResponse	doCommand(Common.DoCommandRequest request)	DoCommand sends/receives arbitrary commands
Navigation.ExecutePlanResponse	executePlan(Navigation.ExecutePlanRequest request)	ExecutePlan drives a Plan (typically from PlanToPoint or PlanToLocation).
Navigation.GetCostmapResponse	getCostmap(Navigation.GetCostmapRequest request)	GetCostmap returns the local or global costmap as a downsampled grid, for display in UIs.
Navigation.GetLocationResponse	getLocation(Navigation.GetLocationRequest request)	GetLocation returns a saved location by name.
Navigation.GetNavigationStatusResponse	getNavigationStatus(Navigation.GetNavigationStatusRequest request)	GetNavigationStatus returns the full navigation state, including the robot's current position and the latest goal.
Navigation.GetPositionResponse	getPosition(Navigation.GetPositionRequest request)	GetPosition returns the robot's current position on the active map.
Navigation.GetPropertiesResponse	getProperties(Navigation.GetPropertiesRequest request)	GetProperties returns the map type the service operates on and robot properties.
Navigation.GetRouteResponse	getRoute(Navigation.GetRouteRequest request)	GetRoute returns a route by name.
Common.GetStatusResponse	getStatus(Common.GetStatusRequest request)	GetStatus returns the status of the resource
Navigation.GetZoneResponse	getZone(Navigation.GetZoneRequest request)	GetZone returns a zone by name.
Navigation.GoToLocationResponse	goToLocation(Navigation.GoToLocationRequest request)	GoToLocation drives directly to a saved location with a closed-loop controller, without full path planning.
Navigation.GoToPointResponse	goToPoint(Navigation.GoToPointRequest request)	GoToPoint drives directly to a Position with a closed-loop controller, without full path planning.
Navigation.ListLocationsResponse	listLocations(Navigation.ListLocationsRequest request)	ListLocations lists all saved locations on the active map.
Navigation.ListRoutesResponse	listRoutes(Navigation.ListRoutesRequest request)	ListRoutes lists all routes on the active map.
Navigation.ListZonesResponse	listZones(Navigation.ListZonesRequest request)	ListZones lists zones on the active map, optionally filtered by type.
Navigation.NavigateRouteResponse	navigateRoute(Navigation.NavigateRouteRequest request)	NavigateRoute drives a route one waypoint at a time using the obstacle-aware planner.
Navigation.NavigateToLocationResponse	navigateToLocation(Navigation.NavigateToLocationRequest request)	NavigateToLocation plans an obstacle-aware path to a saved location and starts driving it.
Navigation.NavigateToPointResponse	navigateToPoint(Navigation.NavigateToPointRequest request)	NavigateToPoint plans an obstacle-aware path to a Position and starts driving it.
Navigation.PlanToLocationResponse	planToLocation(Navigation.PlanToLocationRequest request)	PlanToLocation computes a path to a saved location without moving.
Navigation.PlanToPointResponse	planToPoint(Navigation.PlanToPointRequest request)	PlanToPoint computes a path from the robot (or a given start) to a Position without moving.
Navigation.ResumeResponse	resume(Navigation.ResumeRequest request)	Resume resumes the suspended goal the same way it was started: planned navigation, simple go-to, or a route from its current waypoint.
Navigation.SuspendResponse	suspend(Navigation.SuspendRequest request)	Suspend stops motion but remembers the current goal, including the current waypoint and loop setting for routes.
Navigation.UpdateLocationResponse	updateLocation(Navigation.UpdateLocationRequest request)	UpdateLocation changes a saved location's position or name.
Navigation.UpdateRouteResponse	updateRoute(Navigation.UpdateRouteRequest request)	UpdateRoute renames a route and/or replaces its waypoints.
Navigation.UpdateZoneResponse	updateZone(Navigation.UpdateZoneRequest request)	UpdateZone changes a zone's type, geometry, speed limit, or name.

Methods inherited from class io.grpc.stub.AbstractBlockingStub

newStub, newStub

Methods inherited from class io.grpc.stub.AbstractStub

getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOnReadyThreshold, withOption, withWaitForReady

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

build

protected NavigationServiceGrpc.NavigationServiceBlockingStub build(io.grpc.Channel channel,
 io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<NavigationServiceGrpc.NavigationServiceBlockingStub>

addLocation

public Navigation.AddLocationResponse addLocation(Navigation.AddLocationRequest request)

 AddLocation saves a named position on the active map. If position is
 omitted, the robot's current position from GetPosition is saved.
 

getLocation

public Navigation.GetLocationResponse getLocation(Navigation.GetLocationRequest request)

 GetLocation returns a saved location by name. This does not return the
 robot's current position; use GetPosition for that.
 

listLocations

public Navigation.ListLocationsResponse listLocations(Navigation.ListLocationsRequest request)

 ListLocations lists all saved locations on the active map.
 

updateLocation

public Navigation.UpdateLocationResponse updateLocation(Navigation.UpdateLocationRequest request)

 UpdateLocation changes a saved location's position or name. Renaming a
 location updates every route waypoint that references it.
 

deleteLocation

public Navigation.DeleteLocationResponse deleteLocation(Navigation.DeleteLocationRequest request)

 DeleteLocation deletes a saved location. The location is also removed from
 every route that references it.
 

addRoute

public Navigation.AddRouteResponse addRoute(Navigation.AddRouteRequest request)

 AddRoute creates a named route from an ordered list of waypoints. Every
 referenced location must already exist.
 

getRoute

public Navigation.GetRouteResponse getRoute(Navigation.GetRouteRequest request)

 GetRoute returns a route by name.
 

listRoutes

public Navigation.ListRoutesResponse listRoutes(Navigation.ListRoutesRequest request)

 ListRoutes lists all routes on the active map.
 

updateRoute

public Navigation.UpdateRouteResponse updateRoute(Navigation.UpdateRouteRequest request)

 UpdateRoute renames a route and/or replaces its waypoints. An unset
 waypoints list leaves the waypoints unchanged. A set list, including an
 empty one, replaces them.
 

deleteRoute

public Navigation.DeleteRouteResponse deleteRoute(Navigation.DeleteRouteRequest request)

 DeleteRoute deletes a route. The locations it references are not affected.
 

addZone

public Navigation.AddZoneResponse addZone(Navigation.AddZoneRequest request)

 AddZone creates a keep-out or speed-limit zone on the active map. The
 planner avoids keep-out zones and caps speed inside speed-limit zones.
 

getZone

public Navigation.GetZoneResponse getZone(Navigation.GetZoneRequest request)

 GetZone returns a zone by name.
 

listZones

public Navigation.ListZonesResponse listZones(Navigation.ListZonesRequest request)

 ListZones lists zones on the active map, optionally filtered by type.
 

updateZone

public Navigation.UpdateZoneResponse updateZone(Navigation.UpdateZoneRequest request)

 UpdateZone changes a zone's type, geometry, speed limit, or name.
 

deleteZone

public Navigation.DeleteZoneResponse deleteZone(Navigation.DeleteZoneRequest request)

 DeleteZone deletes a zone.
 

navigateToLocation

public Navigation.NavigateToLocationResponse navigateToLocation(Navigation.NavigateToLocationRequest request)

 NavigateToLocation plans an obstacle-aware path to a saved location and
 starts driving it. Returns once the goal is accepted; track progress with
 GetNavigationStatus.
 

navigateToPoint

public Navigation.NavigateToPointResponse navigateToPoint(Navigation.NavigateToPointRequest request)

 NavigateToPoint plans an obstacle-aware path to a Position and starts
 driving it. Returns once the goal is accepted; track progress with
 GetNavigationStatus. On a Pose, theta defaults to 0 if omitted.
 

navigateRoute

public Navigation.NavigateRouteResponse navigateRoute(Navigation.NavigateRouteRequest request)

 NavigateRoute drives a route one waypoint at a time using the
 obstacle-aware planner. Provide either route_name (a saved route) or
 waypoints (an inline list).
 

planToPoint

public Navigation.PlanToPointResponse planToPoint(Navigation.PlanToPointRequest request)

 PlanToPoint computes a path from the robot (or a given start) to a
 Position without moving. Pass a feasible result to ExecutePlan to drive it.
 Raises an error if no path exists.
 

planToLocation

public Navigation.PlanToLocationResponse planToLocation(Navigation.PlanToLocationRequest request)

 PlanToLocation computes a path to a saved location without moving. Accepts
 the same optional start as PlanToPoint. Raises an error if no path exists.
 

executePlan

public Navigation.ExecutePlanResponse executePlan(Navigation.ExecutePlanRequest request)

 ExecutePlan drives a Plan (typically from PlanToPoint or PlanToLocation).
 While navigating, the active path is available on GetNavigationStatus. Rejected if
 the path is empty.
 

goToLocation

public Navigation.GoToLocationResponse goToLocation(Navigation.GoToLocationRequest request)

 GoToLocation drives directly to a saved location with a closed-loop
 controller, without full path planning. Intended for short hops and
 docking. With wait false, returns immediately while navigating.
 

goToPoint

public Navigation.GoToPointResponse goToPoint(Navigation.GoToPointRequest request)

 GoToPoint drives directly to a Position with a closed-loop controller,
 without full path planning. Intended for short hops and docking. With wait
 false, returns immediately while navigating.
 

suspend

public Navigation.SuspendResponse suspend(Navigation.SuspendRequest request)

 Suspend stops motion but remembers the current goal, including the current
 waypoint and loop setting for routes. A suspended goal must be canceled
 before a new one starts.
 

resume

public Navigation.ResumeResponse resume(Navigation.ResumeRequest request)

 Resume resumes the suspended goal the same way it was started: planned
 navigation, simple go-to, or a route from its current waypoint.
 

cancel

public Navigation.CancelResponse cancel(Navigation.CancelRequest request)

 Cancel stops all motion and discards both the active goal and any
 suspended goal.
 

getPosition

public Navigation.GetPositionResponse getPosition(Navigation.GetPositionRequest request)

 GetPosition returns the robot's current position on the active map. Use
 this for frequent position polling; GetNavigationStatus reports the same position
 alongside the rest of the navigation state.
 

getNavigationStatus

public Navigation.GetNavigationStatusResponse getNavigationStatus(Navigation.GetNavigationStatusRequest request)

 GetNavigationStatus returns the full navigation state, including the robot's
 current position and the latest goal.
 

getProperties

public Navigation.GetPropertiesResponse getProperties(Navigation.GetPropertiesRequest request)

 GetProperties returns the map type the service operates on and robot
 properties. These values do not change while the service is running.
 

getCostmap

public Navigation.GetCostmapResponse getCostmap(Navigation.GetCostmapRequest request)

 GetCostmap returns the local or global costmap as a downsampled grid, for
 display in UIs.
 

doCommand

public Common.DoCommandResponse doCommand(Common.DoCommandRequest request)

 DoCommand sends/receives arbitrary commands
 

getStatus

public Common.GetStatusResponse getStatus(Common.GetStatusRequest request)

 GetStatus returns the status of the resource