My Geocode

Миграция

Переход с Geocodio

· 2 мин чтения · My Geocode · #geocodio#migration#geocoding#bulk-geocoding#compatibility

Geocodio заработал прочную репутацию именно благодаря точности адресов в США и Канаде, а также процессу пакетной загрузки CSV, который позволяет геокодировать таблицу адресов вообще без написания кода интеграции. Его API-ключ передаётся как параметр запроса (api_key), а ответы для одного адреса возвращаются с массивом results, содержащим address_components, и полем accuracy, описывающим уверенность совпадения.

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

Для программной части совместимый хост Geocodio в My Geocode воспроизводит массив results и структуру address_components, которые возвращает Geocodio, и единственное, что меняется, это текст об авторских правах, условиях и конфиденциальности. Справочные сведения на странице /compatibility/geocodio/. Код, читающий results[0].address_components.city, должен продолжить работать после замены хоста и ключа.

Несколько моментов, которые стоит заранее продумать именно из-за региональной направленности Geocodio:

  • Если ваша интеграция опирается на какие-либо дополнительные поля, специфичные для США, например сведения об избирательном округе Конгресса, проверьте, входит ли этот показатель в объём миграции или в дальнейшем для него потребуется отдельный поиск
  • Выясните, не работают ли какие-либо пакетные задания с лимитом запросов, настроенным именно под задокументированные лимиты Geocodio, поскольку время повторных попыток, рассчитанное на цифры одного поставщика, не обязательно подходит для другого
  • Прежде чем считать, что всё полностью совпадает, протестируйте на новом хосте пакет реальных исторических адресов из ваших собственных данных, особенно особые случаи вроде абонентских ящиков или адресов на сельских маршрутах

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

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

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