POST AI agent ready /v1/elevation/lookup

Elevation API — получение высоты по любым координатам

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

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/elevation/lookup \
  -H "Content-Type: application/json" \
  -d '{"lat":27.9881,"lng":86.925}'

When to use this API

Приложения для походов и планирования маршрутов

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

Оценка риска наводнений

Сравните высоту объекта с высотой близлежащего водного пути. Недвижимость ниже определенного порога относительно ближайшей реки или побережья может быть помечена как более высокий риск наводнения при страховании или анализе недвижимости.

Планирование полета дрона

Рассчитайте высоту местности вдоль траектории полета дрона, чтобы поддерживать безопасную высоту над уровнем земли. В сочетании с обнаружением на воде вы можете идентифицировать водоемы, для которых требуется разная минимальная высота.

Frequently asked questions

Насколько точны данные о высоте?

Данные о высоте поступают от SRTM (Shuttle Radar Topography Mission) с разрешением примерно 30 метров по всему миру. Точность находится в пределах 10-16 метров по вертикали для большинства типов местности. Горные вершины и глубокие долины могут иметь немного более высокую дисперсию.

Могу ли я просмотреть несколько точек одновременно?

Да. Передайте массив объектов { lat, lng } в параметре location, чтобы получить высоту для нескольких точек в одном запросе. Ответ возвращает массив результатов возвышений в том же порядке.

В каких единицах возвращается высота?

Высота всегда возвращается в метрах над средним уровнем моря. Поле единицы подтверждает это. Переведите в футы, умножив на 3,28084.

Работает ли это для океанских локаций?

Конечная точка возвращает данные о высоте земной поверхности. Для местоположений океана высота может возвращать 0 или отрицательное значение, представляющее глубину дна океана, в зависимости от покрытия источника данных.

Каков максимальный размер партии?

Массив location поддерживает до 100 пар координат на запрос. Для больших наборов данных разделите их на несколько запросов.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.