Район по адресу – программное API

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

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

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

Цена одного запрос к API RPA:

40коп. фиксированная
Запросить тестовый доступ

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

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

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

Параметры:

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

Уникальный ключ и адрес API предоставляется по запросу тестового доступа. Тестовый доступ включает 100 обращений к веб-сервису. Далее заключается договор и оплата происходит по количеству обращений.

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

Пример ответа сервиса для адреса «г Москва, ул Промышленная, д 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 и создаём строку запроса:

http://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 c начала 2018 года:

90 661

Запросить предоставление доступа к API

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