API поиска по карте

JSON-схема объекта карты

JSON-объект с информацией об объекте карты, возвращаемый в api поиска по карте содержит следующие параметры:

БАЗОВЫЕ ПОЛЯ

ПараметрОписание
id
число
Числовой идентификатор объекта карт
type
строка

Тип объекта карты:
node – отдельная точка на карте.
way – линия (или полигон, в зависимости от набора тегов и замкнутости линии).
relation – отношение, состоящее из одной или нескольких точек и/или одной или нескольких линий.

photo
строка

Ссылка на фотографию. Поле возвращается только при запросе информации о конкретном объекте карты и только в случае наличия фотографии.

ОПЦИОНАЛЬНЫЕ ПОЛЯ

Включение в ответ этих полей зависит от параметров запроса

ПараметрОписание
tags
объект
JSON-объект, в котором перечислены теги объекта в виде {"key":"value"}
coordinates
массив

Координаты объекта карты. Формат ответа зависит от типа объекта:
node – массив [широта, долгота].
way – массив, состоящий из координат точек, из которых состоит линия: [[ш, д], [ш, д], [ш, д]].

points
массив

Координаты отдельных точек, участвующих в отношении (type=relation). Формат аналогичен координатам линии: [[ш, д], [ш, д], [ш, д]]

line_points
массив

Массив с координатами линий, участвующих в отношении.
[[[ш1, д1], [ш1, д1], [ш1, д1]], [[ш2, д2], [ш2, д2], [ш2, д2]]]

nd
массив

Массив, в котором перечислены числовые идентификаторы точек, из которых состоит линия. Поле присутствует только у линий (type=way) и в случае, если в ответе возвращаются координаты (см параметр запроса out).

members
массив

Массив из объектов, описывающих участников отношения. Поле присутствует только у отношений (type=relation) и в случае, если в ответе возвращаются координаты (см параметр запроса out).

Объект участника содержит 3 параметра:
id – числовой идентификатор участника
type – тип участника (node, way, relation)
role – (строка) роль участника.

city
строка

Экспериментальное поле. Указывается город, в границах которого находится точка. Поле возвращается только в том случае, если точка находится внутри границ города и если известны координаты этой точки (см параметр запроса out)