Новости

Запущена совместимость с Open-Elevation

Open-Elevation давно служит простым способом без излишеств привязать высоту рельефа к набору координат. Наш совместимый хост берёт ту же структуру запросов и ответов и ставит за ней полностью рабочий сервис высот, а также структуру квот, которая точно показывает, сколько вы израсходовали.

Хост в точности воспроизводит параметры запросов и тело ответа Open-Elevation, за исключением текста об авторских правах, условиях и конфиденциальности, который принадлежит нам, а не исходному провайдеру. Отправьте набор координат так, как вы уже отправляете их в Open-Elevation, и значения высоты вернутся в той же структуре JSON, которую сегодня разбирает ваш существующий код.

Поскольку наш эндпоинт высоты полностью рабочий, речь идёт не только о совпадении структуры. Запросите координаты места, и ответ вернёт реальное значение высоты в метрах, так же как это делает /v1/elevation напрямую. Пакетные запросы работают так же, и каждая пара координат считается одним запросом, а не весь вызов целиком.

Аутентификация принимает наши обычные четыре способа: заголовок X-API-Key, заголовок Authorization: Bearer, HTTP Basic auth с ключом в качестве имени пользователя или параметр запроса. Поскольку Open-Elevation часто используют вообще без аутентификации, добавление ключа здесь также означает, что вы получаете выделенную, отслеживаемую квоту вместо того, чтобы полагаться на общий, никем не управляемый ресурс.

Цены такие же, как на всех остальных хостах платформы. Любой адрес получает 2 500 бесплатных запросов в день без всякого ключа, с подсчётом по сети. Ключ добавляет свои 2 500 бесплатных запросов в день. Сверх обеих квот предоплаченный баланс стоит 0,0001 € за запрос, или пакет Unlimited покрывает использование за 50 € в месяц.

Заголовки квот сопровождают каждый ответ: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used и X-Credits-Remaining присутствуют все, давая надёжную картину объёма запросов высоты, которую общий публичный экземпляр обычно не предоставляет.

Для всего, что выходит за рамки стандартного ответа о высоте, mg_extras=1 в запросе или заголовок X-MG-Extras добавляет поверх совместимой структуры необязательные дополнения, исключительно по вашему выбору.

Хост описан на /compatibility/open-elevation/, а лежащий в его основе эндпоинт высоты полностью описан на /docs/elevation-lookup/. Если запросы высоты сегодня входят в картографическую функцию или функцию маршрутизации, это простой способ получить выделенную квоту при той же структуре запросов.