Пока человек не выбрал конкретную подсказку, «Подсказки» используют справочник адресов налоговой службы (ФИАС). В нём нет индексов для некоторых адресов, нет координат, часового пояса, станций метро и другой дополнительной информации.
Когда же человек выбирает конкретную подсказку, «Подсказки» возвращают всю информацию об адресе из дополнительных справочников — в том числе координаты, часовой пояс, ближайшее метро, и так далее.
Пока пользователь вводит адрес, но окончательно не определился, следует отправлять запросы с параметром 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 должен быть результатом одного из предыдущих запросов (значением поля unrestricted_value):
{ "query": "125080, г Москва, ул Панфилова, д 6", "count": 1 } |
В ответе на такой запрос будет вся информация по адресу — в том числе координаты, часовой пояс, ближайшее метро, и так далее.
Запрос с count = 1 должен делаться в единственном случае — когда пользователь выбрал конкретную подсказку из списка. Любые ограничения (locations, from_bound и тому подобное) в таком запросе игнорируются.