OSID Logo
OSID Specifications
mapping route package
Version 3.0.0
Release Candidate Preview
Interfaceosid.mapping.route.MyRouteSession
Implementsosid.OsidSession
Description

This session defines methods to route between locations.

MethodgetMapId
Description

Gets the Map Id associated with this session.

Returnosid.id.Idthe Map Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetMap
Description

Gets the Map associated with this session.

Returnosid.mapping.Mapthe map
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanAccessMyLocation
Description

Tests if this user can query own location. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may not offer location operations to unauthorized users.

Returnboolean false if location methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodisOnRoute
Description

Tests if this agent is on a route.

Returnboolean true if the agent is on a route, false otherrwise
CompliancemandatoryThis method must be implemented.
MethodgetMyRoute
Description

Gets the current route of this agent.

Returnosid.mapping.route.Routethe current route
ErrorsILLEGAL_STATE isOnRoute() is false
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetMyRouteSegment
Description

Gets the current route segment of this agent.

Returnosid.mapping.route.RouteSegmentthe current route segment
ErrorsILLEGAL_STATE isOnRoute() is false
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodselectMyRoute
Description

Sets the route for this agent.

Parametersosid.id.IdrouteIda route Id
Returnosid.mapping.route.RouteSegmentthe current route segment
ErrorsALREADY_EXISTSthe agent is already moving on a route
NOT_FOUND routeId is not found
NULL_ARGUMENT routeId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcancelMyRoute
Description

Cancels the current route for this agent.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetMyProgress
Description

Gets the current route progress.

Returnosid.mapping.route.RouteProgressthe current route progress
ErrorsILLEGAL_STATE isOnRoute() is false
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.