Документация API Адресли

curl
curl -s -X POST "https://api.adresly.ru/v1/rs/suggest/address" \
  -H "Authorization: Token adr_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "query": "мск тверская 28", "count": 1 }'

json
{
  "suggestions": [
    {
      "value": "г Москва, ул Тверская, д 28",
      "unrestricted_value": "125009, г Москва, ул Тверская, д 28",
      "data": {
        "postal_code": "125009",
        "country": "Россия",
        "country_iso_code": "RU",
        "federal_district": "Центральный",
        "region_fias_id": null,
        "region_kladr_id": null,
        "region_iso_code": "RU-MOW",
        "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,
        "sub_area_fias_id": null,
        "sub_area_kladr_id": null,
        "sub_area_with_type": null,
        "sub_area_type": null,
        "sub_area_type_full": null,
        "sub_area": null,
        "city_fias_id": null,
        "city_kladr_id": null,
        "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": "9120b43f-2fae-4838-a144-85e43c0f4d1e",
        "street_kladr_id": null,
        "street_with_type": "ул Тверская",
        "street_type": "ул",
        "street_type_full": "улица",
        "street": "Тверская",
        "stead_fias_id": null,
        "stead_cadnum": null,
        "stead_type": null,
        "stead_type_full": null,
        "stead": null,
        "house_fias_id": "fd2911a0-4bb8-4039-a45a-37c0e103e91b",
        "house_kladr_id": null,
        "house_cadnum": null,
        "house_type": "д",
        "house_type_full": "дом",
        "house": "28",
        "block_type": null,
        "block_type_full": null,
        "block": null,
        "entrance": null,
        "floor": null,
        "flat_fias_id": null,
        "flat_cadnum": null,
        "flat_type": null,
        "flat_type_full": null,
        "flat": null,
        "flat_area": null,
        "square_meter_price": null,
        "flat_price": null,
        "house_flat_count": null,
        "room_fias_id": null,
        "room_cadnum": null,
        "room_type": null,
        "room_type_full": null,
        "room": null,
        "postal_box": null,
        "fias_id": "fd2911a0-4bb8-4039-a45a-37c0e103e91b",
        "fias_code": null,
        "fias_level": "8",
        "fias_actuality_state": "0",
        "kladr_id": null,
        "geoname_id": null,
        "capital_marker": "2",
        "okato": null,
        "oktmo": null,
        "tax_office": null,
        "tax_office_legal": null,
        "timezone": "UTC+3",
        "geo_lat": "55.7649",
        "geo_lon": "37.6050",
        "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
      }
    }
  ]
}

curl
curl -s -X POST "https://api.adresly.ru/v1/rs/suggest/postal_unit" \
  -H "Authorization: Token adr_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "query": "1010", "count": 5 }'

json
{
  "suggestions": [
    {
      "value": "101000",
      "unrestricted_value": "101000 · г Москва, ул Мясницкая",
      "data": {
        "postal_code": "101000",
        "country": "Россия",
        "country_iso_code": "RU",
        "federal_district": "Центральный",
        "region_with_type": "г Москва",
        "region": "Москва",
        "city": "Москва",
        "street_with_type": "ул Мясницкая",
        "street": "Мясницкая",
        "timezone": "UTC+3",
        "geo_lat": null,
        "geo_lon": null,
        "qc_geo": null,
        "...": "остальные поля объекта адреса — см. раздел «Объект адреса (data)»"
      }
    }
  ]
}

curl
curl -s -X POST "https://api.adresly.ru/v1/geocode" \
  -H "Authorization: Token adr_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Москва, Льва Толстого, 16" }'

json
{
  "suggestions": [
    {
      "value": "г Москва, ул Льва Толстого, д 16",
      "unrestricted_value": "119021, г Москва, ул Льва Толстого, д 16",
      "data": {
        "postal_code": "119021",
        "country": "Россия",
        "country_iso_code": "RU",
        "federal_district": "Центральный",
        "region_iso_code": "RU-MOW",
        "region_with_type": "г Москва",
        "city": "Москва",
        "street_with_type": "ул Льва Толстого",
        "house_type": "д",
        "house": "16",
        "fias_level": "8",
        "timezone": "UTC+3",
        "geo_lat": "55.733969",
        "geo_lon": "37.587093",
        "qc_geo": "0",
        "...": "остальные поля объекта адреса — см. раздел «Объект адреса (data)»"
      }
    }
  ]
}

curl
curl -s -X POST "https://api.adresly.ru/v1/rs/geolocate/address" \
  -H "Authorization: Token adr_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "lat": 59.9342, "lon": 30.3350, "radius_meters": 100, "count": 3 }'

json
{
  "suggestions": [
    {
      "value": "г Санкт-Петербург, Дворцовая пл, д 2",
      "unrestricted_value": "191055, г Санкт-Петербург, Дворцовая пл, д 2",
      "data": {
        "postal_code": "191055",
        "country": "Россия",
        "region_iso_code": "RU-SPE",
        "region_with_type": "г Санкт-Петербург",
        "city": "Санкт-Петербург",
        "street_with_type": "пл Дворцовая",
        "house": "2",
        "fias_level": "8",
        "timezone": "UTC+3",
        "geo_lat": "59.9388",
        "geo_lon": "30.3155",
        "qc_geo": "0",
        "...": "остальные поля объекта адреса — см. раздел «Объект адреса (data)»"
      }
    }
  ]
}

curl
curl -s -X POST "https://api.adresly.ru/v1/route" \
  -H "Authorization: Token adr_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "points": [
      { "address": "Москва, Красная площадь" },
      { "lat": 56.3107, "lon": 38.1316 },
      { "address": "Ярославль" }
    ],
    "mode": "car",
    "geometry": "geojson"
  }'

json
{
  "code": "Ok",
  "routes": [
    {
      "distance_m": 271340,
      "duration_s": 15120,
      "geometry": { "type": "LineString", "coordinates": [[37.62, 55.75], ...] },
      "legs": [
        { "distance_m": 71000, "duration_s": 4200, "summary": "Ярославское ш" }
      ]
    }
  ],
  "waypoints": [
    { "location": [37.6208, 55.7539], "name": "Красная площадь", "distance": 12.3 }
  ]
}

curl
curl -s -X POST "https://api.adresly.ru/v1/distancematrix" \
  -H "Authorization: Token adr_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sources":      [ { "lat": 55.7539, "lon": 37.6208 } ],
    "destinations": [
      { "lat": 56.3107, "lon": 38.1316 },
      { "lat": 57.6243, "lon": 39.9007 }
    ]
  }'

json
{
  "code": "Ok",
  "durations_s": [[4200, 15120]],
  "distances_m": [[71000, 271340]],
  "sources":      [{ "location": [37.6208, 55.7539], "name": "" }],
  "destinations": [
    { "location": [38.1316, 56.3107], "name": "" },
    { "location": [39.9007, 57.6243], "name": "" }
  ]
}