Поиск по параметрам геообъекта в заданной прямоугольной области

Осуществляет поиск геообъектов по прямоугольной области, заданной левой верхней и нижней правой вершинами.

URL: http://catalog.api.2gis.ru/2.0/geo/search

Параметры запроса

Параметр Обязательное Тип Описание
key Да Строка

Уникальный ключ пользователя API.

Пример: 1234567890.

point1 Да Строка

Координаты левой верхней вершины прямоугольной области в формате lon,lat.

Допустимая разность координат point2 и point1 не более: для lon 0.06, для lat 0.04 (приблизительно 6.6 х 4.4 км.)

Примеры:

  • 82.921663,55.030195
point2 Да Строка

Координаты нижней правой вершины прямоугольной области в формате lon,lat.

Допустимая разность координат point2 и point1 не более: для lon 0.06, для lat 0.04 (приблизительно 6.6 х 4.4 км.)

Примеры:

  • 82.921663,55.030195
type Нет Строка

Фильтр по типу гео объекта, перечисляются через запятую. Допустимые значения:

  • adm_div - Административная единица
  • adm_div.city - Город
  • adm_div.district - Район
  • adm_div.division - Округ
  • adm_div.living_area - Жилмассив, микрорайон
  • adm_div.place - Место
  • adm_div.settlement - Населённый пункт
  • attraction - Достопримечательность
  • building - Здание
  • crossroad - Перекрёсток
  • foreign_city - Город из другого проекта
  • gate - Проход или проезд
  • parking - Парковка
  • poi - POI, Fake POI
  • road - Дорога
  • street - Улица
Примеры:
  • adm_div
  • adm_div.city,attraction
zoom_level Нет Число

Если заданный zoom_level больше или равен уровню зума региона, с которого начинается отображение 3D-тайлов (starting_3d_zoom), то поиск домов осуществляется по их 3D-проекции, а не по 2D-контуру.

page Нет Число Номер запрашиваемой страницы. Значение по умолчанию: 1.
page_size Нет Число

Количество результатов на запрашиваемой странице. По умолчанию %default%.

Примеры:

  • 100

locale Нет Строка Локаль на которой отдавать результат. Возможные значения:
  • cs_CZ
  • en_CY
  • es_CL
  • it_IT
  • ru_RU
  • ru_KZ
  • ru_UA
  • en_AE
  • ar_AE
  • ru_KG
  • uk_UA
По умолчанию используется ru_RU.
sort Нет Строка

Допустимые значения:

  • relevance — по убыванию релевантности
  • rating — по убыванию рейтинга
format Нет Строка Формат ответа. Может принимать значения:
  • xml
  • json
  • jsonp
По умолчанию используется json.
callback Нет Строка

Название callback функции для jsonp-запроса. Ограничение: последовательность латинских букв, цифр и знака подчеркивания. Максимальная длина названия callback функции — 128 символов. В случае неправильного задания отобразится ошибка в формате json.

Пример: myCallback

fields Нет Строка

Дополнительные поля, которые необходимо отобразить в ответе, перечисляются через запятую. Допустимые значения:

  • items.geometry.selection
  • items.adm_div
  • items.address
  • items.floors
  • items.attraction
  • items.statistics
  • items.level_count
  • items.capacity
  • items.description
  • items.context
  • items.access_name
  • items.is_paid
  • items.access
  • items.access_comment
  • items.schedule

Параметры ответа

Параметр Тип Описание
meta* Структура

Общая информация об ответе

result* Структура

Основной результат

Общая информация об ответе (meta)
Параметр Тип Описание
code* Целое число

Код ответа API. Подробнее см. Коды ответов

Основной результат (result)
Параметр Тип Описание
total* Целое число

Количество найденных объектов

items* Массив любой из структур

Гео объект типа административная единица

Гео объект типа здание

Гео объект типа улица

Гео объект типа достопримечательность

Гео объект типа перекресток

Гео объект типа парковка

Гео объект типа дорога

Гео объект типа проход/проезд

Гео объект типа poi

Гео объект типа административная единица (items)
Параметр Тип Описание
id* Строка

