POST api/v4/latestlocation

Get a list of locations for a list of service ids

Request Information

URI Parameters

None.

Body Parameters

LocationRequestModel
NameDescriptionTypeAdditional information
Token

The token returned after login used for authentication

string

None.

UserID

The user id returned after login used for authentication

unsigned integer

None.

ServiceIDList

A list of service ids being requested

Collection of unsigned integer

None.

Request Formats

application/json, text/json

Sample:
{
  "Token": "sample string 1",
  "UserID": 2,
  "ServiceIDList": [
    1,
    2
  ]
}

application/xml, text/xml

Sample:
<LocationRequestModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Token>sample string 1</Token>
  <UserID>2</UserID>
  <ServiceIDList>
    <unsignedLong>1</unsignedLong>
    <unsignedLong>2</unsignedLong>
  </ServiceIDList>
</LocationRequestModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

A list of Location details

Collection of Location
NameDescriptionTypeAdditional information
ServiceId

The service id of the unit which the location belongs to

unsigned integer

None.

GPSLatitude

The latitude in degrees

decimal number

None.

GPSLongitude

The longitude in degrees

decimal number

None.

GeoStreet

The street where the service is located

string

None.

GeoTown

The town where the service is located

string

None.

GeoCountry

The country where the service is located

string

None.

GeoPostcode

The postcode where the service is located

string

None.

IgnitionState

A flag to indicate if the ignition is currently on

boolean

None.

GPSTime

The time in UTC when this position was recorded

date

None.

GPSSpeed

The vehicle speed in MPH

decimal number

None.

GPSHeading

The GPS Heading

decimal number

None.

Response Formats

application/json, text/json

Sample:

Sample not available.