<back to all web services
Route
Contains the data for a route within the system.
The following routes are available for this service:| GET,POST,DELETE | /{Workspace}/Route/{ObjectId} | | |
|---|
| GET | /{Workspace}/Route/{UserId}/{Date} | | |
|---|
Route Parameters:| Name | Parameter | Data Type | Required | Description |
|---|
| Workspace | path | string | No | |
| AssignedWorkspace | body | string | No | |
| ObjectId | path | string | No | |
| VersionId | body | string | No | |
| BasedOn | body | string | No | |
| Created | body | string | No | |
| LastUpdated | body | string | No | |
| Date | path | string | No | |
| StartTime | body | string | No | |
| EndTime | body | string | No | |
| UserId | path | string | No | |
| Name | body | string | No | |
| Type | body | string | No | |
| Segments | body | List<RouteSegment> | No | |
| TotalTime | body | int | No | |
| TotalDistance | body | double | No | |
| Nodes | body | List<RouteNode> | No | |
RouteSegment Parameters:| Name | Parameter | Data Type | Required | Description |
|---|
| Time | form | int | No | |
| Distance | form | double | No | |
| Start | form | string | No | |
| End | form | string | No | |
| Geometry | form | List<Location> | No | |
| DrivingDirections | form | List<string> | No | |
| EndNode | form | RouteNode | No | |
Location Parameters:| Name | Parameter | Data Type | Required | Description |
|---|
| y | form | double | No | |
| x | form | double | No | |
RouteNode Parameters:| Name | Parameter | Data Type | Required | Description |
|---|
| Location | form | Location | No | |
| StopTime | form | int | No | |
| Schedule | form | Schedule | No | |
| Name | form | string | No | |
ClassedItem Parameters:| Name | Parameter | Data Type | Required | Description |
|---|
| ObjectId | form | string | No | |
| Class | form | string | No | |
| VersionId | form | string | No | |
| Ancestors | form | List<string> | No | |
| Type | form | string | No | |
Schedule Parameters:| Name | Parameter | Data Type | Required | Description |
|---|
| Workspace | form | string | No | |
| ObjectId | form | string | No | |
| VersionId | form | string | No | |
| BasedOn | form | string | No | |
| Start | form | string | No | |
| End | form | string | No | |
| TimeZone | form | string | No | |
| Users | form | List<string> | No | |
| Teams | form | List<string> | No | |
| Data | form | Dictionary<string, Object> | No | |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
HTTP + XML
The following are sample HTTP requests and responses.
The placeholders shown need to be replaced with actual values.
POST /{Workspace}/Route/{ObjectId} HTTP/1.1
Host: dev.fieldsquared.com
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<Route xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Field2Office.API.Model.MapRoute">
<AssignedWorkspace>String</AssignedWorkspace>
<BasedOn>String</BasedOn>
<Created>String</Created>
<Date>String</Date>
<EndTime>String</EndTime>
<LastUpdated>String</LastUpdated>
<Name>String</Name>
<Nodes>
<RouteNode>
<Ancestors xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">
<d4p1:string>String</d4p1:string>
</Ancestors>
<Class xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">String</Class>
<ObjectId xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">String</ObjectId>
<Type xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">String</Type>
<VersionId xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">String</VersionId>
<Location xmlns:d4p1="http://schemas.datacontract.org/2004/07/Field2Office.API.Model">
<d4p1:x>0</d4p1:x>
<d4p1:y>0</d4p1:y>
</Location>
<Name>String</Name>
<Schedule xmlns:d4p1="http://schemas.datacontract.org/2004/07/Field2Office.API.Model.Schedules">
<d4p1:BasedOn>String</d4p1:BasedOn>
<d4p1:Data xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d5p1:KeyValueOfstringanyType>
<d5p1:Key>String</d5p1:Key>
<d5p1:Value />
</d5p1:KeyValueOfstringanyType>
</d4p1:Data>
<d4p1:End>String</d4p1:End>
<d4p1:ObjectId>String</d4p1:ObjectId>
<d4p1:Start>String</d4p1:Start>
<d4p1:Teams xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d5p1:string>String</d5p1:string>
</d4p1:Teams>
<d4p1:TimeZone>String</d4p1:TimeZone>
<d4p1:Users xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d5p1:string>String</d5p1:string>
</d4p1:Users>
<d4p1:VersionId>String</d4p1:VersionId>
<d4p1:Workspace>String</d4p1:Workspace>
</Schedule>
<StopTime>0</StopTime>
</RouteNode>
</Nodes>
<ObjectId>String</ObjectId>
<Segments>
<RouteSegment>
<Distance>0</Distance>
<DrivingDirections xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d4p1:string>String</d4p1:string>
</DrivingDirections>
<End>String</End>
<EndNode>
<Ancestors xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">
<d5p1:string>String</d5p1:string>
</Ancestors>
<Class xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">String</Class>
<ObjectId xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">String</ObjectId>
<Type xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">String</Type>
<VersionId xmlns="http://schemas.datacontract.org/2004/07/Field2Office.DomainObjects.Model">String</VersionId>
<Location xmlns:d5p1="http://schemas.datacontract.org/2004/07/Field2Office.API.Model">
<d5p1:x>0</d5p1:x>
<d5p1:y>0</d5p1:y>
</Location>
<Name>String</Name>
<Schedule xmlns:d5p1="http://schemas.datacontract.org/2004/07/Field2Office.API.Model.Schedules">
<d5p1:BasedOn>String</d5p1:BasedOn>
<d5p1:Data xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d6p1:KeyValueOfstringanyType>
<d6p1:Key>String</d6p1:Key>
<d6p1:Value />
</d6p1:KeyValueOfstringanyType>
</d5p1:Data>
<d5p1:End>String</d5p1:End>
<d5p1:ObjectId>String</d5p1:ObjectId>
<d5p1:Start>String</d5p1:Start>
<d5p1:Teams xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d6p1:string>String</d6p1:string>
</d5p1:Teams>
<d5p1:TimeZone>String</d5p1:TimeZone>
<d5p1:Users xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d6p1:string>String</d6p1:string>
</d5p1:Users>
<d5p1:VersionId>String</d5p1:VersionId>
<d5p1:Workspace>String</d5p1:Workspace>
</Schedule>
<StopTime>0</StopTime>
</EndNode>
<Geometry xmlns:d4p1="http://schemas.datacontract.org/2004/07/Field2Office.API.Model">
<d4p1:Location>
<d4p1:x>0</d4p1:x>
<d4p1:y>0</d4p1:y>
</d4p1:Location>
</Geometry>
<Start>String</Start>
<Time>0</Time>
</RouteSegment>
</Segments>
<StartTime>String</StartTime>
<Type>String</Type>
<UserId>String</UserId>
<VersionId>String</VersionId>
<Workspace>String</Workspace>
</Route>