Определение географических координат домов

Материал из Map.BY
Перейти к: навигация, поиск

Описание: Интерфейс служит для определения географических координат дома по номеру дома, наименованию улицы и городу

Параметры использования: Функция вызывается при помощи сформированного GETзапроса по указанному URL. Данные возвращаются в формате JSON.

http://map.by/map/getHomeNumberCoordinates/{:city}/{:street}/{:home_number}

Параметр Описание
{:city} Наименование города. Параметр должен быть передан в виде urlencode(строка, в которой все не цифробуквенные символы, кроме -_. Заменены знаком процента (%), за которым следует два шестнадцатеричных числа, а пробелы кодируются как знак сложения (+) Формат кодировки – UTF8
{:street} Наименование улицы. Параметр должен быть передан в виде urlencode(строка, в которой все не цифробуквенные символы, кроме -_. заменены знаком процента (%), за которым следует два шестнадцатеричных числа, а пробелы кодируются как знак сложения (+) Формат кодировки – UTF8
{:home_number} Номер дома. Параметр должен быть передан в виде urlencode(строка, в которой все не цифробуквенные символы, кроме -_. заменены знаком процента (%), за которым следует два шестнадцатеричных числа, а пробелы кодируются как знак сложения (+)

В случае успеха сервис вернет JSON код в виде:

{"status":"found","coord":{"x":"27.6322527619593","y":"53.9172801329902"}}
Параметр Описание
status Статус ответа. Может принимать 2 варианта значений:
  • found – в случае успешного выполнения запроса
  • not_found – в случае неудачного выполнения запросапоиска
coord Массив, содержащий в себе параметры ответа:
  • x – координата X
  • y – координата Y

Если поиск завершится неудачей (записей не найдено), сервис вернет JSON нотификацию об ошибке в виде:

{"status":"not_found"}

Пример использования:

REQUEST: http://map.by/map/getHomeNumberCoordinates/%D0%9C%D0%B8%D0%BD%D1%81%D0%BA/%D0%A4%D0%B8%D0%BB%D0%B8%D0%BC%D0%BE%D0%BD%D0%BE%D0%B2%D0%B0/25

RESPONSE:

{"status":"found","coord":{"x":"27.6322527619593","y":"53.9172801329902"}}
Личные инструменты
Пространства имён

Варианты
Действия
Навигация
Инструменты