Sign in

v1

latestOpenAPI 3.0.02026-08-065741.5 KB
Objects list

Method returns all objects (or number of objects) in the given bounding box 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/bbox

Path parameters

langstring required

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

Query parameters

lon_minnumber double required

Minimum longitude

lon_maxnumber double required

Maximum longitude

lat_minnumber double required

Minimum latitude

lat_maxnumber double required

Maximum latitude

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

MMaximum 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
    }
  }
]