---
title: "Search at location"
method: POST
path: "/v1/spatial/searchAtLocation"
tags: ["Spatial Analysis"]
---

# Search at location

`POST /v1/spatial/searchAtLocation`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/spatial/searchAtLocation`
- Auth: one of:
  - `bearerAuth` (a scheme the document does not define)
  - `ApiKeyAuth` (a scheme the document does not define)

Performs a spatial search on a table using geometry or address input, with optional buffer distance. Supports INTERSECTS, WITHIN, and CONTAINS query semantics and returns matching feature attributes (or all attributes using '*'). Supports attribute filters and pagination via limit/offset.

## Query parameters

- `sortBy` string
- `sortOrder` string
- `limit` integer
- `offset` integer

## Headers

- `X-Request-Id` string

## Request body

- SearchAtLocationRequest
  - `tableName` string, required: Name of the table containing spatial data used by the operation.
  - `location` Location
    - `format` 'wkt' | 'geojson' | 'lonlat' | 'address': Format of the location input. Allowed values: WKT, GEOJSON, LonLat, Address. Default value is WKT.
    - `value` string, required: Input geometry or address value. Geometry coordinates must use EPSG:4326 (longitude, latitude).
    - `country` string: Country for address input. Mandatory when format is Address.
  - `attributeFilter` string: Optional scalar attribute filter expression using logical operators (AND/OR/NOT) and comparison operators such as =, <>, <, <=, >, >=, IS NULL, LIKE, BETWEEN, and IN.
  - `spatialOperation` string: Type of spatial query. Allowed values: intersects, within, contains. Default value is "intersects".
  - `bufferDistance` string: Optional buffer around the input geometry (for example "100 m" or "1 km"). Supports positive values for all geometries; negative values are supported for polygon input to create inward buffers.
  - `attributes` string[], required: List of table attributes to include in the response. Use ["*"] to return all attributes.

## Response `200`

Successful retrieval of searchAtLocation operations

## Other responses

- `400`: Invalid request
- `401`: Unauthorized: Invalid token
- `403`: Forbidden
- `429`: Too many requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/precisely/apis/feature-api.md) · [All operations](https://skmtc.dev/precisely/apis/feature-api/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/feature-api/revisions/6dc26f89c0aa?raw)