Профиль высот для пешеходной тропы или автомобильного маршрута редко состоит из одной координаты. Это десятки, а иногда и сотни точек вдоль пути, и для каждой нужна высота, чтобы построить график подъёмов или оценить нагрузку на маршруте. Именно под такой сценарий, множество координат для одного непрерывного маршрута, мы целенаправленно оптимизировали /v1/elevation в ходе недавней доработки.
Формат запроса и ответа эндпоинта не изменился, и всё, что описано на странице /docs/elevation-lookup/, по-прежнему действует в точности как написано. Изменилось то, насколько эффективно внутри обрабатывается большой пакет координат вдоль маршрута: цель в том, чтобы сократить время получения профиля высот для длинного пути, а не для одной отдельной точки.
Поскольку пакетный запрос, как и всегда, считает каждую координату одним элементом, это улучшение влияет на скорость, а не на цены или учёт квоты. Маршрут из двухсот точек по-прежнему считается двумястами запросами в рамках той квоты, которая применяется, будь то бесплатная дневная квота, предоплаченный баланс по 0,0001 € за запрос или покрытие пакетом Unlimited. Меняется лишь время, за которое приходит ответ, а это напрямую важно для всего, что строит профиль маршрута интерактивно, а не в фоновом задании.
Это же улучшение распространяется на наш совместимый хост Open-Elevation по адресу /compatibility/open-elevation/, поскольку он использует тот же эндпоинт высоты. Всё, что уже отправляет через этот хост пакеты длиной в маршрут, получает более быструю обработку без каких-либо изменений на стороне интеграции.
Приложения для маршрутов и пеших походов, как правило, именно те, где такое улучшение ощущается сильнее всего, поскольку профиль высот, который загружается заметно дольше самого маршрута, создаёт видимую задержку для пользователя, ожидающего карту. Более быстрый ответ для таких длинных пакетов в форме маршрута устраняет этот разрыв.
Если ваше приложение запрашивает высоту для маршрутов из множества координат, будь то пешие походы, велосипедные поездки или автомобильные маршруты, вы заметите это как незаметное улучшение скорости получения полного профиля, при этом больше ничего в интеграции менять не нужно. Полная документация эндпоинта по-прежнему находится на странице /docs/elevation-lookup/.