Автодополнение адресов отличается от обычного запроса геокодирования: оно должно реагировать на частичный, меняющийся ввод, а не на один готовый адрес, обычно по мере того, как человек заполняет поле формы. Мы расширили наши совместимые хосты, чтобы они поддерживали и этот сценарий, повторяя формат запросов автодополнения тех провайдеров, которые его предлагают.
Это дополняет наш собственный эндпоинт /v1/autocomplete, описанный на /docs/address-autocomplete/, который напрямую обрабатывает такие же запросы с частичным адресом. Везде, где исходный провайдер совместимого хоста тоже предлагает автодополнение, тот же формат запроса теперь поддерживается на нашем соответствующем хосте, за исключением текстов об авторских правах, условиях и конфиденциальности, которые у нас свои.
Аутентификация и цены для запросов автодополнения подчиняются точно тем же правилам, что и все остальные типы запросов на платформе. Ключ передаётся в заголовке X-API-Key, в заголовке Authorization: Bearer, через HTTP Basic auth или в параметре запроса, а использование учитывается в том же бесплатном дневном лимите, независимо от того, относится ли этот лимит к сети, с которой идёт вызов, или к самому ключу. Сверх бесплатного лимита запросы автодополнения списываются с предоплаченного баланса по 0,0001 € за запрос или покрываются пакетом Unlimited, точно так же, как для любого другого эндпоинта.
Трафик автодополнения обычно идёт в другом темпе, чем типичный запрос геокодирования: запросы часто отправляются при каждом нажатии клавиши, пока человек вводит адрес в форму, а не один раз при отправке готового адреса. Поэтому прозрачность квоты здесь особенно полезна: те же заголовки квоты, которые прикрепляются к каждому ответу, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining и остальные, позволяют интеграции следить за расходом в реальном времени и менять поведение, например агрессивнее применять задержку запросов (debounce), если использование выше ожидаемого.
Для команд, которые уже используют совместимый хост для геокодирования, а автодополнение отдельно обрабатывают через другого провайдера или вторую интеграцию, это обновление означает, что автодополнение теперь, возможно, тоже удастся перенести на тот же хост и тот же ключ, объединив оба типа запросов в одном аккаунте, а не разделяя их между двумя.
Поддерживает ли совместимый хост автодополнение, зависит от того, поддерживает ли его исходный провайдер, а подробности по каждому хосту описаны на его собственной странице, на которую можно перейти из полного списка на /compatibility/. Проверить автодополнение на совместимом хосте ничего не стоит благодаря бесплатному лимиту, доступному для любого нового ключа.