Уникальный идентификатор гео объекта.

Примеры:

  • 141806935212033

type* Строка

Допустимые значения:

  • adm_div

subtype* Строка

Подтип административной единицы.

Допустимые значения:

  • city — город
  • settlement — населенный пункт
  • division — округ
  • district — район
  • living_area — жилмассив, микрорайон
  • place — место

subtype_specification Строка

Локализованное название типа населенного пункта (только для subtype = settlement)

name* Строка

Название территории.

full_name* Строка

Полное название территории.

adm_div Массив структур

Принадлежность к административной территории

Входит в ответ, если указать items.adm_div в fields.

attraction Структура | Null

Описание достопримечательности

Входит в ответ, если указать items.attraction в fields.

geometry Структура

Геометрия территории

statistics Структура | Null

Сводная информация об административной единице

Входит в ответ, если указать items.statistics в fields.

Принадлежность к административной территории (items.adm_div)
Параметр Тип Описание
id* Строка

Идентификатор объекта административной единицы.

type* Строка

Идентификатор объекта административной единицы.

Допустимые значения:

  • city — город
  • settlement — населённый пункт
  • division — округ
  • district — район
  • living_area — жилмассив, микрорайон
  • place — место

name* Строка

Имя объекта

Примеры:

  • Усть-Каменогорск

Описание достопримечательности (items.attraction)
Параметр Тип Описание
id Строка

Уникальный идентификатор объекта достопримечательности

Примеры:

  • 141806935212033

subtype_name* Строка

Локализованное название типа достопримечательности

name Строка

Название достопримечательности

description Строка

Описание достопримечательности

dates Строка

Дата или даты

authors Строка

Авторы

