Если задать параметры from_bound
и to_bound
, то будут подсказки только для указанных частей адреса.
Возможные значения from_bound
и to_bound
:
Название | Описание |
---|
region | Регион |
area | Район |
city | Город |
settlement | Населенный пункт |
planning_structure | Планировочная структура |
street | Улица |
house | Дом |
Подсказки по отдельным компонентам адреса
Только регионы
{
"query": "Пе",
"from_bound": { "value": "region" },
"to_bound": { "value": "region" }
} |
<req>
<query>пе</query>
<from_bound>
<value>region</value>
</from_bound>
<to_bound>
<value>region</value>
</to_bound>
</req> |
{
"suggestions": [
{
"value": "г Санкт-Петербург"
},
{
"value": "Пермский край"
},
{
"value": "Пензенская обл"
}
]
} |
Города
{
"query": "Пет",
"from_bound": { "value": "city" },
"to_bound": { "value": "city" }
} |
<req>
<query>пет</query>
<from_bound>
<value>city</value>
</from_bound>
<to_bound>
<value>city</value>
</to_bound>
</req> |
{
"suggestions": [
{
"value": "респ Карелия, г Петрозаводск"
},
{
"value": "Камчатский край, г Петропавловск-Камчатский"
},
{
"value": "г Санкт-Петербург, г Петергоф"
},
{
"value": "Саратовская обл, г Петровск"
}
]
} |
Улицы в Москве
{
"query": "тур",
"from_bound": { "value": "street" },
"to_bound": { "value": "street" }
} |
<req>
<query>тур</query>
<from_bound>
<value>street</value>
</from_bound>
<to_bound>
<value>street</value>
</to_bound>
</req> |
{
"suggestions": [
{
"value": "г Москва, ул Туристская"
},
{
"value": "г Москва, пер Турчанинов"
},
{
"value": "г Москва, пл Тургеневская"
},
{
"value": "г Москва, пр-д Туркменский"
}
]
} |
Города и села в Пензенской области
{
"query": "Красное",
"from_bound": { "value": "city" },
"to_bound": { "value": "settlement" },
"locations": [{ "region": "Пензенская" }]
} |
<req>
<query>Красное</query>
<locations>
<region>Пензенская</region>
</locations>
<from_bound>
<value>city</value>
</from_bound>
<to_bound>
<value>settlement</value>
</to_bound>
</req> |
{
"suggestions": [
{
"value": "Пензенская обл, Никольский р-н, село Красное"
},
{
"value": "Пензенская обл, Мокшанский р-н, поселок Красное Польцо"
},
{
"value": "Пензенская обл, Земетчинский р-н, поселок Красное Знамя"
},
{
"value": "Пензенская обл, Камешкирский р-н, село Красное Поле"
}
]
} |
Полностью гранулярный ввод адреса
Пусть есть форма:
Чтобы показывать подсказки по каждому из полей от региона до дома, отправляйте запросы вида:
Регион
{
"from_bound": {
"value": "region"
},
"to_bound": {
"value": "region"
},
"query": "самарская"
} |
<req>
<from_bound>
<value>region</value>
</from_bound>
<to_bound>
<value>region</value>
</to_bound>
<query>самарская</query>
</req> |
Район в выбранном регионе
Значение region_fias_id взято от вышестоящего поля («Регион») после того, как пользователь выбрал в нем подсказку из списка:
{
"locations": [
{
"region_fias_id": "df3d7359-afa9-4aaa-8ff9-197e73906b1c"
}
],
"from_bound": {
"value": "area"
},
"to_bound": {
"value": "area"
},
"restrict_value": true,
"query": "алексеевский"
} |
<req>
<locations>
<region_fias_id>df3d7359-afa9-4aaa-8ff9-197e73906b1c</region_fias_id>
</locations>
<from_bound>
<value>area</value>
</from_bound>
<to_bound>
<value>area</value>
</to_bound>
<restrict_value>true</restrict_value>
<query>алексеевский</query>
</req> |
Город в выбранном регионе
Значение region_fias_id взято от вышестоящего поля («Регион») после того, как пользователь выбрал в нем подсказку из списка. Если бы пользователь заполнил район, вместо region_fias_id было area_fias_id.
{
"locations": [
{
"region_fias_id": "df3d7359-afa9-4aaa-8ff9-197e73906b1c"
}
],
"from_bound": {
"value": "city"
},
"to_bound": {
"value": "city"
},
"restrict_value": true,
"query": "самара"
} |
<req>
<locations>
<region_fias_id>df3d7359-afa9-4aaa-8ff9-197e73906b1c</region_fias_id>
</locations>
<from_bound>
<value>city</value>
</from_bound>
<to_bound>
<value>city</value>
</to_bound>
<restrict_value>true</restrict_value>
<query>самара</query>
</req> |
Населённый пункт в выбранном городе
Значение city_fias_id взято от вышестоящего поля («Город») после того, как пользователь выбрал в нем подсказку из списка. Если бы пользователь не заполнил город, вместо city_fias_id было area_fias_id или region_fias_id.
{
"locations": [
{
"city_fias_id": "bb035cc3-1dc2-4627-9d25-a1bf2d4b936b"
}
],
"from_bound": {
"value": "settlement"
},
"to_bound": {
"value": "settlement"
},
"restrict_value": true,
"query": "мехзавод"
} |
<req>
<locations>
<city_fias_id>bb035cc3-1dc2-4627-9d25-a1bf2d4b936b</city_fias_id>
</locations>
<from_bound>
<value>settlement</value>
</from_bound>
<to_bound>
<value>settlement</value>
</to_bound>
<restrict_value>true</restrict_value>
<query>мехзавод</query>
</req> |
Планировочная структура в выбранном населённом пункте
Значение settlement_fias_id взято от вышестоящего поля («Населенный пункт») после того, как пользователь выбрал в нем подсказку из списка. Если бы пользователь не заполнил населенный пункт, вместо settlement_fias_id было city_fias_id.
{
"locations": [
{
"settlement_fias_id": "cb0e4dab-55cc-424a-85c3-2425661efeea"
}
],
"from_bound": {
"value": "planning_structure"
},
"to_bound": {
"value": "planning_structure"
},
"restrict_value": true,
"query": "сол"
} |
<req>
<locations>
<settlement_fias_id>cb0e4dab-55cc-424a-85c3-2425661efeea</settlement_fias_id>
</locations>
<from_bound>
<value>planning_structure</value>
</from_bound>
<to_bound>
<value>planning_structure</value>
</to_bound>
<restrict_value>true</restrict_value>
<query>сол</query>
</req> |
Улица в выбранной планировочной структуре
Значение planning_structure_fias_id взято от вышестоящего поля («Планировочная структура») после того, как пользователь выбрал в нем подсказку из списка. Если бы пользователь не заполнил планировочную структуру, вместо planning_structure_fias_id было settlement_fias_id.
{
"locations": [
{
"planning_structure_fias_id": "9cd80afe-2c61-431b-99ef-c36cc27ac46c"
}
],
"from_bound": {
"value": "street"
},
"to_bound": {
"value": "street"
},
"restrict_value": true,
"query": "вост"
} |
<req>
<locations>
<planning_structure_fias_id>9cd80afe-2c61-431b-99ef-c36cc27ac46c</planning_structure_fias_id>
</locations>
<from_bound>
<value>street</value>
</from_bound>
<to_bound>
<value>street</value>
</to_bound>
<restrict_value>true</restrict_value>
<query>вост</query>
</req> |
Дом на выбранной улице
Значение street_fias_id взято от вышестоящего поля («Улица») после того, как пользователь выбрал в нем подсказку из списка. Если бы пользователь не заполнил улицу, вместо street_fias_id было settlement_fias_id.
{
"locations": [
{
"street_fias_id": "dd08e4e2-82ff-43b5-81f7-93f59f013974"
}
],
"from_bound": {
"value": "house"
},
"restrict_value": true,
"query": "12"
} |
<req>
<locations>
<street_fias_id>dd08e4e2-82ff-43b5-81f7-93f59f013974</street_fias_id>
</locations>
<from_bound>
<value>house</value>
</from_bound>
<to_bound>
<value>house</value>
</to_bound>
<restrict_value>true</restrict_value>
<query>12</query>
</req> |