Программное API для определения района

У вас есть возможность использовать программное API в вашей системе 1С, в вашем приложении или на сайте для мгновенного получения района по адресу.

Список доступных городов для определения района.

Запрос к веб-сервису

Для получения района нужно обратиться к сервису с помощью GET-запроса и передать 2 параметра.

Вид строки запроса: https://app.raionpoadresu.ru/raion?address=addressSample&token=tokenSample

Параметры:

  • address: адрес закодированный, с помощью процентной схемы кодирования URL encoding. Примеры: C#: Uri.EscapeUriString(str); JS: encodeURIComponent(str)
  • token: уникальный ключ, используемый для идентификации запрашивающего. Выдаётся после заключения договора.

Уникальный ключ API (token) вы можете получить прямо сейчас в личном кабинете системы определения районов. Тестовый доступ включает 50 обращений к веб-сервису.

Ответ веб-сервиса

Пример ответа сервиса для адреса «г Москва, ул Промышленная, д 4»:

{
    "City":"Москва",
    "District":"район Царицыно",
    "GlobalDistrict":"Южный административный округ",
    "IsExistDistrict":true,
    "IsSuccess":true,
    "Message":null,
    "Query": "г Москва, ул Промышленная, д 4"
}

Описание выходных параметров:

City – город из входного адреса
District – определённый район
GlobalDistrict – округ, заполняется только для Москвы
IsExistDistrict – признак, есть ли деление в городе по районам
IsSuccess – успешность определения района
Message – дополнительная информация, если имеется
Query – исходный запрос для контроля.

Для адресов вне городов определяется муниципальная единица, к которой принадлежит адрес, например, городской округ или район области. Например, для «141206, РОССИЯ, Московская обл, Пушкинский р-н, Пушкино г, Акуловский гск, дом 48 (первый дом направо)» выдаётся «Пушкинский район».

Получить тестовый доступ к API »

Пример

Требуется определить район для адреса «Ростов-на-Дону, Ростовская обл., Гусева, 97/19».

1. Кодируем адрес с помощью процентной схемы кодирования URL encoding и создаём строку запроса:

https://app.raionpoadresu.ru/raion?address=%D0%A0%D0%BE%D1%81%D1%82%D0%BE%D0%B2-%D0%BD%D0%B0-%D0%94%D0%BE%D0%BD%D1%83,%20%D0%A0%D0%BE%D1%81%D1%82%D0%BE%D0%B2%D1%81%D0%BA%D0%B0%D1%8F%20%D0%BE%D0%B1%D0%BB.,%20%D0%93%D1%83%D1%81%D0%B5%D0%B2%D0%B0,%2097/19&token=rpa23a1e385b1c54c7da8e0032f165520d0

2. Выполняем запрос методом GET

3. Получаем ответ и используем:

{
    "City":"Ростов-на-Дону",
    "District":"Железнодорожный район",
    "GlobalDistrict":null,
    "IsExistDistrict":true,
    "IsSuccess":true,
    "Message":null,
    "Query": "Ростов-на-Дону, Ростовская обл., Гусева, 97/19"
}

Получение ключа доступа и тарифы

Используйте в API те же пакеты адресов, что и в приложении САМА. Ключ доступа вы можете получить в личном кабинете приложения САМА. Наши тарифы

При регистрации в САМА вам будет предоставлено 50 адресов для проверки и тестирования бесплатно!

Получить ключ API в приложении »

Остались вопросы? Задайти их нам

Нажимая на кнопку "Отправить", я даю согласие на обработку персональных данных.