Features Endpoint¶

The Features endpoint allows creating, updating, and deleting features in a specific layer. The HTTP methods POST, PUT, and DELETE are used for this purpose.

Request Structure¶

POST and PUT (Insert/Update Features)

For a POST or PUT request, the following body is used:

{
  "type": "EditFeatures",
  "crs": {
    "type": "name",
    "properties": {
      "name": "EPSG:4326"
    }
  },
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [10.0, 50.0]
      },
      "properties": {
        "field1": "value1",
        "field2": 123
      }
    }
  ]
}

type: (string) The type of request, in this case “EditFeatures”.
crs (optional): (object) The coordinate reference system used.
features: (array) A list of features to be added or updated.

DELETE (Delete Features)

For a DELETE request, the following body is used:
```
{
  "type": "EditFeatures",
  "crs": {
    "type": "name",
    "properties": {
      "name": "EPSG:4326"
    }
  },
  "objectIds": [1, 2, 3]
}
```
- type: (string) The type of request, in this case “EditFeatures”.
- crs (optional): (object) The coordinate reference system used.
- objectIds: (array) A list of object IDs to be deleted.

Response Structure¶

The response contains information about the success of the operation. The structure of the response is defined as follows:

{
  "succeeded": true,
  "statement": "INSERT", // INSERT,UPDATE,DELETE
  "count": 3
}

succeeded: (bool) Indicates whether the operation was successful.
statement: (string) The executed database statement.
count: (int) The number of affected features.