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. Несмотря на то, что при выражении в градусах такое окно имеет форму квадрата, при отрисовке на карте оно будет иметь вид прямоугольника, вытянутого в направлении с севера на юг.