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

Эндпоинты геокодирования Geoapify возвращают GeoJSON FeatureCollection с плоским объектом properties. geoapify.mygeocode.com возвращает то же самое, включая блоки rank и datasource, а также поддерживает эндпоинт IP info.

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

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

До

curl "https://api.geoapify.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_GEOAPIFY_KEY"

После

curl "https://geoapify.mygeocode.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_MYGEOCODE_KEY"

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

Бесплатный тариф Geoapify даёт 3 000 кредитов в день с обязательным указанием авторства. Здесь это 2 500 запросов в день на ключ без требования указывать авторство, а у платного использования нет месячного уровня, из которого можно вырасти.

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

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

Эндпоинты

Путь на geoapify.mygeocode.com	Что делает	На основе
`/v1/geocode/search?text=...`	Прямое геокодирование	Прямое геокодирование
`/v1/geocode/reverse?lat=...&lon=...`	Обратное геокодирование	Обратное геокодирование
`/v1/geocode/autocomplete?text=...`	Автодополнение	Автодополнение адресов
`/v1/ipinfo?ip=...`	Геолокация по IP	Определение IPv4

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

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

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

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "datasource": { "sourcename": "mygeocode", "attribution": "My Geocode", "license": "https://www.mygeocode.com/terms/" },
        "country": "Netherlands",
        "country_code": "nl",
        "state": "North Holland",
        "city": "Amsterdam",
        "postcode": "1012 JS",
        "street": "Dam",
        "housenumber": "1",
        "lon": 4.893604,
        "lat": 52.373119,
        "formatted": "Dam 1, 1012 JS Amsterdam, Netherlands",
        "address_line1": "Dam 1",
        "address_line2": "1012 JS Amsterdam, Netherlands",
        "result_type": "building",
        "rank": { "importance": 0.41, "confidence": 1, "confidence_city_level": 1, "confidence_street_level": 1, "match_type": "full_match" },
        "place_id": "mg.nl.addr.c21d40e8"
      },
      "geometry": { "type": "Point", "coordinates": [4.893604, 52.373119] },
      "bbox": [4.893004, 52.372719, 4.894204, 52.373519]
    }
  ],
  "query": {
    "text": "Dam 1 Amsterdam",
    "parsed": { "housenumber": "1", "street": "dam", "city": "amsterdam", "expected_type": "building" }
  }
}

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

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

Ответы содержат те поля, которые возвращает Geoapify, и ничего больше, поэтому ответ можно передать коду, который уже разбирает Geoapify. Наши дополнительные данные (высота рельефа, угрозы и сведения о сети) доступны по запросу: добавьте mg_extras=1 в запрос или отправьте X-MG-Extras: 1.

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

Эндпоинт IP возвращает объект в собственной структуре Geoapify.
Пакетное геокодирование работает так же, как у Geoapify: POST /v1/batch/geocode/search или /reverse с JSON-массивом до 1 000 элементов отвечает 202 с id задания и url, а GET по этому url возвращает по одной строке на элемент с его query. Каждый адрес считается одним запросом; получение результата не учитывается.

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

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

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