↑ Все API

API: станции метро

Справочник станций метро в Москве, Санкт-Петербурге и других городах России.

Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.

Полнотекстовый поиск (`suggest`)

Пример запроса:

Песочница

{ "query": "алек" }

cURL

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "алек" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/metro

JavaScript

var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/metro";
var token = "${API_KEY}";
var query = "алек";

var options = {
    method: "POST",
    mode: "cors",
    headers: {
        "Content-Type": "application/json",
        "Accept": "application/json",
        "Authorization": "Token " + token
    },
    body: JSON.stringify({query: query})
}

fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));

PHP

// https://github.com/hflabs/dadata-php

$token = "${API_KEY}";
$dadata = new \Dadata\DadataClient($token, null);
$result = $dadata->suggest("metro", "алек");

Python

# https://github.com/hflabs/dadata-py

from dadata import Dadata
token = "${API_KEY}"
dadata = Dadata(token)
result = dadata.suggest("metro", "алек")

Поиск работает по полям:

name
city

Фильтрация

Фильтрация работает по полям city_kladr_id, city_fias_id, city, line_id и is_closed.

Поиск среди станций Санкт-Петербурга:

{
    "query": "алек",
    "filters": [
        {
            "city_kladr_id": "7800000000000"
        }
    ]
}

Поиск среди открытых станций Кольцевой ветки Москвы:

{
    "query": "па",
    "filters": [
        {
            "city": "Москва",
            "line_id": "5",
            "is_closed": false
        }
    ]
}

Поля справочника

Название	Описание
value	Значение одной строкой (как показывается в списке подсказок)
data.city_kladr_id	КЛАДР-код города
data.city_fias_id	ФИАС-код города
data.city	Название города
data.name	Название станции
data.line_id	Номер линии
data.line_name	Название линии
data.geo_lat	Координаты: широта
data.geo_lon	Координаты: долгота
data.color	Цвет линии в RGB
data.is_closed	Признак «закрыта» (`true`, если станция закрыта, `false` — если открыта).

Источник данных: Метрополитены России

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 30 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.