---
title: "Get features with radius search"
method: GET
path: "/spaces/{spaceId}/spatial"
tags: ["Read Features"]
---

# Get features with radius search

`GET /spaces/{spaceId}/spatial`

List the features which are inside the specified radius.
The origin radius point is calculated based either on latitude & longitude or by
specifying a features geometry. As third option it is possible to use a H3 index
as input geometry.

## Path parameters

- `spaceId` string, required

## Query parameters

- `lat` number
- `lon` number
- `refSpaceId` string
- `refFeatureId` string
- `h3Index` string
- `radius` integer
- `limit` integer
- `clip` boolean
- `params` object
- `selection` string[]
- `skipCache` boolean
- `force2D` boolean
- `context` 'default' | 'extension' | 'super'
- `version` string
- `versionRef` string

## Response `200`

An array of features response.

## Other responses

- `400` — Malformed or Bad Request.
- `401` — Unauthorized to perform the request.
- `403` — Forbidden request. Insufficient rights to perform the request.
- `404` — Not found.
- `513` — Response payload too large.

## Changes

- **2024-09-11** `409ef8fb277a` — 1 warning, 1 info
  - deleted the `query` request parameter `version`
  - added the new optional `query` request parameter `versionRef`
- **2024-07-05** `fe81af2acfff` — 1 breaking, 1 warning, 1 info
  - for the `query` request parameter `params`, the type changed from `array` to `object`
  - deleted the `query` request parameter `version`
  - added the new optional `query` request parameter `version`
- **2024-04-02** `f57452d2db13` — 1 warning, 1 info
  - deleted the `query` request parameter `version`
  - added the new optional `query` request parameter `version`
- **2024-03-08** `4db340b28588` — 1 warning, 1 info
  - deleted the `query` request parameter `version`
  - added the new optional `query` request parameter `version`
- **2024-03-07** `bbe5afcae89e` — 1 info
  - added the new optional `query` request parameter `version`

[Full history](https://skmtc.dev/here/apis/here-xyz-hub/changes/spaces/:spaceId/spatial/get.md)

---

[API](https://skmtc.dev/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.dev/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/here/here-xyz-hub/revisions/1c6c6a2bcac9/schema)