Гранулярные подсказки по адресу (REST)

Если задать параметры from_bound и to_bound, то будут подсказки только для указанных частей адреса.

Возможные значения from_bound и to_bound:

Только регионы

{
    "query": "Пе",
	"from_bound": { "value": "region" }, 
	"to_bound": { "value": "region" }   
}

{
    "suggestions": [
        {
            "value": "г Санкт-Петербург"
        },
        {
            "value": "Пермский край"
        },
        {
            "value": "Пензенская обл"
        }
    ]
}

Города

{
    "query": "Пет",
	"from_bound": { "value": "city" }, 
	"to_bound": { "value": "city" }   
}

{
    "suggestions": [
        {
            "value": "г Санкт-Петербург"
        },
        {
            "value": "респ Карелия, г Петрозаводск"
        },
        {
            "value": "Камчатский край, г Петропавловск-Камчатский"
        },
        {
            "value": "г Санкт-Петербург, г Петергоф"
        },
        {
            "value": "Саратовская обл, г Петровск"
        }
    ]
}

Улицы в Москве

{
    "query": "тур",
    "from_bound": { "value": "street" },
    "to_bound": { "value": "street" },
    "locations": [{ "region": "москва" }],
	"restrict_value": true
}

{
    "suggestions": [
        {
            "value": "г Москва, Тургеневская пл"
        },
        {
            "value": "г Москва, ул Туристская"
        },
        {
            "value": "г Москва, Туркменский проезд"
        },
        {
            "value": "г Москва, Турчанинов пер"
        }
    ]
}

Города и села в Пензенской области

{
    "query": "Красное",
	"from_bound": { "value": "city" }, 
	"to_bound": { "value": "settlement" },
	"locations": [{ "region": "Пензенская" }],
	"restrict_value": true
}

{
    "suggestions": [
        {
            "value": "Пензенская обл, Мокшанский р-н, поселок Красное Польцо"
        },
        {
            "value": "Пензенская обл, Земетчинский р-н, поселок Красное Знамя"
        },
        {
            "value": "Пензенская обл, Никольский р-н, село Красное"
        },
        {
            "value": "Пензенская обл, Камешкирский р-н, село Красное Поле"
        }
    ]
}

Полностью гранулярный ввод адреса

Пусть есть форма:

Чтобы показывать подсказки по каждому из полей от региона до дома, отправляйте запросы вида:

• Регион

  {
    "from_bound": {
      "value": "region"
    },
    "to_bound": {
      "value": "region"
    },
    "query": "самарская"
  }

• Район

  # значение region_fias_id взято от вышестоящего поля («Регион») после того, как пользователь выбрал в нем подсказку из списка
  {
    "locations": [
      {
        "region_fias_id": "df3d7359-afa9-4aaa-8ff9-197e73906b1c"
      }
    ],
    "from_bound": {
      "value": "area"
    },
    "to_bound": {
      "value": "area"
    },
    "restrict_value": true,
    "query": "алексеевский"
  }

• Город

  # значение 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": "самара"
  }

• Населенный пункт

  # значение 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": "мехзавод"
  }

• Улица

  # значение settlement_fias_id взято от вышестоящего поля («Населенный пункт») после того, как пользователь выбрал в нем подсказку из списка
  # если бы пользователь не заполнил населенный пункт, вместо settlement_fias_id было city_fias_id
  {
    "locations": [
      {
        "settlement_fias_id": "5e30bb6c-87e7-4550-8f4c-546981a24647"
      }
    ],
    "from_bound": {
      "value": "street"
    },
    "to_bound": {
      "value": "street"
    },
    "restrict_value": true,
    "query": "анжерская"
  }

• Дом

  # значение 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"
  }