My Geocode

Миграция

Отказ от статических карт и тайлов Mapbox, если нужно только геокодирование

· 3 мин чтения · My Geocode · #mapbox#геокодирование#миграция#тайлы#статические-карты

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

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

My Geocode это API для геокодирования, определения IP, часового пояса, высоты и почтового индекса. Он не отрисовывает тайлы карт или статические изображения карт, поэтому заменяет не эту часть интеграции с Mapbox, а только поиск адресов. Его совместимый хост для Mapbox воспроизводит структуру GeoJSON FeatureCollection, которую возвращает Mapbox Geocoding, включая поля center, place_name и context, и единственное отличие составляют тексты об авторских правах, условиях и конфиденциальности. Справочные сведения находятся по адресу /compatibility/mapbox/.

Практические шаги по разделению:

  • Найдите в кодовой базе все места, где читается токен доступа Mapbox, и определите, выполняет ли конкретное место вызова геокодирование, отрисовку тайлов или и то, и другое, поскольку некоторые функции-обёртки исторически объединяют поиск адреса с предпросмотром карты в одном вызове
  • Переведите вызовы, относящиеся к геокодированию, на отдельный ключ и отдельный хост, а вызовы тайлов и статических карт оставьте направленными на Mapbox с их текущим токеном без изменений
  • Убедитесь, что фронтенд-компонент карты не предполагает, что результат геокодирования и тайлы карты используют одну и ту же систему координат или проекцию; проблемы с этим бывают редко, но быстрая проверка не помешает

Аутентификация для совместимого хоста геокодирования работает с ключом в виде X-API-Key, Authorization: Bearer, HTTP Basic auth или параметра запроса. Доступно 2 500 бесплатных запросов в день без ключа, ещё 2 500 бесплатных на каждый ключ в день с учётом по сети, затем предоплаченный баланс по 0,0001 € за запрос или ключ Unlimited за 50 € в месяц, по одной ставке для каждого эндпоинта, включая этот.

Параллельная работа с двумя провайдерами, одним для отрисовки карт и другим для поиска адресов, это стабильная долгосрочная схема, а не временное состояние, от которого нужно избавиться. Многие рабочие приложения намеренно распределяют картографию и геокодирование между разными поставщиками, поскольку у этих двух возможностей разные факторы затрат и разные технические требования, и нет никакой обязанности объединять их в одном аккаунте только потому, что так было изначально.

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