Совместимая замена других API геокодирования
Смена провайдера геокодирования обычно означает переписывание кода, который разбирает ответы. Нам бы хотелось, чтобы вам не пришлось этого делать. Каждый хост ниже принимает пути и параметры API одного провайдера и отвечает в JSON-формате этого провайдера, но с нашими данными. Измените имя хоста, укажите свой ключ My Geocode там, где был старый, и запускайте. Для бесплатного ключа нужны ваше имя, адрес электронной почты и минута времени.
Найдите своего провайдера ниже
На каждой странице указаны исходный хост, хост замены и все поддерживаемые пути.
Измените хост в конфигурации
Например,
maps.googleapis.comпревращается вgapi.mygeocode.com. Пути и параметры остаются прежними.Замените ключ
Укажите свой ключ My Geocode в том же параметре, в котором был старый ключ. Бесплатный ключ даёт 2 500 запросов в день.
REST-хосты
Платформа Google Maps
maps.googleapis.com → gapi.mygeocode.comВеб-сервисы Geocoding, Places Autocomplete, Time Zone и Elevation отвечают по тем же путям на gapi.mygeocode.com, с той же структурой JSON, что возвращает Google.
Эндпоинты и формат ответаREST-сервисы Bing Maps
dev.virtualearth.net → bing.mygeocode.comMicrosoft прекращает поддержку Bing Maps for Enterprise.
Эндпоинты и формат ответаГеокодирование и поиск HERE
geocode.search.hereapi.com, revgeocode.search.hereapi.com, autosuggest.search.hereapi.com, autocomplete.search.hereapi.com → here.mygeocode.comHERE распределяет свой поисковый API по нескольким хостам.
Эндпоинты и формат ответаMapbox Geocoding
api.mapbox.com → mapbox.mygeocode.comИ старый Geocoding API v5, и актуальные эндпоинты v6 отвечают на mapbox.mygeocode.com.
Эндпоинты и формат ответаGeocode.Farm
api.geocode.farm, www.geocode.farm → farm.mygeocode.comЭндпоинты прямого и обратного геокодирования Geocode.Farm, в стилях URL как v3, так и v4, отвечают на farm.mygeocode.com.
Эндпоинты и формат ответаOpenStreetMap Nominatim
nominatim.openstreetmap.org → osm.mygeocode.comПубличный сервер Nominatim просит отправлять не более одного запроса в секунду и не нагружать его интенсивно.
Эндпоинты и формат ответаOpenCage
api.opencagedata.com → opencage.mygeocode.comOpenCage использует один эндпоинт для прямого и обратного геокодирования и возвращает подробный блок annotations.
Эндпоинты и формат ответаLocationIQ
us1.locationiq.com, eu1.locationiq.com → locationiq.mygeocode.comЭндпоинты поиска, обратного геокодирования, автодополнения и часовых поясов LocationIQ отвечают на locationiq.mygeocode.com.
Эндпоинты и формат ответаGeoapify
api.geoapify.com → geoapify.mygeocode.comЭндпоинты геокодирования Geoapify возвращают GeoJSON FeatureCollection с плоским объектом properties.
Эндпоинты и формат ответаTomTom Search
api.tomtom.com → tomtom.mygeocode.comЭндпоинты Geocode, Reverse Geocode и Fuzzy Search от TomTom отвечают на tomtom.mygeocode.com с той же структурой summary и results, включая поле freeformAddress, которое показывает большинство интеграций.
Эндпоинты и формат ответаMapQuest Geocoding
www.mapquestapi.com, open.mapquestapi.com → mapquest.mygeocode.comИ лицензионные, и Open Data эндпоинты геокодирования MapQuest отвечают на mapquest.mygeocode.com, с оболочкой info, options и results и именованием от adminArea1 до adminArea6, которое разбирают клиенты MapQuest.
Эндпоинты и формат ответаGeocodio
api.geocod.io → geocodio.mygeocode.comGeocodio ориентирован на США и Канаду.
Эндпоинты и формат ответаPositionStack
api.positionstack.com → positionstack.mygeocode.comЭндпоинты прямого и обратного геокодирования PositionStack отвечают на positionstack.mygeocode.com с тем же массивом data и плоскими названиями полей.
Эндпоинты и формат ответаip-api.com
ip-api.com, pro.ip-api.com → ipapi.mygeocode.comJSON-эндпоинт ip-api является одним из самых копируемых форматов определения IP.
Эндпоинты и формат ответаipinfo.io
ipinfo.io → ipinfo.mygeocode.comКомпактный JSON ipinfo со строкой loc и строкой org с префиксом в виде номера AS воспроизводится на ipinfo.mygeocode.com.
Эндпоинты и формат ответаipstack
api.ipstack.com → ipstack.mygeocode.comСтандартный эндпоинт поиска и эндпоинт check от ipstack отвечают на ipstack.mygeocode.com с теми же полями верхнего уровня и объектом location, по HTTPS на любом тарифе.
Эндпоинты и формат ответаOpen-Elevation
api.open-elevation.com → openelevation.mygeocode.comПубличный сервер Open-Elevation является волонтёрским проектом без гарантий доступности.
Эндпоинты и формат ответаБиблиотеки JavaScript
Тот же подход работает для картографических библиотек и библиотек геокодирования. Загрузите Google Maps JavaScript API с gapi.mygeocode.com, и google.maps.Map, Geocoder и places.Autocomplete продолжат работать с нашими тайлами и данными, без платы за загрузку карт. Есть загрузчики для элемента управления Bing Maps V8, HERE Maps for JavaScript и MapQuest.js, а также конфигурация для MapLibre и Mapbox GL с mapbox-gl-geocoder и для плагинов геокодирования Leaflet.
Совместимые JavaScript-библиотеки Полный справочник и чек-лист миграции
Что совпадает, а что нет
Совпадает
- Пути, параметры запроса и HTTP-методы, задокументированные провайдером.
- Структура ответа: названия полей, вложенность, массивы, типы и порядок координат.
- Словари статусов, например
OKиZERO_RESULTSу Google илиstatusCodeу Bing. - Формат ошибок, поэтому ваша существующая обработка ошибок продолжит работать.
- Цены. Запрос к совместимому хосту стоит столько же, сколько запрос к нашему собственному эндпоинту, и расходует ту же квоту ключа.
Отличается
- Данные. Координаты, отформатированные адреса и значения уверенности наши, поэтому они не будут совпадать с данными исходного провайдера до последней цифры.
- Идентификаторы. ID мест наши и стабильны, но их нельзя передать исходному провайдеру.
- Функции за пределами геокодирования, IP, часовых поясов и высоты, такие как построение маршрутов, сведения о местах и фотографии, не включены. На каждой странице указано, чего не хватает.
- Ключи. Ключ с оплатой по мере использования работает с двух IP-адресов в скользящем окне 24 часа, а ключ Unlimited с трёх, как и на наших собственных эндпоинтах. Для больших парков используйте больше ключей или пакетов.
Вашего провайдера нет в списке?
Добавление совместимого хоста занимает несколько дней, если формат провайдера задокументирован. Если вы пользуетесь сервисом, которого здесь нет, сообщите нам, каким именно, и примерно сколько запросов в день вы отправляете.