POST /geocoding/coordinates/:system_type

Performs reverse geocoding operations using the specified system to determine the locations/addresses at each coordinate in the specified list of coordinates.

Note: This call is not rate-limited.

Parameters

:system_type

(required)

The system against which to perform the reverse geocoding operation.

(required)

A list of Coordinate resources to resolve into locations/addresses.

auth

(required)

The authentication token received in response to the call to POST authentication_credentials or GET authentication_token. Applications should pass the authentication token in the custom "X-auth" HTTP header to avoid passing it in in the query string.

organisation_id

(optional) *

The ID of the organisation against which to perform the reverse geocoding operation. * Required when retrieving data from the Fleet Manager system. Ignored when retrieving data from the Asset Management or X-Drive system.

callback

(optional)

Only available for JSON format. If supplied, the response will use JSONP format with a callback of the given name.

date_format

(optional)

Only available for JSON format. If supplied, the response will contain JSON dates serialized in the specified format. 0 = Timestamp with offset e.g. "\/Date(1346080140000+0500)\/". 2 = ISO8601 e.g. "2012-08-27T15:09:00.0000000+05:00". Applications may pass this parameter in the custom "X-DateFormat" custom HTTP header instead of this query parameter.

globalisation

(optional)

The authenticated user's globalisation preferences as received in response to the call to GET account/profile or in the custom "X-Globalisation" HTTP header returned in response to authenticated calls. Applications should pass this back to the server with every call, either in this parameter, or in the the custom "X-Globalisation" HTTP header if automatic conversion of values is required.

Request Content Type

application/json or application/xml

Response

Returns a list of strings containing locations/addresses for the specified coordinates.

Response Content Type

application/json, application/javascript (JSONP), application/xml or text/csv as requested

Request Examples

POST /geocoding/coordinates/AssetManagement?auth=a78581e7935349c39873812572cda216
POST /geocoding/coordinates/AssetManagement.xml?auth=a78581e7935349c39873812572cda216
POST /geocoding/coordinates/AssetManagement.json?auth=a78581e7935349c39873812572cda216

JSON body:

[{"Longitude":"8.25939751","Latitude":"49.9561119"}]

XML body:

<?xml version="1.0"?>
<ArrayOfCoordinate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<Coordinate Longitude="8.25939751" Latitude="49.9561119" />
</ArrayOfCoordinate>

Response Examples

JSON body:

[{"Adam-Opel-Straße, Hechtsheim, Mainz, 55129, Germany"}]

XML body:
<?xml version="1.0"?>
<ArrayOfString xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<string>Adam-Opel-Straße, Hechtsheim, Mainz, 55129, Germany</string>
</ArrayOfString>