Перенос автоматизации Zapier или Make на новый хост геокодирования
No-code автоматизации с шагом геокодирования требуют иного подхода к миграции, чем собственный код. Вот как провести такой переход.
Переход с OpenCage
OpenCage завоевал аудиторию тем, что сделал геокодирование доступным: один параметр с ключом, JSON-ответ с массивом results и объект components, разбивающий адрес на поля вроде road, city и country. Он объединяет данные из нескольких открытых источников, а не ведёт собственный закрытый набор данных, и отчасти поэтому к нему тянутся разработчики, которым важна прозрачность в том, откуда берутся их данные о местоположении.
Уход от провайдера, выбранного отчасти за простоту, вызывает справедливый вопрос: останется ли всё так же просто с новым вариантом. Честный ответ зависит от того, с чем сравнивать. Регистрация универсального аккаунта с формой оплаты отличается от того, чтобы просто вставить ключ в заголовок, и стоит проверить, что именно вы заменяете.
Совместимый хост My Geocode для OpenCage воспроизводит массив results и разбивку components, которые возвращает OpenCage, и меняются только тексты об авторских правах, условиях и конфиденциальности. Справочник на уровне полей находится по адресу /compatibility/opencage/. Для большинства интеграций это означает обновить хост запроса и значение ключа, а код, читающий results[0].components.city или results[0].formatted, продолжит работать в том виде, в каком он написан.
Аутентификация на нашей стороне принимает заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth или параметр запроса, поэтому клиент, который уже передаёт свой ключ OpenCage как параметр строки запроса, как правило, продолжит работать с новым значением ключа без каких-либо других изменений в логике запроса.
Бесплатный уровень важен в этом сравнении для всех, кто выбрал OpenCage за доступность для небольших и побочных проектов. My Geocode предоставляет 2 500 бесплатных запросов в день с любого адреса вообще без ключа, и каждый ключ также получает 2 500 бесплатных запросов в день с учётом по сети, общих для запросов без ключа и с ключом из этой же сети. Сверх этого действует предоплаченный баланс по 0,0001 € за запрос или ключ Unlimited за 50 € в месяц, и каждый эндпоинт, включая все совместимые хосты, стоит одинаково.
Одно стоит проверить напрямую, а не предполагать: аннотации. Если ваша интеграция с OpenCage читает дополнительные поля аннотаций, например сведения о часовом поясе или валюте, включённые в ответ геокодирования, сверьте документированные поля совместимого хоста с тем, что ожидает ваш код разбора, поскольку часть этих данных, возможно, придётся получать из отдельного эндпоинта, например из собственного определения часового пояса My Geocode, а не из самого ответа геокодирования.
Для проекта, который начинался с малого и вырос, простота, благодаря которой OpenCage был лёгким первым выбором, не обязательно теряется при смене провайдера. Ключ, который работает в любом виде, в каком его уже передаёт ваш клиент, бесплатная дневная квота без регистрации для начала тестирования и одна цена для всех эндпоинтов сохраняют опыт подключения близким к тому, к которому привыкли многие пользователи OpenCage.