Get features by ID
Requesting one feature
GET /<Base path for the interactive API from the API Lookup Service>/layers/{layerId}/features/{featureId}
Host: <Hostname for the interactive API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache
Note
You can alternatively use an API Key instead of an OAuth bearer token in an authorization header.
Response
{
"type": "Feature",
"id": "{featureId}",
"geometry":
{
"type": "Point",
"coordinates":
[
-2.960847,
53.430828
]
},
"properties":
{
"name": "Anfield",
"@ns:com:here:xyz":
{},
"amenity": "Football Stadium",
"capacity": 54074,
"popupContent": "Home of Liverpool Football Club"
}
}
Requesting multiple features
Note
Requesting multiple features will always return a FeatureCollection, even if the request returns only one or no feature.
If you want to get more than one feature, your request has to look like the following.
GET /<Base path for the interactive API from the API Lookup Service>/layers/{layerId}/features?id={featureId1},{featureId2},{featureId3}
Response
{
"type": "FeatureCollection",
"features":
[
{
"type": "Feature",
"geometry":
{
"type": "Point",
"coordinates":
[
-2.960847,
53.430828
]
},
"properties":
{
"@ns:com:here:xyz":
{},
"name": "Anfield",
"amenity": "Football Stadium",
"capacity": 54074,
"popupContent": "Home of Liverpool Football Club"
}
}
]
}
Note
Another way of requesting multiple ID is the following: ?id={featureId1},id={featureId2},id={featureId3}
Requesting features from version enabled interactive map layer
When using a version enabled interactive map layer, features can be requested by filtering using "version" and/or by "author" of a feature or feature collection.
GET /<Base path for the interactive API from the API Lookup Service>/layers/{layerId}/features/{featureId}?version={versionNumber}&author={author}
Host: <Hostname for the interactive API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache
Note
Multiple versions of the same feature can be loaded when the value asterisk ( * ) is used.
For example: /features?id=F1,F2&version= or /features/F1?version=
If the version is not included, then the response will return the latest state of the features.
Response
{
"type": "Feature",
"id": "{featureId}",
"geometry":
{
"type": "Point",
"coordinates":
[
-2.960847,
53.430828
]
},
"properties":
{
"@ns:com:here:xyz":
{
"createdAt": 1680007106932,
"updatedAt": 1680007106932,
"version": "{versionNumber}",
"author": "{author}"
},
"name": "Anfield",
"amenity": "Football Stadium",
"capacity": 54074,
"popupContent": "Home of Liverpool Football Club"
}
}