Create features

Creates features.

Parameters:

feature_type_external_id (str) – Feature type definition for the features to create.
feature (Feature | FeatureWrite | Sequence[Feature] | Sequence[FeatureWrite] | FeatureList | FeatureWriteList) – one feature or a list of features to create or a FeatureList object
allow_crs_transformation (bool) – If true, then input geometries will be transformed into the Coordinate Reference System defined in the feature type specification. When it is false, then requests with geometries in Coordinate Reference System different from the ones defined in the feature type will result in CogniteAPIError exception.
chunk_size (int | None) – maximum number of items in a single request to the api

Returns:

Created features

Return type:

Feature | FeatureList

Examples

Create a new feature type and corresponding feature:

>>> from cognite.client import CogniteClient
>>> from cognite.client.data_classes.geospatial import FeatureTypeWrite, FeatureWrite
>>> client = CogniteClient()
>>> # async_client = AsyncCogniteClient()  # another option
>>> feature_types = [
...     FeatureTypeWrite(
...         external_id="my_feature_type",
...         properties={
...             "location": {"type": "POINT", "srid": 4326},
...             "temperature": {"type": "DOUBLE"},
...         },
...     )
... ]
>>> res = client.geospatial.create_feature_types(feature_types)
>>> res = client.geospatial.create_features(
...     feature_type_external_id="my_feature_type",
...     feature=FeatureWrite(
...         external_id="my_feature", location={"wkt": "POINT(1 1)"}, temperature=12.4
...     ),
... )