Retrieve features

async AsyncCogniteClient.geospatial.retrieve_features(
feature_type_external_id: str,
external_id: str | list[str],
properties: dict[str, Any] | None = None,
) → FeatureList | Feature

Retrieve features.

Parameters:

  • feature_type_external_id (str) – No description.

  • external_id (str | list[str]) – External ID or list of external ids

  • properties (dict[str, Any] | None) – the output property selection

Returns:

Requested features or None if it does not exist.

Return type:

FeatureList | Feature

Examples

Retrieve one feature by its external id:

>>> from cognite.client import CogniteClient, AsyncCogniteClient
>>> client = CogniteClient()
>>> # async_client = AsyncCogniteClient()  # another option
>>> client.geospatial.retrieve_features(
...     feature_type_external_id="my_feature_type", external_id="my_feature"
... )