Page tree
Skip to end of metadata
Go to start of metadata

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


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

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

{
    "query": "Ватутина",
    "locations": [{
        "kladr_id": "65"
    }]
}

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

В «Подсказках» 21.12+

fias_id с ФИАС-кодом региона, области, города, населенного пункта, планировочной структуры либо улицы:

{
    "query": "московское шоссе",
    "locations": [{
        "fias_id": "110d6ad9-0b64-47cf-a2ee-7e935228799c"
    }]
}

В «Подсказках» 21.11 и раньше

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

  • region_fias_id – ограничение по ФИАС коду региона
  • area_fias_id – ограничение по ФИАС коду области
  • city_fias_id – ограничение по ФИАС коду города
  • settlement_fias_id – ограничение по ФИАС коду населенного пункта
  • planning_structure_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": "119034, г Москва, пер Турчанинов",
            "data": {
                ...
            }
        },
        {
            "value": "Турчанинов пер, д 1",
            "unrestricted_value": "119034, г Москва, пер Турчанинов, д 1",
            "data": {
                ...
            }
        },
        {
            "value": "Турчанинов пер, д 2",
            "unrestricted_value": "119034, г Москва, пер Турчанинов, д 2",
            "data": {
                ...
            }
        },
        {
            "value": "Турчанинов пер, д 2А",
            "unrestricted_value": "119034, г Москва, пер Турчанинов, д 2А",
            "data": {
                ...
            }
        }
    ]
}

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

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

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

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


Запрос
{
	"query":"ассоль", 
	"locations": [
		{
			"planning_structure_type_full": "территория"
		}
	]
}
  • No labels