Sign in

v1

latestOpenAPI 3.0.02026-08-065741.5 KB
Objects list

Method returns objects closest to the selected point optionally filtered by parameters. Only basic information is include in response: xid, name, kinds, osm, wikidata and geometry 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.

get/{lang}/places/radius

Path parameters

langstring required

Language code (2 characters, ISO639-1). The following values are available: en (english), ru (russian)

Query parameters

radiusnumber double required

Maximum distance from selected point in meters

lonnumber double required

Longitude of selected point

latnumber double required

Latitude of selected point

src_geom'osm' | 'wikidata' | 'snow' | 'cultura.ru' | 'rosnedra'

The source of the object geometry. Objects from all sources are returned by default.

src_attr'osm' | 'wikidata' | 'snow' | 'cultura.ru' | 'rosnedra' | 'user'

The source of the object attributes. It is allowed to point multiple sources separated by commas. Objects from all sources are returned by default.

kindsstring

Object category. Several comma-separated categories may be stated with OR logic. see List of categories. Objects from interesting_places category are returned by default.

namestring

The text string on which to search at the begining of the object name (mimimum 3 characters). All objects are returned by default.

rate'1' | '2' | '3' | '1h' | '2h' | '3h'

Minimum rating of the object popularity, 1 - minimum, 3- maximum, h - object is referred to the cultural heritage. Objects from all ratings are returned by default.

format'json' | 'geojson' | 'count'

The output format (GeoJSON is set by default). Specify “count” to get the number of obtained objects

limitinteger

Maximum number of returned objects. 500 is set by default.

Response

Returns a list of objects

xidstring required

Unique identifier of the object in OpenTripMap

namestring required

The name of the object

kindsstring required

Comma-separated list of categories. see List of categories

osmstring

OpenStreetMap identifier of the object

wikidatastring

Wikidata identifier of the object

distnumber double

Distance in meters from selected point (for radius query)

Example response

[
  {
    "name": "Oakland City Hall",
    "osm": "relation/4682064",
    "xid": "R4682064",
    "wikidata": "Q932794",
    "kind": "architecture,other_buildings_and_structures,historic_architecture,interesting_places",
    "point": {
      "lon": -122.272705,
      "lat": 37.80513
    }
  }
]