Geofence point¶

All actions to retrieve and manipulate points of the geofence. Note that circle geofence type can't have points.

Point object structure¶

{
  "lat": 11.0,
  "lng": 22.0,
  "node": true
}

• lat - float. Point latitude.
• lng - float. Point latitude.
• node - boolean. Will be true if this point is a route node.

API actions¶

API base path: /zone/point.

list¶

Get points of user's geofence with zone_id.

Parameters¶

Examples¶

curl -X POST 'https://api.gdemoi.ru/v2/zone/point/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "zone_id": 1234567}'

https://api.gdemoi.ru/v2/zone/point/list?hash=a6aa75587e5c59c32d347da438505fc3&zone_id=1234567

Response¶

{
  "success": true,
  "list": [
    {
      "lat": 11.0,
      "lng": 22.0,
      "node": true
    }
  ]
}

• list - array of objects. List of point objects.

Errors¶

• 201 - Not found in the database – if geofence with the specified ID cannot be found or belongs to another user.
• 230 - Not supported for this entity type – if geofence cannot have any points associated with it (e.g. if geofence is circle).

update¶

Update points for user's geofence with zone_id.

required sub-user rights: zone_update.

Parameters¶

Example¶

curl -X POST 'https://api.gdemoi.ru/v2/zone/point/update' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "zone_id": 1234567, "points": [{"lat": 11.0, "lng": 22.0, "node": true},{"lat": 11.2, "lng": 22.2, "node": true},{"lat": 11.4, "lng": 22.4, "node": true}]}'

Response¶

{
  "success": true
}

Errors¶

• 201 - Not found in the database – if geofence with the specified ID cannot be found or belongs to another user.
• 202 - Too many points in a geofence – if "points" array size exceeds limit for this geofence type. Max allowed points count for a geofence is 500 for a polygon or 1024 for a sausage.
• 230 - Not supported for this entity type – if geofence cannot have any points associated with it (e.g., if geofence is circle).
• 284 - Not enough points for the zone. The minimum number of points for polygon: 3; the minimum for sausage: 2.