Read Features

Get features by ID

Returns all the features found for the provided list of IDs. The response is always a FeatureCollection, even if there are no features with the provided IDs.

get/spaces/{spaceId}/features

Path parameters

spaceIdstring required

The unique identifier of the space.

Query parameters

idstring[] required

A comma separated list of unique feature identifiers. These are the acceptable formats for this field:

  • id=value1,value2
  • id=value1,id=value2
selectionstring[]

A list of properties to be returned in the features result list. Multiple attributes can be specified by using comma(,).

Example: ?selection=p.name,p.capacity,p.color,rootpropertyname

  • !geometry : special value to omit geometries
force2Dboolean

If set to true the features in the response have only X's and Y's as coordinates.

context'default' | 'extension' | 'super'

The context where the operation will be performed on a composite space. If not specified, the operation occurs based on the extension rules. For additional information, see Space.extends.

Available context are:

ContextDescription
defaultThe default value if none is given. For composite spaces the operation occurs based on the extension rules. For normal spaces this is the only valid context.
extensionThe operation will be executed only in the extension and no operation will be performed in the extended space.
superOnly applicable for read-operations. The operation will be executed only in the space being extended (super space).
versionstring

The query parameter used to specify the version of a feature or feature collection to be loaded.

Multiple versions of the same feature can be loaded when the value star '*' is used. Example:

/features?id=F1,F2&version=* or /features/F1?version=*

versionRefstring

The query parameter used to specify the version reference pointing to a tag or a version with also the possibility to use the star '*' to load all versions or 'HEAD' to load the latest available version.

authorstring

Filter the results per author.

Response

An array of features response.

Changes