Автоматическое заполнение адреса
Автоматическое заполнение адреса
Сервис заполнения адреса
Предлагаем вам сервис по заполнению недостающих элементов адреса. Вы можете воспользоваться сервисом, например, при автоматическом экспорте объявлений о сделках с недвижимостью в Обозреватель рынка недвижимости.
Обратите внимание, что все географические единицы, до второго уровня включительно (регионы и крупнейшие города), явно определены в системе. При экспорте данных в систему мы рекомендуем проверять соответствие указываемых географических единиц второго уровня классификации СканРиалти.
Доступ к сервису
Доступ к сервису предоставляется бесплатно. Перед началом работы вам нужно получить личный ключ доступа.
Свяжитесь с нами, и мы вышлем вам ключ доступа к сервису.
Запрос к сервису
Для заполнения адреса вам нужно отправить HTTP-запрос на страницу http://www.scanrealty.com/geographer/, указав известные вам элементы адреса как GET-параметры.
Структура запроса к сервису состоит из следующих элементов:
country — страна (см. полный список названий),
city — город или регион (см. полный список названий для каждой страны),
location — район или населенный пункт,
address — дополнительный адрес в свободной форме (например, улица и номер дома),
lang — язык (в формате ISO 639-2), на котором будут возвращены названия географических единиц (необязательный параметр, значение по умолчанию: "eng", см. полный список поддерживаемых языков),
encoding — кодировка, в которой передаются входные данные в строке запроса (необязательный параметр, значение по умолчанию: "UTF-8", но если данные запроса передаются в другой кодировке, то в этом случае ее нужно указать),
key — ваш личный ключ, позволяющий использовать сервис.
Например, нам известны страна ("Россия"), город ("Москва") и адрес ("Рублевское шоссе, д. 1"), но не известен район. Тогда наш запрос будет выглядеть следующим образом:
http://www.scanrealty.com/geographer/?country=Россия&city=Москва&address=Рублевское шоссе, д. 1&lang=rus&encoding=windows-1251&key=your_private_key,
или так:
Запрос может содержать данные на любом языке. Все элементы должны занимать положенные им места. Если вы не можете определить, к какой категории относится тот или иной географический элемент, то рекомендуем поместить его в параметр "address".
Ответ сервиса
В ответ на запрос сервис возвращает XML-файл в кодировке UTF-8, структура которого состоит из следующих элементов:
response — группирующий элемент, присутствует всегда,
code — код результата работы сервиса (см. таблицу кодов ниже), присутствует всегда,
geography — группирующий элемент, присутствует только тогда, когда заполнен хотя бы один географический элемент,
country — страна,
city — город или регион,
location — район или населенный пункт,
address — дополнительный адрес в свободной форме.
Пример ответа можно увидеть, перейдя по ссылке в примере запроса.
Принципы работы сервиса
Если введенная вами страна не известна системе, то дальнейшее заполнение адреса считается невозможным (код 300).
Сервис сначала пытается вернуть официальное название географической единицы в системе СканРиалти на указанном языке, а в случае неудачи — любое из имеющихся неофициальных названий.
В случае обнаружения по введенному вами адресу двух или более географических единиц одного уровня, выбор считается невозможным (код 300 с указанием тех географических единиц, которые удалось определить).
Сервис является самообучающимся, поэтому если на ваш запрос не нашлось ответа сегодня, то скорее всего, он появится некоторое время спустя.
Коды результата работы сервиса
Ниже приведен полный перечень кодов результата работы сервиса.
100 — заполнение адреса успешно, определены все параметры,
105 — заполнение адреса не требуется, присутствуют все параметры,
200 — в запросе отсутствуют географические данные,
205 — запрос содержит символы в неверной кодировке,
210 — размер запроса превышает допустимый порог,
300 — не удалось определить один или несколько параметров,
400 — ключ неверный или отсутствует,
405 — превышен ежедневный лимит запросов для вашего ключа,
500 — истекло время ожидания сервиса,
505 — сервис недоступен,
510 — слишком много обращений к сервису.