---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com/support/taxi-distr/en/api/zone-info.md
  - https://yandex.com/support/taxi-distr/ru/api/zone-info.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/taxi-distr/ru/llms.txt

# API информации о регионе

Запрос позволяет получить информацию о тарифах и услугах Яндекс Go в указанном регионе.

## Синтаксис запроса {#req-format}

```
GET  https://taxi-routeinfo.taxi.yandex.net/zone_info?[clid](*clid)=<clid>&[apikey](*apikey)=<apikey>&[ll](*ll)=<lon,lat>
```

Аргументы:

- `clid` — идентификатор клиента. Чтобы получить идентификатор, заполните анкету на странице [API прогноза стоимости](https://tech.yandex.ru/taxi/taxiapi). Обязательный параметр.
    
- `apikey` — ключ API. Чтобы получить ключ, заполните анкету на странице [API прогноза стоимости](https://tech.yandex.ru/taxi/taxiapi). Параметр может быть использован вместо заголовка `YaTaxi-Api-Key`. Если не был передан заголовок `YaTaxi-Api-Key`, параметр `apikey` является обязательным.
    
    {% note alert %}
    
    Данный способ не рекомендуется к использованию, так как значение токена может сохраняться в логах.
    
    {% endnote %}
    
- `ll` — координаты региона. Обязательный параметр. Формат аргумента:
    ```
    {долгота региона},{широта региона}
    ```

## Описание полей ответа {#json-format}

В ответе могут содержаться следующие поля:

#|
|| **Поле** | **Описание** | **Формат** ||
||`tariffs` | Список тарифов, поддерживаемых в регионе. Если указанный регион не поддерживается сервисом Яндекс Go, массив будет пустым. | Массив. ||
|| `class` | Идентификатор тарифа. Возможные значения:
- `econom` — «Эконом».
- `business` — «Комфорт».
- `comfortplus` — «Комфорт+».
- `minivan` — «Минивен».
- `vip` — «Бизнес».
- `express` — «Доставка».
- `courier` — «Курьер». | Строка. ||
|| `supported_requirements` | Список услуг, предоставляемых в регионе. | Массив. ||
|| `name` | Идентификатор услуги. Возможные значения:
- `yellowcarnumber` — машина с желтыми номерами.
- `nosmoking` — некурящий водитель.
- `childchair` — наличие детского кресла в машине.
- `bicycle` — перевозка велосипеда.
- `conditioner` — кондиционер в машине.
- `animaltransport` — перевозка животных.
- `universal` — машина-универсал.
- `check` — необходима квитанция об оплате.
- `ski` — перевозка лыж или сноуборда.
- `waiting_in_transit` — ожидание в пути.
- `meeting_arriving` — встреча с табличкой.
- `luggage` — платная перевозка багажа. | Строка. ||
|#

## Пример запроса {#req-example}

```
GET https://taxi-routeinfo.taxi.yandex.net/zone_info?ll=37.589569560,55.733780&clid=t...t3&apikey=q...3
```

## Пример ответа {#resp-example}

Пример ответа на запрос информации о регионе выглядит следующим образом:

```no-highlight
{
    "[tariffs](*tariffs)": [
        {
            "[class](*class)": "econom", 
            "[supported_requirements](*supported_requirements)": [
               {
                  "[name](*name)": "conditioner" 
               },
               {
                    "name": "childchair"
               },
               ...
            ]
        }, …
    ]
}
```

## Возможные коды ответа {#response-codes}

Ответ на данный запрос может содержать следующие коды ответа:

- `200` — запрос выполнен успешно.
- `400` — параметры запроса были не указаны или указаны некорректно.
- `403` — ошибка авторизации. Были указаны некорректные значения ключа API или идентификатора клиента.
- `500` — внутренняя ошибка сервера.

В случае ошибок с кодами `400` и `403` в теле ответа будет содержаться текст сообщения об ошибке.

[*tariffs]: Список тарифов, поддерживаемых в регионе. Если указанный регион не поддерживается сервисом Яндекс Go, массив будет пустым.

[*class]: Идентификатор тарифа. Возможные значения:
- `econom` — «Эконом».
- `business` — «Комфорт».
- `comfortplus` — «Комфорт+».
- `minivan` — «Минивен».
- `vip` — «Бизнес».
- `express` — «Доставка».
- `courier` — «Курьер».

[*supported_requirements]: Список услуг, предоставляемых в регионе.

[*name]: Идентификатор услуги. Возможные значения:
- `yellowcarnumber` — машина с желтыми номерами.
- `nosmoking` — некурящий водитель.
- `childchair` — наличие детского кресла в машине.
- `bicycle` — перевозка велосипеда.
- `conditioner` — кондиционер в машине.
- `animaltransport` — перевозка животных.
- `universal` — машина-универсал.
- `check` — необходима квитанция об оплате.
- `ski` — перевозка лыж или сноуборда.
- `waiting_in_transit` — ожидание в пути.
- `meeting_arriving` — встреча с табличкой.
- `luggage` — платная перевозка багажа.

[*clid]: `clid` — идентификатор клиента. Чтобы получить идентификатор, заполните анкету на странице [API прогноза стоимости](https://yandex.ru/dev/taxi/taxiapi/).

[*apikey]: `apikey` — ключ API. Чтобы получить ключ, заполните анкету на странице [API прогноза стоимости](https://yandex.ru/dev/taxi/taxiapi/). Параметр может быть использован вместо заголовка `YaTaxi-Api-Key`. Если не был передан заголовок `YaTaxi-Api-Key`, параметр `apikey `является обязательным.

[*ll]: `ll` — координаты региона. Обязательный параметр. Формат аргумента:
```
{долгота региона},{широта региона}
```