Add new object
Service version: 1
Last edit: 2019.09.18
On this page
- ▸ Purpose
- ▸ Request data
Purpose
This endpoint creates a new object.
Request data
HTTPS method: POST
URL format
For ease of viewing and identification:
- Required constants and parameters are shown in bold text.
- Optional parameters are shown in plain text.
https://baseURL/geofencing/versionNumber/objects/object?key=Your_API_Key&adminKey=Your_Admin_Key
curl command
curl -v -XPOST -H "Content-type: application/json" -d
'{
"name": "object_name",
"defaultProject": "project_id",
"properties": {
"key": "value"
...
}
}'
'https://baseURL/geofencing/versionNumber/objects/object?key=Your_API_Key&adminKey=Your_Admin_Key'
POST request body (JSON)
{
"name": "object_name",
"defaultProject": "project_id",
"properties": {
"key": "value"
...
}
}
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.
- If there is a default value that will be assumed when an optional parameter is not used, it is shown in the table.
- The order of request parameters is not important.
Required parameters | |
---|---|
Parameter | Description |
baseURL string |
The base URL for calling the API. Value: api.tomtom.com
|
versionNumber string |
Service version number. Value: 1
|
key string |
An API Key valid for the requested service. Value: Your valid API Key .
|
adminKey string |
An Admin key valid for the provided API Key. Value: Your valid Admin Key .
|
Optional parameters | |
This endpoint does not have any optional parameters. |
Response data
Response body
{
"name": "object_name",
"id": "object_id",
"defaultProject": "project_id",
"properties": {
"key": "value"
...
}
}
Response fields
The following table describes all of the fields that can appear in a response.
Primary fields | |
---|---|
Field | Description |
name string |
The name of the object. |
id string |
The UUID of the object. |
defaultProject string |
(Optional) The UUID of the object's default project. |
properties object |
(Optional) It is an object containing the user-defined properties of the fence. Its content varies between fences. |
HTTP response codes
Code | Meaning and possible causes |
---|---|
201 |
Created |
400 |
Bad request:
|
403 |
Forbidden:
|
Examples
Request URL
https://api.tomtom.com/geofencing/1/objects/object?key=Your_API_Key&adminKey=Your_Admin_Key
POST request body
{
"name": "Support car 1",
"defaultProject": "4dee65b0-bd0a-47fd-ad12-27231fd780fb",
"properties": {
"embeddedId": "EL 11111",
"maxSpeedKmh": 70,
"driver": "John Doe"
}
}
Response body (JSON)
{
"name": "Support car 1",
"id": "cfde72d8-4b9f-4f6d-83c8-87ae0465fd5d",
"defaultProject": "4dee65b0-bd0a-47fd-ad12-27231fd780fb",
"properties": {
"embeddedId": "EL 11111",
"maxSpeedKmh": 70,
"driver": "John Doe"
}
}