API вычисляет зону, куда можно дойти или доехать от заданной точки за определенный промежуток времени, а также выдает статистические данные по населению на этой территории. Подсчитывается количество жилых домов, сколько всего квартир в них, средняя стоимость квадратного метра жилья. Отдельно считаются все те же параметры по новостройкам.
API позволяет задавать исходные данные в виде центральной зоны и максимальной времени максимального удаления от нее, тогда будет рассчитана зона и выведены все статистические данные по ней. Второй вариант исходных параметров позволяет передать уже готовый полигон, чтобы получить только статистическую информацию, без вычисления границ самой зоны.
Адрес скрипта: mosmap.ru/api/api_area.php
Параметры запроса при вычислении зоны:
apikey – ключ пользователя. Обязательный параметр.
mode - Способ перемещения по местности. Допускаются значения walking для пешеходной зоны или driving для передвижения на автомобиле. Значение walking используется по умолчанию если параметр не задан.
latitude – широта центральной точки. Обязательный параметр.
longitude – долгота центральной точки. Обязательный параметр.
duration – Время до границ зоны при выбранном способе передвижения. Задается в секундах. Обязательный параметр.
house_year – год, начиная с которого дом считается новостройкой.
Параметры запроса для получения статистической информации по заданному полигону:
apikey – ключ пользователя. Обязательный параметр.
area_points - Координаты полигона. Обязательный параметр. Каждая точка передается в виде широты и долготы, разделенных запятой, разделителем между точками является знак "|".
house_year – год, начиная с которого дом считается новостройкой.
Параметры ответа:
mode - Способ перемещения по местности. Дублирует соответствующий параметр запроса.
latitude – широта центральной точки.
longitude – долгота центральной точки.
polygon – набор координат, составляющих контур зоны. Указаны в десятичных градусах (стандарт WGS84). Каждая точка описывается парой координат в следующем формате [{широта},{долгота}]
houses – количество домов
living_houses – количество жилых домов
living_new_houses – количество новостроек. Новостройками считаются дома, построенные после года, указанного в параметре house_year, если он не задан, то за последние 5 лет.
flats – количество квартир.
flats_new_houses – количество квартир в новостройках.
flats_price – средняя стоимость квадратного метра в жилых домах.
flats_new_houses_price средняя стоимость квадратного метра в новостройках.
flats_old_houses_price - средняя стоимость квадратного метра на вторичном рынке.
middle_year - Усредненный год постройки жилых домов
Пример запроса с заданным центром зоны:
http://mosmap.ru/api/api_area.php?apikey=4efdb87d-e940-4b19-9751-757c154ace9b&latitude=55.885988&longitude=37.65486&duration=400&mode=walking
Пример запроса по полигону:
http://mosmap.ru/api/api_area.php?apikey=4efdb87d-e940-4b19-9751-757c154ace9b&area_points=55.63453,37.42345|55.60347,37.49564|55.71456,37.39325
Пример ответа:
{
"mode": "walking",
"duration": 400,
"latitude": 55.885988,
"longitude": 37.65486,
"houses": 55,
"living_houses": 31,
"living_new_houses": 0,
"flats": 4638,
"flats_new_houses": 0,
"flats_price": 264575,
"flats_new_houses_price": 0,
"flats_old_houses_price": 264575,
"middle_year": 1985,
"polygon": [
[
55.886215,
37.66098
],
[
55.88618078803178,
37.66097269409826
],
[
55.8861,
37.660965
],
[
55.88600806023667,
37.66096039318228
],
....
[
55.886665,
37.66081
],
[
55.886635,
37.66086
],
[
55.886635,
37.660920000000004
],
[
55.886415,
37.66124
]
]
}