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

Если работать с подсказками через jQuery-плагин

Пока человек не выбрал конкретную подсказку, «Подсказки» используют справочник адресов налоговой службы (ФИАС). В нём нет индексов для некоторых адресов, нет координат, часового пояса, станций метро и другой дополнительной информации.

Когда же человек выбирает конкретную подсказку, «Подсказки» возвращают всю информацию об адресе из дополнительных справочников — в том числе координаты, часовой пояс, ближайшее метро, и так далее.

Если работать с подсказками через API

Пока пользователь вводит адрес, но окончательно не определился, следует отправлять запросы с параметром count > 1:

{ "query": "москва панфилова", "count": 5 }

В ответах на такие запросы будет только базовая информацию по адресу: без координат, часового пояса, станций метро и других полей, которых нет в справочнике налоговой (ФИАС). Это нормально:

...
"value": "г Москва, ул Панфилова",
"unrestricted_value": "125080, г Москва, ул Панфилова, д 6",
...
"timezone": null,
"geo_lat": null,
"geo_lon": null,
"beltway_hit": null,
"beltway_distance": null,
"metro": null,
...


Запросы с count > 1 возвращают результат, даже если «Подсказки» не уверены в разборе адреса, который ввел человек. Например, «москва панфилова, дом за углом» вернет «г Москва, ул Панфилова».

Когда пользователь выбрал конкретную подсказку из списка, следует отправить запрос с параметром count = 1. Текст запроса при count = 1 должен быть результатом одного из предыдущих запросов (значением поля unrestricted_value):

{ "query": "125080, г Москва, ул Панфилова, д 6", "count": 1 }

В ответе на такой запрос будет вся информация по адресу — в том числе координаты, часовой пояс, ближайшее метро, и так далее.

Запрос с count = 1 возвращает результат, только если «Подсказки» уверены в разборе адреса, который ввел человек:

  • «125080, г Москва, ул Панфилова» вернет результат,
  • а «125080, г Москва, ул Панфилова, дом за углом» — нет.

Запрос с count = 1 должен делаться в единственном случае — когда пользователь выбрал конкретную подсказку из списка. Любые ограничения (locations, from_bound и тому подобное) в таком запросе игнорируются.

  • No labels