API Геосаджеста

API Геосаджеста позволяет получать предложения поисковой выдачи во время поиска географических объектов и/или организаций.

Координаты точек

Для задания координат точек на поверхности Земли в Яндексе используется модель эллипсоида WGS84. Координаты в параметрах запроса указываются как {lon},{lat} — пара вещественных чисел, записанных через запятую, где:

  • {lon} — это долгота (longitude) в диапазоне от −180° до +180°;
  • {lat} — это широта (latitude), в диапазоне от −90° до +90°.

Например, координаты центра Стамбула задаются как 28.978178, 41.011218.

Область поиска (окно) на карте представляет собой прямоугольник со сторонами, параллельными осям координат. Его можно задать двумя способами, указав следующие параметры:

  • Координаты центра (ll) окна и его размеры — ширина и высота в градусах (spn). Например, окно Дубая можно задать как ll=55.29,25.23&spn=0.5,0.3.
  • Координаты левого нижнего и правого верхнего угла (bbox). Например, для Стамбула можно использовать bbox=28.8,41,28.9,42. Поддерживается также вариант написания через ~ : bbox=28.8,41~28.9,42.

Особенности карты

Карта отрисована в проекции Меркатора, поэтому нужно учитывать следующие особенности:

  • Чем ближе к полюсу, тем больше искажение размера, поэтому отображение объектов на полюсах невозможно. Обычно карту в проекции Меркатора ограничивают областями до 80—85° северной и южной широты.
  • Для окна поиска координаты центральной точки не равны среднему арифметическому координат двух крайних углов прямоугольника. Например, окно ll=37,55&spn=1,1 можно записать как bbox=36.5,54.496870~37.5,55.496870, но не bbox=36.5,54.5~37.5,55.5. Несмотря на то, что при выражении в градусах такое окно имеет форму квадрата, при отрисовке на карте оно будет иметь вид прямоугольника, вытянутого в направлении с севера на юг.
Следующая