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

Geocodio ориентирован на США и Канаду. geocodio.mygeocode.com отвечает на его эндпоинты geocode и reverse в той же структуре и принимает адреса по всему миру.

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

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

До

curl "https://api.geocod.io/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_GEOCODIO_KEY"

После

curl "https://geocodio.mygeocode.com/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_MYGEOCODE_KEY"

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

Тот же интерфейс, покрытие по всему миру и никаких ценовых уровней за запрос, за которыми нужно следить.

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

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

Эндпоинты

Путь на geocodio.mygeocode.com	Что делает	На основе
`/v1.7/geocode?q=...`	Прямое геокодирование	Прямое геокодирование
`/v1.7/reverse?q=lat,lng`	Обратное геокодирование	Обратное геокодирование
`/v1.7/geocode (POST, JSON array)`	Пакетное прямое геокодирование	Прямое геокодирование

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

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

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

{
  "input": {
    "address_components": {
      "number": "1109",
      "predirectional": "N",
      "street": "Highland",
      "suffix": "St",
      "formatted_street": "N Highland St",
      "city": "Arlington",
      "state": "VA",
      "country": "US"
    },
    "formatted_address": "1109 N Highland St, Arlington, VA"
  },
  "results": [
    {
      "address_components": {
        "number": "1109",
        "predirectional": "N",
        "street": "Highland",
        "suffix": "St",
        "formatted_street": "N Highland St",
        "city": "Arlington",
        "county": "Arlington County",
        "state": "VA",
        "zip": "22201",
        "country": "US"
      },
      "formatted_address": "1109 N Highland St, Arlington, VA 22201",
      "location": { "lat": 38.886665, "lng": -77.094733 },
      "accuracy": 1,
      "accuracy_type": "rooftop",
      "source": "My Geocode"
    }
  ]
}

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

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

Пакетные запросы работают: отправьте JSON-список или объект. Ответом будет results с одной записью на каждый входной элемент, и в каждой указан исходный query (ключ объекта, если вы отправили объект) и собственный response.
Обратные пакеты имеют ту же структуру, а на входе строки lat,lon.
Пакет принимает до 10 000 записей, как и Geocodio, и каждая запись считается одним запросом, как их считает Geocodio. Пакет, превышающий остаток дневной квоты, отклоняется целиком с ошибкой Geocodio, а не обрабатывается частично.

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

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

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