История страницы

Чтобы искать адреса только в определенном регионе или городе, укажите их в параметре locations.Можно  Можно указать несколько ограничений.

Ограничение по КЛАДР-коду

...

Сахалинская область:

...

Включить страницу

...

Ограничение по КЛАДР-коду

...

Возможные ограничения:

• region_fias_id – ограничение по ФИАС коду региона

• area_fias_id – ограничение по ФИАС коду области

• city_fias_id – ограничение по ФИАС коду города

• settlement_fias_id – ограничение по ФИАС коду населенного пункта

• street_fias_id – ограничение по ФИАС коду улицы

г Пушкин:

Блок кода
{ "query": "московское шоссе", "locations": [{ "city_fias_id": "110d6ad9-0b64-47cf-a2ee-7e935228799c" } }

Ограничение по КЛАДР-коду

Ограничение по ФИАС-коду

Ограничение по названию адресного объекта

Москва:

{
    "query": "Ботаническая",
    "locations": [{
        "region": "москва"
    }]
}

...

{
    "query": "ростов рассветная",
    "locations": [{
        "region": "адыгея"
    }, {
        "region": "астраханская"
    }, {
        "region": "волгоградская"
    }, {
        "region": "калмыкия"
    }, {
        "region": "краснодарский"
    }, {
        "region": "ростовская"
    }]
}

...

{
    "query": "Абрикосовая",
    "locations": [{
        "region": "Самарская",
        "city": "Тольятти"
    }]
}

...

Чтобы адрес одной строкой в ответе (поле value) не содержал регион / город, заданный в ограничении, добавьте параметр restrict_value = true:

{
  "query": "Турчанинов",
  "locations": [
    {
      "region": "Москва"      
    }
  ],
  "restrict_value": true
}

Ответ:

{
    "suggestions": [
        {
            "value": "Турчанинов пер",
            "unrestricted_value": "г Москва, Турчанинов пер",
            "data": {
                ...
            }
        },
        {
            "value": "Турчанинов пер, д 2",
            "unrestricted_value": "г Москва, Турчанинов пер, д 2",
            "data": {
                ...
            }
        },
        {
            "value": "Турчанинов пер, д 2А",
            "unrestricted_value": "г Москва, Турчанинов пер, д 2А",
            "data": {
                ...
            }
        },
        {
            "value": "Турчанинов пер, д 3 стр 1",
            "unrestricted_value": "г Москва, Турчанинов пер, д 3 стр 1",
            "data": {
                ...
            }
        }
    ]
}

При этом полный адрес тоже возвращается, в поле unrestricted_value.

Ограничение по коду Типу объекта

Возможные ограничения:

• street_type_full – ограничение по полному типу улицы
• settlement_type_full – ограничение по полному типу населенного пункта
• city_district_type_full – ограничение по полному типу района города
• city_type_full – ограничение по полному типу города
• area_type_full – ограничение по полному типу района в регионе
• region_type_full – ограничение по полному типу региона

...

...

Ограничение по типу объекта

Ограничение по стране

Ограничение по ISO-коду

Ограничение по радиусу окружности