My Geocode

Миграция

Переход с Geoapify

· 3 мин чтения · My Geocode · #geoapify#migration#geocoding#compatibility#api-keys

Geoapify объединяет геокодирование с API маршрутизации, мест и стилей карт под одним параметром apiKey, что удобно командам, которые хотят управлять несколькими функциями местоположения из одного аккаунта. Его ответы геокодирования имеют структуру, похожую на GeoJSON, с массивом features, где каждый элемент содержит properties для полей адреса и geometry для координат.

Поскольку Geoapify охватывает не только геокодирование, уход с него редко бывает по принципу «всё или ничего». Стоит осознанно определить объём: переносите ли вы все функции местоположения сразу или только вызовы геокодирования, пока оставляя маршрутизацию или стили карт на Geoapify. Оба варианта разумны, но требуют разного объёма работы, а если перепутать их посреди проекта, обычно возникает путаница с тем, какой ключ аутентифицирует какой запрос.

My Geocode представляет собой API для геокодирования, определения IP, часовых поясов, высоты и поиска почтовых индексов, поэтому он напрямую заменяет именно часть интеграции Geoapify, связанную с геокодированием. Совместимый хост Geoapify воспроизводит массив features и вложенные в него поля properties и geometry, меняя в ответе только текст об авторских правах, условиях и конфиденциальности. Описание полей на странице /compatibility/geoapify/.

Для вызовов геокодирования переход означает:

  • Направить запрос на новый хост вместо хоста Geoapify
  • Отправлять ключ My Geocode вместо apiKey Geoapify тем из четырёх поддерживаемых способов, который уже использует ваш клиент (X-API-Key, Authorization: Bearer, HTTP Basic auth или параметр запроса)
  • Оставить без изменений код, который читает features[0].properties и features[0].geometry.coordinates

Если маршрутизация или поиск мест пока остаются на Geoapify, там ничего не меняется: совместимый хост геокодирования работает независимо и не требует переносить остальной стек одновременно.

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

Дополнительные данные (высота рельефа, сведения об угрозах для IP и информация о сети) доступны на совместимом хосте геокодирования при добавлении mg_extras=1 или заголовка X-MG-Extras. Это полезно знать, если одной из причин выбора пакетного поставщика было желание получать больше одного вида данных за один вызов.

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

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