Работает в «Подсказках» 19.2+. Требует лицензию на модули address и geo.
Находит ближайшие адреса (дома, улицы, города) по географическим координатам. Только для России.
Сортирует адреса в порядке удаления от заданных координат.
Запрос
POST:
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{ "lat": 55.601983, "lon": 37.359486 }' \
http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/geolocate/address
GET:
curl -X GET -G \ -H "Accept: application/json" \ -d "lat=55.601983&lon=37.359486" \ http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/geolocate/address
Заголовки
| Заголовок | Описание |
|---|---|
| Тип данных в запросе: |
| Тип данных в ответе: application/json или application/xml |
| API-ключ в формате: Только для пользователей подсказок DaData.ru |
Параметры
| Параметр | Обязательный? | Описание |
|---|---|---|
lat | да | Географическая широта |
lon | да | Географическая долгота |
count | нет | Количество возвращаемых подсказок (по умолчанию — 10, максимум — 20). |
radius_meters | нет | Радиус поиска в метрах (по умолчанию – 100, максимум – 1000) |
language | нет | Язык отображения адреса в результатах поиска (en/ru) 20.3+ |
Ответ
Возвращается список объектов адреса. Следующие поля не заполняются:
city_area city_district* house_fias_id house_kladr_id flat_* fias_code fias_actuality_state timezone beltway_hit beltway_distance metro qc_*
Примеры
Запрос:
{
"lat": 55.601983, "lon": 37.359486, "radius_meters": 50
}
Ответ:
{
"suggestions": [
{
"value": "г Москва, г Московский, ул Бианки, д 4 к 2",
"unrestricted_value": "г Москва, г Московский, ул Бианки, д 4 к 2",
"data": {
"postal_code": "108811",
"country": "Россия",
"region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"region_kladr_id": "7700000000000",
"region_with_type": "г Москва",
"region_type": "г",
"region_type_full": "город",
"region": "Москва",
"area_fias_id": null,
"area_kladr_id": null,
"area_with_type": null,
"area_type": null,
"area_type_full": null,
"area": null,
"city_fias_id": "fbcf1fff-1d7c-445e-ad92-b71c08b8aba3",
"city_kladr_id": "7700000600000",
"city_with_type": "г Московский",
"city_type": "г",
"city_type_full": "город",
"city": "Московский",
"city_area": null,
"city_district_fias_id": null,
"city_district_kladr_id": null,
"city_district_with_type": null,
"city_district_type": null,
"city_district_type_full": null,
"city_district": null,
"settlement_fias_id": null,
"settlement_kladr_id": null,
"settlement_with_type": null,
"settlement_type": null,
"settlement_type_full": null,
"settlement": null,
"street_fias_id": "a59b2217-d7ee-4cf4-a32d-13ac4749e7a5",
"street_kladr_id": "77000006000003100",
"street_with_type": "ул Бианки",
"street_type": "ул",
"street_type_full": "улица",
"street": "Бианки",
"house_fias_id": null,
"house_kladr_id": null,
"house_type": "д",
"house_type_full": "дом",
"house": "4",
"block_type": "к",
"block_type_full": "корпус",
"block": "2",
"flat_type": null,
"flat_type_full": null,
"flat": null,
"flat_area": null,
"square_meter_price": null,
"flat_price": null,
"postal_box": null,
"fias_id": "a59b2217-d7ee-4cf4-a32d-13ac4749e7a5",
"fias_code": null,
"fias_level": "7",
"fias_actuality_state": null,
"kladr_id": "77000006000003100",
"geoname_id": null,
"capital_marker": "0",
"okato": "45297565001",
"oktmo": "45952000",
"tax_office": "7751",
"tax_office_legal": "7751",
"timezone": null,
"geo_lat": "55.601956",
"geo_lon": "37.359989",
"beltway_hit": null,
"beltway_distance": null,
"metro": null,
"qc_geo": "0",
"qc_complete": null,
"qc_house": null,
"history_values": null,
"unparsed_parts": null,
"source": null,
"qc": null
}
},
...
]
}
Обзор
Инструменты контента