Возможности сервиса
Высоты по области
Запрос высот по bbox-области, формат ответа совместим с OpenTopography (AAIGrid / GeoTIFF).
Высота в точке
Быстрый точечный запрос высоты по координатам — для одиночных вычислений и валидации.
Покрытие NASADEM
Данные NASADEM 30 м/пиксель, покрытие территории России 41°N–66°N.
Эндпоинты API
| Эндпоинт | Назначение |
|---|---|
/v1/dem/globaldem | Высоты по области (bbox), формат ответа совместим с OpenTopography |
/v1/dem/point | Высота в конкретной точке по координатам |
Базовый адрес: https://elevationmap.ru — ключ передаётся заголовком
или параметром API_Key.
curl -H "API_Key: ot_free_KfgNV0InkzklC7ASpX9bgdzX-wvjXWt5VJUNi6wxuhU" \
"https://elevationmap.ru/v1/dem/point?lat=55.7539&lon=37.6208"
{
"latitude": 55.7539,
"longitude": 37.6208,
"elevation": 155.0,
"unit": "meters",
"source": "ElevationMap.ru",
"resolution": "30m"
}
- Демо-ключ общий для всех и ограничен 50 запросами/день — только чтобы попробовать API без регистрации. Для продакшена выдаётся отдельный именной ключ с вашей квотой (см. тарифы ниже).
lat,lon— десятичные градусы, WGS84. Разрешение данных ~30 м (≈ 0.0003°) — точность координат свыше 4–5 знаков после запятой избыточна.
Как безопасно использовать ключ
Ключ — это как пароль: у кого он есть, тот расходует вашу квоту. Как его защищать, зависит от того, откуда вы его вызываете.
- Вызов с вашего сервера (бэкенд → наш API): ключ никогда не попадает к конечному пользователю — храните его как обычный секрет (переменная окружения, не коммитить в git) и всё, дополнительно прятать не нужно.
- Вызов прямо из браузера (JS на вашей странице): ключ будет виден любому в DevTools → Network, и его можно скопировать и использовать откуда угодно. Правильный вариант — проксировать запрос через свой бэкенд: ключ хранится только там, а с фронтенда идёт запрос уже на ваш сервер, без ключа вообще.
- Ограничение ключа по IP (доступно на тарифах Pro и Unlimited) — мы на своей стороне проверяем не только сам ключ, но и IP-адрес, с которого пришёл запрос. Привяжите ключ к IP вашего сервера — и даже если ключ утечёт, воспользоваться им с другого адреса не получится: подделать исходный IP запроса нельзя (в отличие от заголовков вроде Referer). Для серверной интеграции это самая надёжная защита — рекомендуем сразу указать нам IP при подключении.
- Ограничение по Referer — более слабая защита для сценария выше (вызов из браузера): не даёт встроить ваш ключ в JS на чужом сайте, но не останавливает того, кто скопировал ключ и дёргает API напрямую скриптом или curl — заголовок Referer клиент может отправить любой.
Тарифная сетка
Указанные цены — ориентировочные стартовые значения. Итоговая стоимость зависит от объёма запросов, требований к SLA, необходимости выделенного инстанса и других параметров интеграции. Дополнительные условия обсуждаются лично.
Free
Для теста и разработки
- Доступ к /v1/dem/point и /v1/dem/globaldem
- Ограниченный дневной лимит запросов
- Без SLA и приоритетной поддержки
Pro
Для сайтов и приложений с картой
- Полный доступ к /v1/dem/point и /v1/dem/globaldem
- Повышенный дневной лимит запросов
- Referer/IP-ограничение ключа
- Email-поддержка
Unlimited
Для высоких нагрузок и интеграций
- Все возможности плана Pro
- Приоритетная обработка запросов
- Индивидуальный SLA
- Обсуждаемые условия интеграции
Как подключить продакшен-доступ
Напишите нам — обсудим тариф, лимиты и, при необходимости, ограничение ключа по IP или Referer:
- 📧 Email: admin@elevationmap.ru
- 💬 Telegram: t.me/elevationmap