Skip to content
getgeolens.com
GeoLens DocsEarly release

List Related Datasets

GET
/datasets/{dataset_id}/related/
 
curl --request GET \
  --url https://example.com/api/datasets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/related/ \
  --header 'Authorization: Bearer <token>'

Return top-5 datasets similar to this one by embedding cosine similarity.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
dataset_id
required
Dataset Id
string format: uuid

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
RelatedDatasetsResponse
object
items
required
Items
Array<object>
RelatedDatasetItem
object
id
required
Id
string
name
required
Name
string
geometry_type
required
Any of:
string
similarity
required
Similarity

Cosine similarity score (0-1)

number
record_type
Any of:
string
feature_count
Any of:
integer
band_count
Any of:
integer
total
required
Total
integer
Example generated
{
  "items": [
    {
      "id": "example",
      "name": "example",
      "geometry_type": "example",
      "similarity": 1,
      "record_type": "example",
      "feature_count": 1,
      "band_count": 1
    }
  ],
  "total": 1
}

400

Section titled “400 ”

Bad request — invalid payload

401

Section titled “401 ”

Unauthorized — missing or invalid credentials

403

Section titled “403 ”

Forbidden — caller lacks write access

404

Section titled “404 ”

Not found

409

Section titled “409 ”

Conflict — resource state prevents the operation

422

Section titled “422 ”

Validation error

500

Section titled “500 ”

Internal server error