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