Что такое Overpass API?

OpenStreetMap — бесплатная карта мира, которую создают добровольцы. Помимо дорог и зданий, на ней есть миллионы магазинов, кафе, скамеек, дефибрилляторов и питьевых фонтанчиков. Каждый объект описан тегами, например amenity=cafe или shop=bakery. Overpass API — это сервис для поиска данных с доступом только для чтения: вы запрашиваете все объекты с определённым тегом в нужной области, а сервис возвращает подходящие места с названиями, адресами и часами работы.

Несколько групп поддерживают общедоступные серверы Overpass. Они используются всеми, поэтому в часы высокой нагрузки один сервер может работать медленно или отклонять запросы, пока другой отвечает сразу.

Описание инструмента

Переместите карту и измените масштаб, чтобы выбрать область поиска, а затем укажите, что нужно найти: категорию, например аптеки или общественные туалеты, пользовательский тег OSM или любые объекты по названию. Также можно уточнить поиск по категории, указав название, например найти супермаркеты, в названии которых есть Lidl. Нажмите «Искать в области карты», чтобы выполнить поиск в пределах области, видимой на карте. Кнопка под кнопками масштабирования перемещает карту к вашему местоположению.

Найденные места отображаются точками на карте и в таблице под настройками поиска. Для каждого места указаны название, тег и адрес. Нажмите на точку или строку таблицы, чтобы также увидеть часы работы и сайт места, а ещё ссылку для его открытия в OpenStreetMap. Таблицу можно сортировать по любому столбцу, а результаты — сохранять в формате CSV или JSON.

По умолчанию инструмент сам выбирает сервер: в Европе он обращается к серверу, который хранит только данные по Европе и часто менее загружен. В остальных случаях инструмент переключается на следующий сервер, если текущий занят, а также пробует следующий, если сервер отвечает медленно. Сервер можно выбрать и вручную. В строке состояния указано, какой сервер ответил и насколько свежа его копия данных карты.

Поиск выполняется напрямую из вашего браузера на сервер Overpass: сервер получает область и параметры поиска, а наш сервер в этом процессе не участвует.

Возможности

  • Поиск в видимой области карты OpenStreetMap; переход к вашему местоположению — одним нажатием
  • Повседневные категории, любые теги OSM и поиск по названию
  • Общедоступные серверы Overpass без API-ключа и автоматическое переключение на другой сервер, если текущий занят
  • Результаты на карте и рядом с ней — в сортируемой таблице с названиями, тегами и адресами
  • Всплывающие окна с часами работы, сайтом и ссылкой на место в OpenStreetMap
  • Экспорт результатов в формате CSV или JSON

Советы

  • Ищите в пределах города или района, а не целого региона: небольшие области обрабатываются быстрее и не превышают ограничения общедоступных серверов.
  • Чтобы найти пользовательский тег, поищите его ключ и значение в списке объектов карты на вики OpenStreetMap. Если указать только ключ, например wheelchair или opening_hours, поиск найдёт все объекты с этим ключом независимо от значения.
  • Поиск по названию не учитывает регистр и может находить совпадение в любой его части, поэтому запрос bank найдёт также «Swedbank» и «Bank of Ireland».
  • Если автоматический выбор сервера постоянно даёт сбой, возможно, все серверы одновременно заняты. Подождите минуту и повторите попытку или выберите сервер вручную.
  • Здесь нельзя найти места, которых нет в OpenStreetMap. Вы можете самостоятельно добавить отсутствующий магазин или скамейку на openstreetmap.org.