Совместимая замена MapQuest Geocoding

И лицензионные, и Open Data эндпоинты геокодирования MapQuest отвечают на mapquest.mygeocode.com, с оболочкой info, options и results и именованием от adminArea1 до adminArea6, которое разбирают клиенты MapQuest.

Измените одно имя хоста

Исходный хост	`www.mapquestapi.com` `open.mapquestapi.com`
Используйте вместо него	`mapquest.mygeocode.com`
Параметр ключа	`key` (необязательно: любой адрес получает 2 500 запросов в день без ключа; укажите здесь свой ключ My Geocode, чтобы пользоваться балансом, пакетами и историей использования)

До

curl "https://www.mapquestapi.com/geocoding/v1/address?key=YOUR_MAPQUEST_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"

После

curl "https://mapquest.mygeocode.com/geocoding/v1/address?key=YOUR_MYGEOCODE_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"

Почему переходят

Бесплатный тариф MapQuest с годами сократился, а его тарифы для разработчиков представляют собой месячные уровни. Здесь вы получаете 2 500 запросов в день бесплатно, а затем оплату за запрос или фиксированную цену.

Та же бесплатная квота, с ключом или без. Запросы к mapquest.mygeocode.com учитываются в тех же 2 500 бесплатных запросах в день, которые ваш адрес или ваш ключ получает на наших собственных эндпоинтах. Сверх этого: предоплаченный баланс по 0,0001 € за запрос или 50 € в месяц за ключ Unlimited. Для регистрации нужен только адрес электронной почты.

Смотреть цены Получить бесплатный ключ

Эндпоинты

Путь на mapquest.mygeocode.com	Что делает	На основе
`/geocoding/v1/address?location=...`	Прямое геокодирование	Прямое геокодирование
`/elevation/v1/profile?latLngCollection=lat,lng,lat,lng` (а также `shapeFormat=cmp`/`cmp6`, `unit=m\|f`, POST с JSON)	Профиль высот	Определение высоты
`/geocoding/v1/reverse?location=lat,lng`	Обратное геокодирование	Обратное геокодирование
`/geocoding/v1/batch?location=...&location=...`	Пакетное геокодирование	Прямое геокодирование

Пример ответа

Вот что возвращает запрос выше. Названия полей, вложенность и типы соответствуют MapQuest. Наши только данные за ними.

Ответ от mapquest.mygeocode.com

{
  "info": {
    "statuscode": 0,
    "copyright": { "text": "My Geocode", "imageUrl": "https://www.mygeocode.com/assets/img/logo.svg", "imageAltText": "My Geocode" },
    "messages": []
  },
  "options": { "maxResults": -1, "thumbMaps": false, "ignoreLatLngInput": false },
  "results": [
    {
      "providedLocation": { "location": "233 S Wacker Dr, Chicago, IL" },
      "locations": [
        {
          "street": "233 S Wacker Dr",
          "adminArea6": "Loop",
          "adminArea6Type": "Neighborhood",
          "adminArea5": "Chicago",
          "adminArea5Type": "City",
          "adminArea4": "Cook County",
          "adminArea4Type": "County",
          "adminArea3": "IL",
          "adminArea3Type": "State",
          "adminArea1": "US",
          "adminArea1Type": "Country",
          "postalCode": "60606",
          "geocodeQualityCode": "P1AAA",
          "geocodeQuality": "POINT",
          "dragPoint": false,
          "sideOfStreet": "R",
          "linkId": "0",
          "unknownInput": "",
          "type": "s",
          "latLng": { "lat": 41.878876, "lng": -87.635918 },
          "displayLatLng": { "lat": 41.878876, "lng": -87.635918 }
        }
      ]
    }
  ]
}

Подробности и отличия

Для первых 2 500 запросов в день ключ не нужен. Чтобы использовать ключ My Geocode, укажите его там, где был ключ MapQuest: в параметре запроса key. Заголовок X-API-Key, Authorization: Bearer и базовая HTTP-аутентификация (ключ в качестве имени пользователя) тоже работают на каждом хосте, поэтому клиентские библиотеки со своим способом аутентификации продолжают работать без изменений.

Строки об авторских правах, названия лицензий, ссылки на условия и политику конфиденциальности в ответе наши, а не исходного провайдера. Всё остальное сохраняет исходную структуру.

Профиль высот принимает latLngCollection в виде необработанных пар или сжатого пути cmp или cmp6, в метрах или футах, методом GET или POST.
Пакетное геокодирование работает с повторяющимися параметрами location= или с отправленным списком locations и возвращает по одной записи на каждый входной элемент.
Пакет принимает до 100 местоположений и считает один запрос на каждое местоположение, как и MapQuest.
Для точек без данных возвращается высота -32768, как и в MapQuest.

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

Другие совместимые хосты

Как работают совместимые хосты, обзор и совместимые замены для библиотек JavaScript.