API reference (20230101)
- Overview
- Overview
- POSTAggregate features
- POSTCompute
- POSTCreate Coordinate Reference Systems
- POSTCreate feature types
- POSTCreate features
- POSTDelete Coordinate Reference Systems
- POSTDelete feature types
- POSTDelete features
- POSTDelete a raster from a feature property
- POSTGet Coordinate Reference Systems
- GETGet features
- POSTList feature types
- PUTPut a raster into a feature property
- POSTRetrieve feature types
- POSTRetrieve features
- POSTSearch and stream features
- POSTSearch features
- POSTUpdate feature types
- POSTUpdate features
- POSTFilter all features
const params = {
filter: {
and: [
{ range:{ property: 'temperature', gt:4.54 } },
{ stWithin: { property:'location', value:'POLYGON((60.547602 -5.423433, 60.547602 -6.474416, 60.585858 -5.423433, 60.547602 -5.423433))' } }
]
},
limit: 100,
sort: [ 'temperature:ASC','location']
};
const searchedFeatures = await client.geospatial.feature.search('ocean_temperature', params);{
"items": [
{
"externalId": "measurement_point_765",
"temperature": 5.65,
"location": {
"wkt": "POINT(60.547602 -5.423433)"
},
"createdTime": 1629784673505,
"lastUpdatedTime": 1629784673505
},
{
"externalId": "measurement_point_863",
"temperature": 5.03,
"location": {
"wkt": "POINT(60.585858 -6.474416)"
},
"createdTime": 1629784673505,
"lastUpdatedTime": 1629784673505
}
]
}Search features
Required capabilities:
geospatialAcl:READ
Search for features based on the feature property filter passed in the body of the request. The result of the search is limited to a maximum of 1000 items. Results in excess of the limit are truncated. This means that the complete result set of the search cannot be retrieved with this method. However, for a given unmodified feature collection, the result of the search is deterministic and does not change over time.
const params = {
filter: {
and: [
{ range:{ property: 'temperature', gt:4.54 } },
{ stWithin: { property:'location', value:'POLYGON((60.547602 -5.423433, 60.547602 -6.474416, 60.585858 -5.423433, 60.547602 -5.423433))' } }
]
},
limit: 100,
sort: [ 'temperature:ASC','location']
};
const searchedFeatures = await client.geospatial.feature.search('ocean_temperature', params);{
"items": [
{
"externalId": "measurement_point_765",
"temperature": 5.65,
"location": {
"wkt": "POINT(60.547602 -5.423433)"
},
"createdTime": 1629784673505,
"lastUpdatedTime": 1629784673505
},
{
"externalId": "measurement_point_863",
"temperature": 5.03,
"location": {
"wkt": "POINT(60.585858 -6.474416)"
},
"createdTime": 1629784673505,
"lastUpdatedTime": 1629784673505
}
]
}Authorizations
Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.
Path Parameters
External Id of the feature type provided by client. Must be unique among all feature type external ids within a CDF project.
32^[A-Za-z][A-Za-z0-9_]{0,31}$"ocean_measures"
Body
Feature Search Request
Optional parameter indicating if input geometry properties should be transformed into the respective Coordinate Reference Systems defined in the feature type specification. If the parameter is true, then input geometries will be transformed when the input and output Coordinate Reference Systems differ. When it is false, then requests with geometries in Coordinate Reference System different from the ones defined in the feature type will result in bad request response code. Transformations apply to property geometries in case of create and update feature, as well as to geometries in spatial filters in search endpoints.
true
Optional parameter indicating if the spatial filter operators allow input geometries with a different dimensionality than the properties they are applied to. For instance, when set to true, if a feature type has a property of type POLYGONZM (4D), its features can be filtered using the stContains operator and a POLYGON (2D) value. This option defaults to false if not specified.
true
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
Show child attributes
Show child attributes
Limits the number of results to be returned.
1 <= x <= 1000Desired output specification.
Show child attributes
Show child attributes
{
"properties": {
"*": {},
"geometry1": { "srid": 4326 },
"geometry2": { "srid": 3857 }
}
}Sort result by selected fields. Syntax: sort:["field_1","field_2:ASC","field_3:DESC"]. Default sort order is ascending if not specified. Available sort direction: ASC, DESC, ASC_NULLS_FIRST, DESC_NULLS_FIRST, ASC_NULLS_LAST, DESC_NULLS_LAST.
Response
The feature search response.
1000Show child attributes
Show child attributes
Was this page helpful?