Следите за использованием ключа, пока не упёрлись в лимит
Наблюдение за заголовками квоты по ходу работы показывает приближение к лимиту задолго до того, как запрос будет отклонён.
Как правильно читать оценку достоверности, прежде чем ей доверять
Значение уверенности от 0.0 до 1.0 в результате геокодирования выглядит как простой сигнал «прошёл или не прошёл», но при таком подходе упускается то, что оно на самом деле измеряет.
Что измеряет уверенность
Уверенность отражает, насколько сопоставление уверено, с учётом введённого текста, что именно этот результат и имелся в виду. Высокая оценка уверенности для неоднозначного или странно оформленного запроса по-прежнему означает, что система уверена в своём лучшем предположении, а не что ввод был заведомо правильным или что место заведомо существует в описанном виде.
GET /v1/forward?q=Main Street, Springfield&limit=1{
"status": "ok",
"query": "Main Street, Springfield",
"results": [
{"formatted": "Main Street, Springfield, IL", "lat": 39.7817, "lon": -89.6501, "type": "address", "precision": "street", "confidence": 0.62, "place_id": "sp901", "components": {}}
]
}Уверенность 0.62 здесь отражает то, что название Springfield носят многие города, поэтому даже правильное сопоставление с одним конкретным Springfield несёт некоторую неизбежную неопределённость в том, тот ли это Springfield, который имелся в виду.
Уверенность и точность
Это два разных поля, измеряющих две разные вещи. Точность описывает, насколько конкретно сопоставление: дом, улица или более грубый уровень. Уверенность описывает, насколько система уверена в сделанном сопоставлении. Результат с точностью «house» может иметь умеренную оценку уверенности, если ввод был неоднозначен в отношении того, какой дом на какой улице имеется в виду, а результат с точностью «street» может иметь высокую оценку уверенности, если сопоставление, хоть и грубое, было однозначным.
Выбор порога
Выбирайте порог уверенности исходя из того, во что вам обойдётся неверный результат. Порог 0.8 или выше имеет смысл для автоматизированных действий с серьёзными последствиями, например автоматического заполнения транспортной этикетки без проверки человеком. Более низкий порог разумен там, где человек проверяет результат впоследствии, например для подсказки, которую клиент должен подтвердить.
Сочетание с параметром countries
Неоднозначные сопоставления, как в примере со Springfield выше, часто разрешаются сужением поиска с помощью параметра countries, если вы уже знаете, в какой стране должен находиться адрес. Это повышает шансы получить сопоставление с высокой уверенностью с первой попытки, без повторного запроса.
Стоимость остаётся прежней
Правильное чтение уверенности не меняет стоимости запроса, это по-прежнему один запрос. Меняется другое: действуете ли вы на основе результата с должной степенью доверия.
Уверенность это конкретный, узкий сигнал, а не общая гарантия правильности, и если читать её именно так, вы не будете слишком поспешно действовать на основе шаткого сопоставления. Полные определения полей приведены в документации по прямому геокодированию.