Запуск iOS‑приложения Яндекс Карты
Информация, приведенная в этом разделе, актуальна для мобильного приложения Яндекс Карты версии 7.1.1 и выше.
Мобильные Яндекс Карты для платформы iOS можно запустить из приложения на Objective‑C или со страницы, отображаемой в браузере. Для запуска используется URL-схема yandexmaps. При запуске приложение Яндекс Карты может выполнить следующие действия.
Открыть карту
Показать карту можно с помощью URL вида:
yandexmaps://maps.yandex.ru/?{параметры}
|
Параметр |
Тип данных |
Описание |
|
|
float,float |
Координаты центра карты (долгота, широта). |
|
|
int |
Масштаб карты. Задается целым числом от 1 до 18, где 1 — наименее подробный масштаб (весь мир), а 18 — наиболее подробный из возможных. |
|
|
float,float |
Область показа. Через запятую указывается размер области по долготе и широте (в градусах). Например, чтобы задать область показа шириной 10,5 градусов, нужно указать: Центр области показа задается с помощью параметра Если уже задан параметр |
|
|
string |
Тип карты и информация о пробках. Тип карты: Показать загруженность магистралей: |
Примечание
Если параметры карты в URL не переданы, будут использоваться параметры предыдущей пользовательской сессии.
Пример URL:
yandexmaps://maps.yandex.ru/?ll=30.310182,59.951059&z=12&l=map
Пример HTML‑ссылки:
<a href="yandexmaps://maps.yandex.ru/?ll=30.310182,59.951059&z=12&l=map">Карта Санкт-Петербурга</a>
Пример Objective‑C вызова:
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?ll=30.310182,59.951059&z=12&l=map"]];
Поставить метку
Показать карту с меткой можно с помощью URL вида:
yandexmaps://maps.yandex.ru/?{параметры}
|
Параметр |
Тип данных |
Описание |
|
|
float,float |
Координаты метки (долгота, широта). Если параметр ll не задан, карта центрируется в точке, указанной в |
Пример URL:
yandexmaps://maps.yandex.ru/?pt=30.335429,59.944869&z=18&l=map
Пример HTML‑ссылки:
<a href="yandexmaps://maps.yandex.ru/?pt=30.335429,59.944869&z=18&l=map">Летний сад</a>
Пример Objective‑C вызова:
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?pt=30.335429,59.944869&z=18&l=map"]];
Найти объекты
Показать объекты, расположенные в заданной области карты, можно с помощью URL вида:
yandexmaps://maps.yandex.ru/?{параметры}
|
Параметр |
Тип данных |
Описание |
|
|
string |
Текст поискового запроса. Чтобы задать область поиска, укажите центр карты ll и уровень масштабирования или область показа. Если область поиска не задана, будут использоваться параметры предыдущей пользовательской сессии. |
Пример URL:
yandexmaps://maps.yandex.ru/?ll=30.310182,59.951059&z=16&text=кафе%20с%20wi-fi
Пример HTML‑ссылки:
<a href="yandexmaps://maps.yandex.ru/?ll=30.310182,59.951059&z=16&text=кафе%20с%20wi-fi">Показать кафе с wi-fi</a>
Пример (задан центр карты и область показа 0,05x0,05 градуса):
NSURL *url = [NSURL URLWithString:[@"yandexmaps://maps.yandex.ru/?ll=30.310182,59.951059&spn=0.05,0.05&text=кафе с wi-fi" stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];
[[UIApplication sharedApplication] openURL:url];
Открыть карточку организации
Показать карточку организации можно с помощью URL вида:
yandexmaps://maps.yandex.ru/?{параметры}
|
Параметр |
Тип данных |
Описание |
|
|
int |
Уникальный идентификатор организации в приложении Яндекс Карты. Совет Чтобы узнать идентификатор организации, откройте в мобильном приложении карточку организации и нажмите на значок Пример URL: |
yandexmaps://maps.yandex.ru/?oid=1184371713
Пример HTML‑ссылки:
<a href="yandexmaps://maps.yandex.ru/?oid=1184371713">Музей советских игровых автоматов</a>
Пример Objective‑C вызова:
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?oid=1184371713"]];
Показать «Что здесь?»
Чтобы открыть карточку объекта, находящегося в заданной точке, используйте URL вида:
yandexmaps://?{параметры}
|
Параметр |
Тип данных |
Описание |
|
|
float,float |
Координаты объекта. Объектом может быть, например, улица, остановка общественного транспорта, организация. |
|
|
float,float |
Масштаб карты. Задается целым числом от 1 до 18, где 1 — наименее подробный масштаб (весь мир), а 18 — наиболее подробный из возможных. |
Пример URL:
yandexmaps://?whatshere[point]=37.444075,55.776788&whatshere[zoom]=17
Пример HTML‑ссылки:
<a href="yandexmaps://?whatshere[point]=37.444075,55.776788&whatshere[zoom]=17">Мост</a>
Пример Objective‑C вызова:
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:@"yandexmaps://?whatshere[point]=37.444075,55.776788&whatshere[zoom]=17"]];
Построить маршрут
Чтобы показать на карте маршрут, нужно указать в URL начальную и конечную точку маршрута. Маршрут всегда строится с учетом пробок.
yandexmaps://maps.yandex.ru/?{параметры}
|
Параметр |
Тип данных |
Описание |
|
|
float,float~float,float |
Координаты начальной и конечной точки маршрута (широта, долгота). |
|
|
string |
Тип маршрута: Например, если параметр |
Примечание
Если тип маршрута не задан, используется автомобильная маршрутизация.
Тип карты в URL передать нельзя, параметры карты остаются такими же, как в предыдущей пользовательской сессии.
Пример URL:
yandexmaps://maps.yandex.ru/?rtext=59.967870,30.242658~59.898495,30.299559&rtt=mt
Пример HTML‑ссылки:
<a href="yandexmaps://maps.yandex.ru/?rtext=59.967870,30.242658~59.898495,30.299559&rtt=mt">Как добраться</a>
Пример Objective‑C вызова:
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?rtext=59.967870,30.242658~59.898495,30.299559&rtt=mt"]];
Показать панораму в заданной точке
Показать панорамный вид в заданной точке можно с помощью URL вида:
yandexmaps://?{параметры}
|
Параметр |
Тип данных |
Описание |
|
|
float,float |
Координаты точки, в которой показывается панорама (долгота, широта). |
|
|
float,float |
Направление взгляда. Задается в градусах, в формате Допустимые значения: от 0 до 360 градусов. |
|
|
float,float |
Размер поля обзора. Задается в градусах, в формате |
Пример URL:
yandexmaps://?panorama[point]37.444075,55.776788&panorama[direction]228.970000,6.060547&panorama[span]=130.000000,71.919192
Пример HTML‑ссылки:
<a href="yandexmaps://?panorama[point]37.444075,55.776788&panorama[direction]228.970000,6.060547&panorama[span]=130.000000,71.919192">Панорама</a>
Пример Objective‑C вызова:
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:@"yandexmaps://?panorama[point]37.444075,55.776788&panorama[direction]228.970000,6.060547&panorama[span]=130.000000,71.919192"]];
Тип данных
float,float
Описание
Координаты центра карты (долгота, широта)
Тип данных
int
Описание
Масштаб карты. Задается целым числом от 1 до 18, где 1 — наименее подробный масштаб (весь мир), а 18 — наиболее подробный из возможных.
Тип данных
string
Описание
Тип карты и информация о пробках.
Тип карты: map (схема), sat (спутник), skl (гибрид), pmap (народная карта).
Показать загруженность магистралей: trf (слой «пробки»). Можно указать только слой пробок или комбинировать этот слой и тип карты. В этом случае значения параметра указываются через запятую. Например: l=map,trf.
Тип данных
float,float
Описание
Координаты метки (долгота, широта).
Если параметр ll (центр карты) не задан, карта центрируется в точке, указанной в pt.
Тип данных
string
Описание
Текст поискового запроса.
Чтобы задать область поиска, укажите центр карты ll и уровень масштабирования или область показа. Если область поиска не задана, будут использоваться параметры предыдущей пользовательской сессии.
Тип данных
float,float~float,float
Описание
Координаты начальной и конечной точки маршрута (широта, долгота).
Тип данных
int
Описание
Уникальный идентификатор организации в приложении Яндекс Карты.
Совет
Чтобы узнать идентификатор организации, откройте в мобильном приложении карточку организации и нажмите на значок 
в правом верхнем углу экрана. Сформированная ссылка будет содержать идентификатор.
Тип данных
string
Описание
Тип маршрута: auto (автомобильный маршрут), mt (общественный транспорт), pd (пешеходный маршрут).
Например, если параметр rtt=mt, то строится маршрут с использованием общественного транспорта.
Тип данных
float,float
Описание
Координаты точки, в которой показывается панорама (долгота, широта).
Тип данных
float,float
Описание
Направление взгляда.
Задается в градусах, в формате [азимут направления,угол подъема над линией горизонта].
Допустимые значения: от 0 до 360 градусов.
Тип данных
float,float
Описание
Размер поля обзора.
Задается в градусах, в формате [горизонтальный размер, вертикальный размер].
Тип данных
float,float
Описание
Область показа. Через запятую указывается размер области по долготе и широте (в градусах). Например, чтобы задать область показа шириной 10,5 градусов, нужно указать: spn=10.5,10.5.
Центр области показа задается с помощью параметра ll (центр карты).
Если уже задан параметр z (масштаб), то spn игнорируется.
Тип данных
float,float
Описание
Координаты объекта.
Объектом может быть, например, улица, остановка общественного транспорта, организация.
Тип данных
float,float
Описание
Масштаб карты. Задается целым числом от 1 до 18, где 1 — наименее подробный масштаб (весь мир), а 18 — наиболее подробный из возможных.