Get fence details
Decommission notice
Purpose
This endpoint requests all details for a single fence.
Request data
HTTPS method: GET
- Constants and parameters enclosed in curly brackets { } must be replaced with their values.
- Please see the following Request parameters section with the required and optional parameters tables for their values. The generic request format is as follows.
URL request format
https://{baseURL}/geofencing/{versionNumber}/fences/{fenceId}?key={Your_API_Key}curl command request format
curl 'https://{baseURL}/geofencing/{versionNumber}/fences/{fenceId}?key={Your_API_Key}'Request parameters
The following table describes the parameters that can be used in a request.
- Required parameters must be used or the call will fail.
- Optional parameters may be used.
- The order of request parameters is not important.
Required parameters | Description |
|---|---|
| The base URL for calling the API. |
| Service version number. |
| An API Key valid for the requested service. |
| The fence id to gather details for. |
Optional parameters | Description |
|---|---|
| If set to |
Response data
Response body
The following JSON code block demonstrates a successful response from the API server.
{ "name": "fence_name", "id": "fence_id", "type": "Feature", "geometry": { "radius": radius_in_meters, "type": "Point", "shapeType": "shape_type", "coordinates": ["longitude", "latitude"] }, "properties": { "key": "value" }}Response fields
The following data tables describe all of the fields that can appear in a response. Fields are listed by the response section they belong to and in the order that they appear in the response.
Primary fields | Description |
|---|---|
| Name of the fence. |
| In the current version it is always “Feature”. |
| An object that describes fence geometry. See the Custom fence shapes section. |
| (Optional) An object containing user-defined properties of the fence. It’s content varies between fences. |
Response codes
Code | Meaning & possible causes |
|---|---|
| OK |
| Not Found: Fence with the specified id does not exist. |
Example
Get fence details
URL request example
https://api.tomtom.com/geofencing/1/fences/a334029d-3003-43d6-adf8-de0b7e35b6cb?key={Your_API_Key}Response body example
{ "name": "Amsterdam Airport Schiphol", "id": "aaab6d78-1738-45bd-a78b-ff3a7ba839f3", "type": "Feature", "geometry": { "radius": 75, "type": "Point", "shapeType": "Circle", "coordinates": [-67.137343, 45.137451] }, "properties": { "type": "NO_FLY_ZONE", "lastUpdated": "2018-10-11T23:28:56.782Z" }}