OpenTripMap Object properties API

openapi: 3.2.0
info:
  title: OpenTripMap Object properties API
  version: 0.0.1
  description: Object types are hierarchically structured.
servers:
- url: https://api.opentripmap.com/0.1
- url: http://api.opentripmap.com/0.1
tags:
- name: Object properties
paths:
  /{lang}/places/xid/{xid}:
    get:
      security:
      - ApiKeyAuth: []
      description: Returns detailed information about the object. Objects can contain different amount of information.
      operationId: getPlaceByXid
      tags:
      - Object properties
      parameters:
      - name: lang
        in: path
        required: true
        description: 'Two-letter language code (ISO639-1). The following values are available: en (english), ru (russian)'
        schema:
          type: string
      - name: xid
        in: path
        description: Unique identifier of the object in OpenTripMap
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Returns object properties
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Places'
        '404':
          description: Object is not found in OpenTripMap
      summary: Get place by xid
      x-summary-source: derived
components:
  schemas:
    Places:
      type: object
      required:
      - xid
      - name
      - kind
      - sources
      - otm
      - rate
      - point
      properties:
        xid:
          description: Unique identifier of the object in OpenTripMap
          type: string
        name:
          description: The name of the object
          type: string
        kinds:
          description: Comma-separated list of categories. [see List of categories](https://dev.opentripmap.com/en/catalog.tree.json)
          type: string
        osm:
          description: OpenStreetMap identifier of the object
          type: string
        wikidata:
          description: Wikidata identifier of the object
          type: string
        rate:
          description: Rating of the object popularity
          type: string
          enum:
          - '0'
          - '1'
          - '2'
          - '3'
          - 1h
          - 2h
          - 3h
        image:
          description: Image URL
          type: string
        preview:
          type: object
          description: Image thumbnail
          properties:
            source:
              type: string
              description: Image thumbnail URL
            width:
              type: integer
              description: Thumbnail width in pixels
            height:
              type: integer
              description: Thumbnail height in pixels
        wikipedia:
          description: Link to Wikipedia
          type: string
        wikipedia_extracts:
          type: object
          description: Extracts of the wikipedia page
          properties:
            title:
              type: string
              description: Page title in wikipedia
            text:
              type: string
              description: Plain-text extract
            html:
              type: string
              description: Limited HTML extract
        voyage:
          description: Link to WikiVoyage
          type: string
        url:
          description: Link to website
          type: string
        otm:
          type: string
          description: Link to object at opentripmap.com
        sources:
          type: object
          description: Sources of information on object
          properties:
            geometry:
              type: string
              enum:
              - osm
              - wikidata
              - snow
              - cultura.ru
              - rosnedra
              description: Source of object geometry
            attributes:
              type: array
              description: Sources of object attributes
              items:
                type: string
                enum:
                - osm
                - wikidata
                - snow
                - cultura.ru
                - rosnedra
                - user
        info:
          type: object
          description: Extended object information (for some object categories)
          properties:
            src:
              type: string
              format: int64
              description: Source ID
            src_id:
              type: integer
              format: int64
              description: Object identifier in the source
            descr:
              type: string
              description: Object description
        bbox:
          type: object
          description: Minimum bounding box for the object geometry
          properties:
            lon_min:
              type: number
              format: double
            lon_max:
              type: number
              format: double
            lat_min:
              type: number
              format: double
            lat_max:
              type: number
              format: double
        point:
          type: object
          description: Point geographic coordinates of the object
          properties:
            lon:
              description: Longitude
              type: number
              format: double
            lat:
              description: Latitude
              type: number
              format: double
      example:
        kinds: architecture,towers,interesting_places,bell_towers
        sources:
          geometry: osm
          attributes:
          - osm
          - user
          - wikidata
        bbox:
          lat_max: 59.857355
          lat_min: 59.857242
          lon_max: 38.366282
          lon_min: 38.366043
        point:
          lon: 38.366169
          lat: 59.857269
        osm: way/286786280
        otm: https://opentripmap.com/ru/card/W286786280
        xid: W286786280
        name: Bellfry
        wikipedia: https://ru.wikipedia.org/wiki/Колокольня_(Кирилло-Белозерский_монастырь)
        image: https://data.opentripmap.com/images/user/Kirillo-Belozersky Belltower.jpg/original.jpg
        wikidata: Q4228276
        rate: 3h
        info:
          descr: 'Колокольня построена во второй половине XVIII века. Это одно из самых высоких сооружений монастыря. Колокольня состоит из 4 глухих этажей, над которыми возвышается один открытый. В XVIII веке на колокольне было 26 колоколов, самый большойиз них весил около 20 тонн, получивший имя «Мотора». Его звон был слышен в радиусе 20 километров.К сожалению,  в настоящее время на колокольне нет колоколов: их начали снимать при Петре I, когда во время Северной войны четвёртая часть монастырских колоколов (общим весом около 6,5 тонн) пошла на пополнение снаряжения армии. А в годы  советской власти почти всё собрание монастырских звонов было уничтожено.  В 1930 – 1931 годах из монастыря было вывезено свыше 31 тонны колокольной бронзы.

            В 2006-2007 годахпроведены реставрационные работы. В настоящее время на 3–4 ярусах находится выставка «Колокольный мир», здесь экспонируютсямузейное собрание колоколов и механизм боевых часовна четвертом ярусе колокольни, а ярус звона в летний период открыт для посещения. На колокольне работает Web-камера, через которую можно полюбоваться видом на Соборную площадь в любое время дня и ночи.'
          image: 1 (1) (Large)
          img_width: 1620
          src: belozersk
          src_id: 13
          img_height: 1080
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: apikey