Проблема API-ключей, которые никогда не истекают
Ключ, выданный много лет назад, ни разу не заменённый и до сих пор действующий, это не удобство. Это риск, на который никто не смотрел уже много лет.
Продуктовые приоритеты проявляются в структуре цен и глубине документации задолго до того, как появляется какое-либо явное заявление о том, что важнее всего. Эндпоинт, спрятанный в младшем тарифе или описанный тремя предложениями рядом с подробнейшей страницей о флагманской функции, сообщает реальный факт о внутренних приоритетах, независимо от того, собирался ли кто-то это сообщать. Поиск по почтовому индексу часто становится жертвой этой закономерности: технически он доступен, в него редко вкладываются, и к нему относятся как к второстепенной утилите по сравнению с полноценным геокодированием.
Мы намеренно установили для поиска по почтовому индексу ту же цену, что и для всех остальных эндпоинтов, именно чтобы избежать такого тихого понижения в статусе. Он покрывается той же бесплатной суточной квотой, сверх неё оплачивается по той же цене 0,0001 € за запрос или входит в тот же ключ Unlimited за 50 €, точно так же, как геокодирование, определение IP, часовой пояс или высота. Нет ни тарифа со скидкой, который давал бы понять, что поиск по индексу считается менее ценным, ни премиального тарифа, который говорил бы об обратном. Он находится на том же уровне, что и всё остальное, потому что мы считаем, что так и должно быть.
Одинаковая цена является отправной точкой, а не всем аргументом. Более глубокая причина, по которой поиск по почтовому индексу заслуживает статуса полноценной функции, в том, что сами данные действительно требуют такого же серьёзного отношения, как и любые другие геоданные. Почтовые системы не являются упрощённой версией геокодирования. Это отдельная категория структур, которая различается от страны к стране по формату, по размеру территории, охватываемой одним индексом, и по тому, насколько прямо индекс соответствует административным границам. Чтобы правильно реализовать это для множества стран, нужно реальное и постоянное внимание, то самое, которое флагманская функция геокодирования получает по умолчанию, потому что её заранее считают важной.
Относиться к эндпоинту как к полноценному означает также применять к нему тот же стандарт документации: реальные примеры, чёткое описание того, какие данные возвращаются и как они структурированы, и честные примечания об ограничениях покрытия по странам вместо расплывчатого общего заявления. Эндпоинт, скупо задокументированный потому, что его считают простым, как правило, остаётся простым именно в тех отношениях, которые важны, потому что никто не присматривается к нему достаточно внимательно, чтобы заметить, где он не дотягивает.
У этого есть и практическая польза помимо справедливого распределения инженерного внимания. Многие реальные приложения, например калькуляторы доставки, проверки налоговой юрисдикции и проверки зоны обслуживания, зависят от правильного определения почтового индекса больше, чем от полного геокодирования до уровня улицы. Отношение к поиску по индексу как к второстепенной функции по сравнению с геокодированием переворачивает реальную зависимость с ног на голову именно для тех приложений, которым эти данные нужнее всего. Одинаковая цена и одинаковая документация не являются символическим жестом. Это скорее исправление категориальной ошибки, которую остальная отрасль в основном унаследовала, не задумываясь.