---
title: "GET /{lang}/places/autosuggest"
method: GET
path: "/{lang}/places/autosuggest"
tags: ["Objects list"]
---

# GET /{lang}/places/autosuggest

`GET /{lang}/places/autosuggest`

## Request

- Base URL: `https://api.opentripmap.com/0.1`
- URL: `https://api.opentripmap.com/0.1/{lang}/places/autosuggest`
- Auth: API key in query parameter `apikey`
- TypeScript: <https://skmtc.dev/opentripmap/apis/opentripmap-api/docs/:lang/places/autosuggest/get.ts> (a function with typed inputs; its response is checked against the schema)

Method returns suggestions for search term closest to the selected point optionally filtered by parameters. Only basic information is include in response: xid, name, kinds, osm, wikidata of each object. Depending on the chosen format, the response is either a simple array of objects (with a smaller volume) or an object in GeoJSON format.

## Path parameters

- `lang` string, required

## Query parameters

- `name` string, required
- `radius` number, double, required
- `lon` number, double, required
- `lat` number, double, required
- `src_geom` 'osm' | 'wikidata' | 'snow' | 'cultura.ru' | 'rosnedra'
- `src_attr` 'osm' | 'wikidata' | 'snow' | 'cultura.ru' | 'rosnedra' | 'user'
- `kinds` string
- `rate` '1' | '2' | '3' | '1h' | '2h' | '3h'
- `format` 'json' | 'geojson' | 'count'
- `props` 'base' | 'address'
- `limit` integer

## Response `200`

Returns a list of objects

- SimpleSuggestFeature[]
  - `xid` string, required: Unique identifier of the object in OpenTripMap
  - `name` string, required: The name of the object
  - `highlighted_name` string, required: The name of the object with highlighted search term
  - `kinds` string, required: Comma-separated list of categories. [see List of categories](https://dev.opentripmap.com/en/catalog.tree.json)
  - `osm` string: OpenStreetMap identifier of the object
  - `wikidata` string: Wikidata identifier of the object
  - `dist` number, double: Distance in meters from selected point (for radius query)
  - `point` object, required: Point location of the object
    - `lon` number, double: Longitude
    - `lat` number, double: Latitude

## Other responses

- `400`: Error in query parameters

---

[API](https://skmtc.dev/opentripmap/apis/opentripmap-api.md) - [All operations](https://skmtc.dev/opentripmap/apis/opentripmap-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opentripmap/apis/opentripmap-api/revisions/27aa081235f9?raw)
