⛽ ГдеТопливо — карта наличия топлива на АЗС России
Каталог десятков тысяч АЗС России; наличие и цены возвращаются только там, где есть свежие отметки. API всегда сохраняет возраст и покрытие данных, поэтому отсутствие подтверждения нельзя перепутать со статусом «топливо есть».
Публичный API (GET /api/stations, GET /api/clusters) уже используется картой на главной странице —
он же доступен внешним клиентам. Для пилотных партнёров выдаётся API-ключ: он снимает
анонимные ограничения и даёт собственный лимит запросов в минуту, привязанный к вашему клиенту.
| Сегмент | Зачем |
|---|---|
| Логистика и перевозки | Пилотное планирование маршрута по свежим подтверждениям с обязательной проверкой покрытия и возраста данных |
| Страховые | Оценка риска простоя/задержки в регионах с подтверждённым дефицитом |
| Региональные администрации | Собственная витрина данных без разработки своего сборщика отметок с нуля |
| СМИ и аналитики | Проверяемые срезы только для городов с достаточным покрытием — см. открытый рейтинг дефицита по городам; ссылка на источник и дату среза обязательна для корректной интерпретации |
| Уровень | Кому подходит | Что входит |
|---|---|---|
| Базовый бесплатно |
Тесты, разовые интеграции, некоммерческое использование | Публичный API без ключа — уже доступен всем, тот же GET /api/stations/GET /api/clusters, что использует карта на сайте, с общим анонимным лимитом запросов |
| Бизнес по договорённости |
Логистика, такси, агрегаторы, страховые — регулярная нагрузка | Именной API-ключ (X-Api-Key), расширенная квота запросов в минуту под ваш трафик, SLA на доступность |
| Агрегированная история по договорённости |
СМИ и аналитики — активность смен статуса по дням | GET /api/data/regions-history возвращает число событий смены статуса по городам и дням. Это журнал активности, а не ежедневный snapshot наличия или доли дефицита; доступен ключам с отдельным разрешением |
| Партнёрство для сетей АЗС по договорённости |
Сети АЗС, готовые подтвердить свои данные | Верификация данных станций сети и бейдж «✓ Партнёр» в карточке АЗС на сайте — это статус подтверждённых данных, не платный приоритет в статусе наличия топлива: он по-прежнему считается только консенсусом отметок пользователей |
Заинтересовало? Напишите на partners@wherefuel.ru — опишите сценарий использования и ожидаемую нагрузку, обсудим тариф и лимиты.
Статус станции — не голое большинство голосов. Вес каждой отметки затухает со временем (недавние важнее старых) и зависит от репутации автора: свежие анонимные отметки получают заниженный вес, пока аккаунт не наберёт историю совпадений с итоговым консенсусом. Резкий переворот статуса станции только новыми аккаунтами автоматически удерживается до проверки модератором. Это защита именно от того сценария, который открыто ломает точность данных у части нишевых карт наличия топлива — накрутки свежими фейковыми отметками.
Напишите на partners@wherefuel.ru с кратким описанием сценария использования — пришлём ключ и обсудим лимит.
Ключ передаётся заголовком X-Api-Key на уже существующих публичных эндпоинтах:
| Запрос | Что возвращает |
|---|---|
GET /api/stations?bbox=lng1,lat1,lng2,lat2 | Список АЗС в прямоугольнике координат: бренд, адрес, координаты, статус наличия, цены |
GET /api/clusters?bbox=...&zoom=... | Агрегированные кластеры АЗС для широких зон (карта на малом зуме) |
Без заголовка X-Api-Key эндпоинты остаются доступны анонимно, как и сейчас — ключ
нужен только для собственного (не общего анонимного) лимита и учёта использования.
curl -H "X-Api-Key: ваш-ключ" "https://wherefuel.ru/api/stations?bbox=37.3,55.5,37.9,55.9" |
| Условие | Что это значит |
|---|---|
| Лимиты | Анонимно — до 180 запросов в минуту с одного IP (по умолчанию). Именной ключ снимает анонимный лимит и даёт собственные лимит в минуту и суточную квоту, зафиксированные при выдаче. Остаток виден в заголовках X-RateLimit-* каждого ответа и в GET /api/usage. |
| Атрибуция ODbL | Публикуя выгрузку каталога АЗС (адреса, сети, режим работы), вы обязаны указывать источник — «© участники OpenStreetMap», лицензия ODbL. Статусы наличия и цены — данные ГдеТопливо: при публикации указывайте страницу-источник и дату среза. |
| Не выдавать за официальные | Статусы — краудсорсные отметки водителей с возрастом каждой; представлять их как официальные данные сетей АЗС или государственных органов запрещено. |
| Отзыв ключа | За нарушение условий — обход лимитов, выдачу данных за официальные, скрытие атрибуции ODbL — ключ отзывается без предупреждения. |
Правила пользовательского контента сайта — в пользовательском соглашении.