Не каждый вопрос о местоположении на самом деле является вопросом геокодирования. Иногда приложению нужен только почтовый индекс для определённой территории или территория, которую охватывает определённый индекс, без более широкого разбора адреса, который дают прямое и обратное геокодирование. /v1/postcode существует именно для этого более узкого вопроса, как отдельный эндпоинт, а не побочный эффект более общего поиска.
Отделение его от /v1/forward и /v1/reverse важно по нескольким практическим причинам. Формат запроса можно построить именно вокруг параметров почтового индекса, а не адаптировать из более широкой структуры адреса. Ответ может содержать именно то, что нужно интеграции, работающей только с индексами, без лишних полей адреса, которые пришлось бы отфильтровывать. А документация, полностью доступная на странице /docs/postal-code-lookup/, может описывать поведение почтовых индексов как самостоятельную тему, а не как подраздел длинного руководства по геокодированию.
Аутентификация подчиняется тем же правилам, что и во всех остальных эндпоинтах: заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth с ключом в качестве имени пользователя или параметр запроса, и все эти способы принимаются одинаково. Цены тоже те же: используется та же бесплатная дневная квота, будь то квота вызывающей сети или ключа, а сверх неё те же 0,0001 € за запрос с предоплаченного баланса или покрытие пакетом Unlimited.
Пакетные запросы работают здесь так же, как и везде на платформе: каждый почтовый индекс или адрес, переданный в одном вызове, считается одним запросом, а не весь вызов целиком. Команда, проверяющая почтовые индексы в большом списке клиентов, может отправить этот список пакетом и рассчитывать на тот же поштучный учёт, что и для любой другой пакетной операции в My Geocode.
Отдельный эндпоинт также делает работу с почтовыми индексами в наших семнадцати совместимых хостах точнее, поскольку провайдеров, у которых есть собственный отдельный поиск индексов, можно воспроизвести точно, а не приблизительно через более широкий формат геокодирования.
Если вашему приложению нужна только информация о почтовом индексе и раньше оно отправляло более общие запросы геокодирования лишь для того, чтобы извлечь это одно поле, стоит сразу перейти на /v1/postcode. Он полностью описан на странице /docs/postal-code-lookup/, вместе с остальным справочником по эндпоинтам на странице /docs/.