Write to a Space

Having created a new space, you can write to it. The following example adds a collection of features.

Request

Try in Swagger

POST /spaces/{spaceId}/features

The POST request requires a body like the following example:

{
    "type":"FeatureCollection",
    "features":
    [
      {
        "type":"Feature",
        "properties":
        {
          "name":"Baldy Mountain"
        },
        "geometry":
        {
          "type":"Point",
          "coordinates":[-100.728, 51.4686]
        }
      }
  ]
}

Response

The response is a FeatureCollection, containing all created features.

{
  "features": [
    {
      "geometry": {
        "type": "Point",
        "coordinates": [
          -100.728,
          51.4686
        ]
      },
      "id": "HsOsZ0FXUI",
      "type": "Feature",
      "properties": {
        "name": "Baldy Mountain",
        "@ns:com:here:xyz": {
          "createdAt": 1529855978032,
          "space": "{spaceId}",
          "tags": [
            "canada",
            "mountain"
          ],
          "updatedAt": 1529855978032
        }
      },
      "bbox": [
        -100.728,
        51.4686,
        -100.728,
        51.4686
      ]
    }
  ],
  "type": "FeatureCollection"
}

When you upload a feature to Data Hub, HERE automatically adds the property, @ns:com:here:xyz to it. The following information is recorded in this property:

  • createdAt - date and time the feature was created in milliseconds since 01.01.1970
  • updatedAt - date and time the feature was updated in milliseconds since 01.01.1970
  • space - random unique space ID, created at space creation, a string
  • tags - the tags you added to the space, an array of strings

Use the namespace to store the additional information in the object without interfering with the properties you provided.

results matching ""

    No results matching ""