My Geocode

Миграция

Переход с Geocode.Farm

· 2 мин чтения · My Geocode · #geocode-farm#migration#geocoding#compatibility#api-keys

Geocode.Farm не самое известное имя в геокодировании, его часто выбирают команды, которым нужен простой вариант без излишеств, а не крупная корпоративная платформа. Его API-ключ аутентифицирует запросы, передаваемые в параметрах запроса, а JSON-ответы содержат объект geometry с координатами местоположения и поле accuracy, указывающее уверенность совпадения, в структуре, которая остаётся достаточно плоской по сравнению с некоторыми крупными поставщиками.

У небольшого поставщика есть особый мотив для миграции, который стоит назвать прямо: команды иногда уходят от небольшого поставщика не потому, что что-то пошло не так, а потому, что хотят уверенности платформы с более широким набором вариантов совместимости и более понятной долгосрочной дорожной картой, особенно когда проект, начинавшийся с малого, начинает обрабатывать заметно больше трафика или более критичные для бизнеса процессы.

Совместимый хост Geocode.Farm в My Geocode воспроизводит структуру полей geometry и accuracy, которую возвращает Geocode.Farm, и единственное, что меняется в ответе, это текст об авторских правах, условиях и конфиденциальности. Справочник полей на странице /compatibility/geocode-farm/. Коду приложения, построенному вокруг этого формата ответа, для продолжения работы должно хватить замены хоста и ключа.

Что стоит проверить именно для этой миграции:

  • Обрабатывает ли ваша интеграция ошибки превышения лимита запросов логикой, настроенной на конкретные ответы Geocode.Farm, поскольку форматы ошибок у разных поставщиков различаются, а для этой платформы они описаны на странице /docs/errors/
  • Не встроен ли сейчас ваш ключ прямо в код приложения, а не в конфигурацию: это стоит исправить во время переезда, куда бы вы ни переходили
  • Используете ли вы Geocode.Farm также для обратного геокодирования, поскольку схема таких запросов отличается от прямого геокодирования и заслуживает отдельного прохода тестирования

Аутентификация принимает заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth или параметр запроса, что покрывает любой способ, который уже использует ваш текущий клиент Geocode.Farm.

Что касается цен, переход от небольшого, более специализированного поставщика к более широкой платформе здесь не означает более сложной структуры затрат. Доступно 2 500 бесплатных запросов в день без ключа, ещё 2 500 бесплатных в день на каждый ключ с учётом по сети, а сверх этого предоплаченный баланс по 0,0001 € за запрос или ключ Unlimited за 50 € в месяц, причём все эндпоинты, включая этот совместимый хост, стоят одинаково. Поскольку всего My Geocode поддерживает 17 совместимых хостов, команда, уходящая от небольшого поставщика, также получает возможность позже сравнить форматы ответов других поставщиков бок о бок, не открывая для этого второй аккаунт где-то ещё.

Ещё в разделе «Миграция»