Create a new or update an existing Location

Create a new Location. If a Location with the posted 'id' already exists then it will be overwritten.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

A Location describes a point with a known latitude and longitude (and, optionally, elevation above mean sea level).

The coordinates of the Location are specified using a GeoJSON Point object, which by convention lists coordinates in the order longitude, latitude then elevation.

For example, the following snippet defines a Location located at 42.903 degrees South, 147.327 degrees East, and 25 metres above mean sea level:

{
"id": "NewLocation",
"organisationid": "MyOrg",
"geoJson": {
"type": "Point",
"coordinates": [147.327, -42.903, 25.0]
}
}

If elevation is unknown, pass only two values (the longitude and latitude) in the coordinates property.

string
required
string
required
string
groupids
array of strings

A list of group identifiers for which this Location will be a member.

groupids
geoJson
object
required

A GeoJSON 'Point' describing the location's position.

Response
200

OK

Language
Credentials
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here!