Геометрия территории (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Сводная информация об административной единице (items.statistics)
Параметр Тип Описание
area Число

Площадь объекта, км2.

length Число

Длина объекта, км

building_count Целое число

Количество домов, относящихся к объекту.

Гео объект типа здание (items)
Параметр Тип Описание
id* Строка

Уникальный идентификатор гео объекта

Примеры:

  • 141806935212033

type* Строка

Допустимые значения:

  • building

name* Строка

Название дома

full_name* Строка

Полное название дома

building_name Строка

Собственное имя здания

purpose_name* Строка

Описание назначения здания

adm_div Массив структур

Принадлежность к административной территории

Входит в ответ, если указать items.adm_div в fields.

address Структура | Null

Адрес дома

Входит в ответ, если указать items.address в fields.

address_name Строка

Представление поля address в виде одной строки

full_address_name Строка

Тоже что и address_name, но с указанием города.

Примеры:

  • Новосибирск, Димитрова проспект, 7

floors Структура | Null

Количество этажей

Входит в ответ, если указать items.floors в fields.

floor_plans Структура

Информация об этажах здания

attraction Структура | Null

Описание достопримечательности

Входит в ответ, если указать items.attraction в fields.

geometry Структура

Геометрия здания

allowed_for_reviews_count Целое число

Количество организаций в здании, на которые можно написать отзыв на flamp.ru

context Структура | Null

Динамические свойства здания

Входит в ответ, если указать items.context в fields.

structure_info Структура

Информация о структуре здания

Принадлежность к административной территории (items.adm_div)
Параметр Тип Описание
id* Строка

Идентификатор объекта административной единицы.

type* Строка

Идентификатор объекта административной единицы.

Допустимые значения:

  • city — город
  • settlement — населённый пункт
  • division — округ
  • district — район
  • living_area — жилмассив, микрорайон
  • place — место

name* Строка

Имя объекта

Примеры:

  • Усть-Каменогорск

Адрес дома (items.address)
Параметр Тип Описание
building_id Строка

Уникальный идентификатор дома к которому относится данный адрес.

Примеры:

  • 20498230958

building_name Строка

Название здания (в адресе для филиалов).

Примеры:

  • Сан Сити

postcode Строка

Почтовый индекс.

Минимальная длина: 4

Максимальная длина: 12

Примеры:

  • 630007

components Массив любой из структур

Типичный адрес

Только номер дома

Универсальное описание

Типичный адрес (items.address.components)
Параметр Тип Описание
id Строка

Идентификатор компонента адреса.

type* Строка

Допустимые значения:

  • street_number

street* Строка

Название улицы.

Примеры:

  • Ленина
  • Красный проспект

street_id Строка

Идентификатор геометрии улицы.

number* Строка

Номер дома, включая дроби, корпуса и буквенные обозначения.

Примеры:

  • 46
  • 21/2 корп. 7

Только номер дома (items.address.components)
Параметр Тип Описание
id Строка

Идентификатор компонента адреса.

type* Строка

Допустимые значения:

  • number

number* Строка

Номер дома, включая дроби и буквенные обозначения. Возможно, имя собственное, если так принято.

Примеры:

  • 213
  • Почтамт

Универсальное описание (items.address.components)
Параметр Тип Описание
id Строка

Идентификатор компонента адреса.

type* Строка

Допустимые значения:

  • location

comment* Строка

Словесное описание местоположения строения.

Количество этажей (items.floors)
Параметр Тип Описание
ground_min_count Целое число

ground_count* Целое число

underground_count Целое число

Информация об этажах здания (items.floor_plans)
Параметр Тип Описание
default_plan_id Строка

Идентификатор этажа по умолчанию для отображения на карте при показе этажей здания

plans Массив структур

Массив этажей здания. Сортировка: от нижних этажей к верхним

Массив этажей здания. Сортировка: от нижних этажей к верхним (items.floor_plans.plans)
Параметр Тип Описание
id* Строка

Уникальный идентификатор этажа

name* Строка

Название этажа для отображения в контроле переключения этажей

Описание достопримечательности (items.attraction)
Параметр Тип Описание
id Строка

Уникальный идентификатор объекта достопримечательности

Примеры:

  • 141806935212033

subtype_name* Строка

Локализованное название типа достопримечательности

name Строка

Название достопримечательности

description Строка

Описание достопримечательности

dates Строка

Дата или даты

authors Строка

Авторы

Геометрия здания (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Динамические свойства здания (items.context)
Параметр Тип Описание
distance Целое число

Дистанция

Информация о структуре здания (items.structure_info)
Параметр Тип Описание
material Строка | Null

Обозначение материала здания

Доступ ограничен. Для получения разрешений обратитесь в поддержку.

Входит в ответ, если указать items.structure_info.material в fields.

apartments_count Целое число | Null

Количество квартир в жилом доме

Доступ ограничен. Для получения разрешений обратитесь в поддержку.

Входит в ответ, если указать items.structure_info.apartments_count в fields.

porch_count Целое число | Null

Количество подъездов в жилом доме

Доступ ограничен. Для получения разрешений обратитесь в поддержку.

Входит в ответ, если указать items.structure_info.porch_count в fields.

Гео объект типа улица (items)
Параметр Тип Описание
id* Строка

Уникальный идентификатор гео объекта

Примеры:

  • 141806935212033

type* Строка

Допустимые значения:

  • street

name* Строка

Название улицы

full_name* Строка

Полное название улицы

adm_div Массив структур

Принадлежность к административной территории

Входит в ответ, если указать items.adm_div в fields.

attraction Структура | Null

Описание достопримечательности

Входит в ответ, если указать items.attraction в fields.

geometry Структура

Геометрия улицы

statistics Структура | Null

Сводная информация об улице

Входит в ответ, если указать items.statistics в fields.

Принадлежность к административной территории (items.adm_div)
Параметр Тип Описание
id* Строка

Идентификатор объекта административной единицы.

type* Строка

Идентификатор объекта административной единицы.

Допустимые значения:

  • city — город
  • settlement — населённый пункт
  • division — округ
  • district — район
  • living_area — жилмассив, микрорайон
  • place — место

name* Строка

Имя объекта

Примеры:

  • Усть-Каменогорск

Описание достопримечательности (items.attraction)
Параметр Тип Описание
id Строка

Уникальный идентификатор объекта достопримечательности

Примеры:

  • 141806935212033

subtype_name* Строка

Локализованное название типа достопримечательности

name Строка

Название достопримечательности

description Строка

Описание достопримечательности

dates Строка

Дата или даты

authors Строка

Авторы

Геометрия улицы (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Сводная информация об улице (items.statistics)
Параметр Тип Описание
area Число

Площадь объекта, км2.

length Число

Длина объекта, км

building_count Целое число

Количество домов, относящихся к объекту.

Гео объект типа достопримечательность (items)
Параметр Тип Описание
id* Строка

Уникальный идентификатор гео объекта

Примеры:

  • 141806935212033

type* Строка

Допустимые значения:

  • attraction

adm_div Массив структур

Принадлежность к административной территории

Входит в ответ, если указать items.adm_div в fields.

subtype_name* Строка

Локализованное название типа достопримечательности

name Строка

Название достопримечательности

full_name* Строка

Полное название достопримечательности

description Строка | Null

Описание достопримечательности

Входит в ответ, если указать items.description в fields.

dates Строка

Дата или даты

authors Строка

Авторы

geometry Структура

Геометрия достопримечательности

context Структура | Null

Динамическая информация

Входит в ответ, если указать items.context в fields.

Принадлежность к административной территории (items.adm_div)
Параметр Тип Описание
id* Строка

Идентификатор объекта административной единицы.

type* Строка

Идентификатор объекта административной единицы.

Допустимые значения:

  • city — город
  • settlement — населённый пункт
  • division — округ
  • district — район
  • living_area — жилмассив, микрорайон
  • place — место

name* Строка

Имя объекта

Примеры:

  • Усть-Каменогорск

Геометрия достопримечательности (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Динамическая информация (items.context)
Параметр Тип Описание
distance Целое число

Гео объект типа перекресток (items)
Параметр Тип Описание
id Строка

Уникальный идентификатор гео объекта

Примеры:

  • 141806935212033

type* Строка

Допустимые значения:

  • crossroad

name* Строка

Название перекрестка

full_name* Строка

Полное название перекрестка

adm_div Массив структур

Принадлежность к административной территории

Входит в ответ, если указать items.adm_div в fields.

attraction Структура | Null

Описание достопримечательности

Входит в ответ, если указать items.attraction в fields.

geometry Структура

Геометрия перекрёстка

Принадлежность к административной территории (items.adm_div)
Параметр Тип Описание
id* Строка

Идентификатор объекта административной единицы.

type* Строка

Идентификатор объекта административной единицы.

Допустимые значения:

  • city — город
  • settlement — населённый пункт
  • division — округ
  • district — район
  • living_area — жилмассив, микрорайон
  • place — место

name* Строка

Имя объекта

Примеры:

  • Усть-Каменогорск

Описание достопримечательности (items.attraction)
Параметр Тип Описание
id Строка

Уникальный идентификатор объекта достопримечательности

Примеры:

  • 141806935212033

subtype_name* Строка

Локализованное название типа достопримечательности

name Строка

Название достопримечательности

description Строка

Описание достопримечательности

dates Строка

Дата или даты

authors Строка

Авторы

Геометрия перекрёстка (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Гео объект типа парковка (items)
Параметр Тип Описание
id* Строка

Уникальный идентификатор гео объекта.

Примеры:

  • 141806935212033

type* Строка

Допустимые значения:

  • parking

subtype* Строка

Тип парковки

Допустимые значения:

  • ground — наземная
  • underground — подземная
  • multilevel — многоуровневая

name Строка

Собственное название парковки.

full_name Строка

Полное название парковки.

adm_div Массив структур

Принадлежность к административной территории

Входит в ответ, если указать items.adm_div в fields.

address Структура | Null

Адрес здания, в котором находится парковка

Входит в ответ, если указать items.address в fields.

address_name* Строка

Представление поля address в виде одной строки.

full_address_name Строка

Тоже что и address_name, но с указанием города.

Примеры:

  • Новосибирск, Димитрова проспект, 7

level_count Целое число | Null

Количество уровней парковки.

Входит в ответ, если указать items.level_count в fields.

is_paid Булев

Является ли парковка платной.

Входит в ответ, если указать items.is_paid в fields.

is_incentive* Булев

Является ли парковка перехватывающей.

access Строка

Тип доступа.

Входит в ответ, если указать items.access в fields.

Допустимые значения:

  • public — общедоступная
  • handicapped_only — только для инвалидов
  • customers_only — только для клиентов

access_name Строка

Локализованное название для access.

Входит в ответ, если указать items.access_name в fields.

access_comment Строка | Null

Комментарий про платность, про дополнительные ограничения и пр.

Входит в ответ, если указать items.access_comment в fields.

schedule Структура | Null

Расписание работы парковки

Входит в ответ, если указать items.schedule в fields.

capacity Структура | Null

Вместимость парковки

Входит в ответ, если указать items.capacity в fields.

purpose* Строка

Назначение парковки.

geometry Структура

Геометрия парковки

Принадлежность к административной территории (items.adm_div)
Параметр Тип Описание
id* Строка

Идентификатор объекта административной единицы.

type* Строка

Идентификатор объекта административной единицы.

Допустимые значения:

  • city — город
  • settlement — населённый пункт
  • division — округ
  • district — район
  • living_area — жилмассив, микрорайон
  • place — место

name* Строка

Имя объекта

Примеры:

  • Усть-Каменогорск

Адрес здания, в котором находится парковка (items.address)
Параметр Тип Описание
building_id Строка

Уникальный идентификатор дома к которому относится данный адрес.

Примеры:

  • 20498230958

building_name Строка

Название здания (в адресе для филиалов).

Примеры:

  • Сан Сити

postcode Строка

Почтовый индекс.

Минимальная длина: 4

Максимальная длина: 12

Примеры:

  • 630007

components Массив любой из структур

Типичный адрес

Только номер дома

Универсальное описание

Типичный адрес (items.address.components)
Параметр Тип Описание
id Строка

Идентификатор компонента адреса.

type* Строка

Допустимые значения:

  • street_number

street* Строка

Название улицы.

Примеры:

  • Ленина
  • Красный проспект

street_id Строка

Идентификатор геометрии улицы.

number* Строка

Номер дома, включая дроби, корпуса и буквенные обозначения.

Примеры:

  • 46
  • 21/2 корп. 7

Только номер дома (items.address.components)
Параметр Тип Описание
id Строка

Идентификатор компонента адреса.

type* Строка

Допустимые значения:

  • number

number* Строка

Номер дома, включая дроби и буквенные обозначения. Возможно, имя собственное, если так принято.

Примеры:

  • 213
  • Почтамт

Универсальное описание (items.address.components)
Параметр Тип Описание
id Строка

Идентификатор компонента адреса.

type* Строка

Допустимые значения:

  • location

comment* Строка

Словесное описание местоположения строения.

Расписание работы парковки (items.schedule)
Параметр Тип Описание
Mon Структура

Понедельник

Tue Структура

Вторник

Wed Структура

Среда

Thu Структура

Четверг

Fri Структура

Пятница

Sat Структура

Суббота

Sun Структура

Воскресенье

is_24x7 Булев

Признак того, что организация работает круглосуточно 7 дней в неделю.

comment Строка

Комментарий.

Примеры:

  • Кругосуточно в праздничные дни

Вместимость парковки (items.capacity)
Параметр Тип Описание
special_spaces Массив структур

Описание особых мест для парковки

total Целое число | Строка | Null

Описание особых мест для парковки (items.capacity.special_spaces)
Параметр Тип Описание
type* Строка

Описание особых мест для парковки

Допустимые значения:

  • bicycle — для велосипедов
  • motorbike — для мотоциклов
  • family — для семей
  • handicapped — для инвалидов

name* Строка

Локализованное название особого места.

count Целое число | Строка

Количество мест такого типа на парковке.

Геометрия парковки (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Гео объект типа дорога (items)
Параметр Тип Описание
id* Строка

type* Строка

Допустимые значения:

  • road

name* Строка

Собственное название дороги

full_name* Строка

Полное название дороги

geometry Структура

Геометрия дороги

statistics Структура | Null

Сводная информация о дороге

Входит в ответ, если указать items.statistics в fields.

Геометрия дороги (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Сводная информация о дороге (items.statistics)
Параметр Тип Описание
area Число

Площадь объекта, км2.

length Число

Длина объекта, км

building_count Целое число

Количество домов, относящихся к объекту.

Гео объект типа проход/проезд (items)
Параметр Тип Описание
id* Строка

Уникальный идентификатор гео объекта

Примеры:

  • 141806935212033

type* Строка

Допустимые значения:

  • gate

adm_div Массив структур

Принадлежность к административной территории

Входит в ответ, если указать items.adm_div в fields.

name* Строка

Описание прохода или проезда

full_name* Строка

Полное название прохода или проезда

geometry Структура

Геометрия прохода или проезда

purpose* Строка

Тип прохода или проезда

Допустимые значения:

  • main — основной
  • additional — дополнительный
  • service — служебный

access Строка

Доступность

Входит в ответ, если указать items.access в fields.

Допустимые значения:

  • public — общедоступный
  • paid — платный
  • restricted — для служебного пользования

access_name Строка | Null

Локализованное название типа доступа

Входит в ответ, если указать items.access_name в fields.

access_comment Строка | Null

Комментарий к доступности. Например, для платного проезда может быть указана стоимость

Входит в ответ, если указать items.access_comment в fields.

barrier Строка

Тип заграждения

Допустимые значения:

  • gate — ворота
  • gate_barrier — шлагбаум
  • turnstile — турникет
  • wicket — калитка

Принадлежность к административной территории (items.adm_div)
Параметр Тип Описание
id* Строка

Идентификатор объекта административной единицы.

type* Строка

Идентификатор объекта административной единицы.

Допустимые значения:

  • city — город
  • settlement — населённый пункт
  • division — округ
  • district — район
  • living_area — жилмассив, микрорайон
  • place — место

name* Строка

Имя объекта

Примеры:

  • Усть-Каменогорск

Геометрия прохода или проезда (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Гео объект типа poi (items)
Параметр Тип Описание
id* Строка

Уникальный идентификатор гео объекта.

Примеры:

  • 141806935212033

type* Строка

Допустимые значения:

  • poi

geometry Структура

Геометрии гео объекта

reference* Структура

Связанный объект с гео объектом

Геометрии гео объекта (items.geometry)
Параметр Тип Описание
selection Строка

Геометрия для выделения объекта.

Входит в ответ, если указать items.geometry.selection в fields.

Примеры:

  • POINT(83.306820839303 54.6230101954005)

Связанный объект с гео объектом (items.reference)
Параметр Тип Описание
id* Строка

Идентификатор связанного объекта.

Примеры:

  • 141806935212033

type* Строка

Тип связанного объекта.

Примеры:

  • branch
  • building
  • station_entrance

subtype Строка

Подтип связанного объекта

Примеры:

  • metro
  • stop

name* Строка

Имя связанного объекта.

Примеры:

  • Толмачёво, аэропорт, Международные воздушные линии

День недели (items.schedule.Mon|Tue|Wed|Thu|Fri|Sat|Sun)
Параметр Тип Описание
working_hours* Массив структур

Интервалы времени работы

Интервалы времени работы (items.schedule.Mon.working_hours)
Параметр Тип Описание
from* Строка

Значение в формате hh:mm

to* Строка

Значение в формате hh:mm

Примеры

  • Найти все геообъекты в прямоугольнике с левой верхней точкой с долготой 82.91, широтой 55.12 и правой нижней точкой с долготой 82.911, широтой 55.11. Показать только первый найденный геообъект.

    Запрос:

    http://catalog.api.2gis.ru/2.0/geo/search?point1=82.91,55.12&point2=82.911,55.11&page_size=1&key=1234567890

    Ответ:

  • Примеры ответов для разных типов геообъектов см. на странице метода "Получение информации о геообъекте".
  • Больше примеров хороших и разных можно найти в демо-версии.