Skip to content
getgeolens.com
GeoLens Docs

Get Collection Item Feature

GET
/collections/{dataset_id}/items/{feature_id}
 
curl --request GET \
  --url https://example.com/collections/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/items/1

OGC API Features single feature endpoint – returns a GeoJSON Feature.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

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

Query Parameters

Section titled “ Query Parameters ”
f
Any of:
string

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Successful Response

OGCSingleFeatureResponse

Single GeoJSON Feature response.

object
type
Type

GeoJSON object type.

string
default: Feature
Allowed value: Feature
id
required
Id

Feature identifier within the collection.

integer
geometry
required
Any of:
GeoJSONGeometry

A GeoJSON geometry object (RFC 7946).

object
type
required
Type
string
Allowed values: Point MultiPoint LineString MultiLineString Polygon MultiPolygon
coordinates
required
Coordinates
Array
properties
required
Any of:
object
key
additional properties
any
links
Links

Self-reference and related-resource links.

Array<object>
default:
OGCLink
object
href
required
Href

Target URL of the link.

string
rel
required
Rel

Link relation type per RFC 8288 (e.g. ‘self’, ‘next’, ‘prev’, ‘data’, ‘collection’).

string
type
required
Type

Media type of the linked resource (e.g. ‘application/json’, ‘application/geo+json’).

string
title
Any of:
string
Example 
{
  "type": "Feature",
  "geometry": {
    "type": "Point"
  },
  "links": []
}

202

Section titled “ 202 ”

Dataset table is cold and being rehydrated (multi-tenant); poll the job and retry.

Media type application/json
object
status
string
job_id
string
Example generated 
{
  "status": "example",
  "job_id": "example"
}

400

Section titled “ 400 ”

Bad request — invalid query parameters or payload

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

401

Section titled “ 401 ”

Unauthenticated — a credential was supplied and could not be resolved (expired, revoked, or malformed). Sending no credential at all is not an error on these operations; they answer anonymously with the public subset.

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

404

Section titled “ 404 ”

Not found

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

429

Section titled “ 429 ”

Too many requests — retry after the advertised interval

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

Headers

Section titled “ Headers ”
Retry-After
integer

Seconds until the request may be retried

500

Section titled “ 500 ”

Internal server error

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

503

Section titled “ 503 ”

Service unavailable — the database could not serve the request

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}
Privacy Apache 2.0 getgeolens.com