Asset-centric API, deprecated 2026-10-15 and retired 2027-12-31. Will be removed or moved in a future major release. See https://docs.cognite.com/cdf/deprecated and https://github.com/cognitedata/cognite-sdk-js/blob/master/guides/DEPRECATIONS.md.

Hierarchy

Methods

  • Aggregate features

    const aggregateParams = {
    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))' } }
    ]
    },
    property: 'temperature',
    aggregates: ['min', 'max', 'average'],
    groupBy: ['category']
    };

    const featureStream = await client.geospatial.feature.searchStream('ocean_temperature', aggregateParams);

    Parameters

    Returns Promise<unknown[]>

    Asset-centric API, deprecated 2026-10-15 and retired 2027-12-31. Will be removed or moved in a future major release.

  • Create features

    const featureTypeExternalId = 'ocean_temperature';
    const features = [
    { externalId: 'measurement_point_765', temperature: 5.65, location: { wkt: 'POINT(60.547602 -5.423433)' }},
    { externalId: 'measurement_point_863', temperature: 5.03, location: { wkt: 'POINT(60.585858 -6.474416)' }},
    ];
    const createdFeatures = await client.geospatial.feature.create(featureTypeExternalId, features);

    Parameters

    Returns Promise<GeospatialFeatureResponse[]>

    Asset-centric API, deprecated 2026-10-15 and retired 2027-12-31. Will be removed or moved in a future major release.

  • Update features

    const featuresToDelete = [{ externalId: 'measurement_point_765' }, { externalId: 'measurement_point_765' }];

    await client.geospatial.feature.delete('ocean_temperature', featuresToDelete);

    Parameters

    • featureTypeExternalId: string
    • externalIds: ExternalId[]

    Returns Promise<{}>

    Asset-centric API, deprecated 2026-10-15 and retired 2027-12-31. Will be removed or moved in a future major release.

  • Retrieve features

    const featuresToRetrieve = [{ externalId: 'measurement_point_765' }, { externalId: 'measurement_point_765' }];
    const outputParams = { output: { geometryFormat: 'GEOJSON' as const } };

    const retrievedFeatures = await client.geospatial.feature.retrieve('ocean_temperature', featuresToRetrieve, outputParams);

    Parameters

    Returns Promise<GeospatialFeatureResponse[]>

    Asset-centric API, deprecated 2026-10-15 and retired 2027-12-31. Will be removed or moved in a future major release.

  • Search 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);

    Parameters

    Returns Promise<GeospatialFeatureResponse[]>

    Asset-centric API, deprecated 2026-10-15 and retired 2027-12-31. Will be removed or moved in a future major release.

  • Search and stream 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,
    output: { jsonStreamFormat: 'NEW_LINE_DELIMITED' as const }
    };

    const featureStreamString = await client.geospatial.feature.searchStream('ocean_temperature', params);

    Parameters

    Returns Promise<string>

    Asset-centric API, deprecated 2026-10-15 and retired 2027-12-31. Will be removed or moved in a future major release.

  • Update features

    const featuresToUpdate = [
    { externalId: 'measurement_point_765', temperature: 5.65, location: { wkt: 'POINT(60.547602 -5.423433)' } },
    { externalId: 'measurement_point_863', temperature: 5.03, location: { wkt: 'POINT(60.585858 -6.474416)' } }
    ];

    const updatedFeatures = await client.geospatial.feature.update('ocean_temperature', featuresToUpdate);

    Parameters

    Returns Promise<GeospatialFeatureResponse[]>

    Asset-centric API, deprecated 2026-10-15 and retired 2027-12-31. Will be removed or moved in a future major release.