Запуск iOS‑приложения Яндекс.Карты

Информация, приведенная в этом разделе, актуальна для мобильного приложения Яндекс.Карты версии 7.1.1 и выше.

Мобильные Яндекс.Карты для платформы iOS можно запустить из приложения на Objective‑C или со страницы, отображаемой в браузере. Для запуска используется URL-схема yandexmaps. При запуске приложение Яндекс.Карты может выполнить следующие действия.

Открыть карту

Показать карту можно с помощью URL вида:

yandexmaps://maps.yandex.ru/?{параметры}


Параметр	Тип данных	Описание
`ll`	float,float	Координаты центра карты (долгота, широта).
`z`	int	Масштаб карты. Задается целым числом от 1 до 18, где 1 — наименее подробный масштаб (весь мир), а 18 — наиболее подробный из возможных.
`spn`	float,float	Область показа. Через запятую указывается размер области по долготе и широте (в градусах). Например, чтобы задать область показа шириной 10,5 градусов, нужно указать: `spn=10.5,10.5`. Центр области показа задается с помощью параметра `ll` (центр карты). Если уже задан параметр `z` (масштаб), то `spn` игнорируется.
`l`	string	Тип карты и информация о пробках. Тип карты: `map` (схема), `sat` (спутник), `skl` (гибрид), `pmap` (народная карта). Показать загруженность магистралей: `trf` (слой «пробки»). Можно указать только слой пробок или комбинировать этот слой и тип карты. В этом случае значения параметра указываются через запятую. Например: `l=map,trf`.


Параметр	Тип данных	Описание
`ll`	float,float	Координаты центра карты (долгота, широта).
`z`	int	Масштаб карты. Задается целым числом от 1 до 18, где 1 — наименее подробный масштаб (весь мир), а 18 — наиболее подробный из возможных.
`spn`	float,float	Область показа. Через запятую указывается размер области по долготе и широте (в градусах). Например, чтобы задать область показа шириной 10,5 градусов, нужно указать: `spn=10.5,10.5`. Центр области показа задается с помощью параметра `ll` (центр карты). Если уже задан параметр `z` (масштаб), то `spn` игнорируется.
`l`	string	Тип карты и информация о пробках. Тип карты: `map` (схема), `sat` (спутник), `skl` (гибрид), `pmap` (народная карта). Показать загруженность магистралей: `trf` (слой «пробки»). Можно указать только слой пробок или комбинировать этот слой и тип карты. В этом случае значения параметра указываются через запятую. Например: `l=map,trf`.

Примечание. Если параметры карты в 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/?{параметры}


Параметр	Тип данных	Описание
`pt`	float,float	Координаты метки (долгота, широта). Если параметр ll (центр карты) не задан, карта центрируется в точке, указанной в `pt`.


Параметр	Тип данных	Описание
`pt`	float,float	Координаты метки (долгота, широта). Если параметр ll (центр карты) не задан, карта центрируется в точке, указанной в `pt`.

Пример 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/?{параметры}


Параметр	Тип данных	Описание
`text`	string	Текст поискового запроса. Чтобы задать область поиска, укажите центр карты ll и уровень масштабирования или область показа. Если область поиска не задана, будут использоваться параметры предыдущей пользовательской сессии.


Параметр	Тип данных	Описание
`text`	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/?{параметры}


Параметр	Тип данных	Описание
`oid`	int	Уникальный идентификатор организации в приложении Яндекс.Карты. Совет. Чтобы узнать идентификатор организации, откройте в мобильном приложении карточку организации и нажмите на значок в правом верхнем углу экрана. Сформированная ссылка будет содержать идентификатор.


Параметр	Тип данных	Описание
`oid`	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://?{параметры}


Параметр	Тип данных	Описание
`whatshere[point]`	float,float	Координаты объекта. Объектом может быть, например, улица, остановка общественного транспорта, организация.
`whatshere[zoom]`	float,float	Масштаб карты. Задается целым числом от 1 до 18, где 1 — наименее подробный масштаб (весь мир), а 18 — наиболее подробный из возможных.


Параметр	Тип данных	Описание
`whatshere[point]`	float,float	Координаты объекта. Объектом может быть, например, улица, остановка общественного транспорта, организация.
`whatshere[zoom]`	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/?{параметры}


Параметр	Тип данных	Описание
`rtext`	float,float~float,float	Координаты начальной и конечной точки маршрута (широта, долгота).
`rtt`	string	Тип маршрута: `auto (автомобильный маршрут), mt (общественный транспорт), pd` (пешеходный маршрут). Например, если параметр `rtt=mt`, то строится маршрут с использованием общественного транспорта.


Параметр	Тип данных	Описание
`rtext`	float,float~float,float	Координаты начальной и конечной точки маршрута (широта, долгота).
`rtt`	string	Тип маршрута: `auto (автомобильный маршрут), mt (общественный транспорт), pd` (пешеходный маршрут). Например, если параметр `rtt=mt`, то строится маршрут с использованием общественного транспорта.

Примечание.

Если тип маршрута не задан, используется автомобильная маршрутизация.

Тип карты в 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://?{параметры}


Параметр	Тип данных	Описание
`panorama[point]`	float,float	Координаты точки, в которой показывается панорама (долгота, широта).
`panorama[direction]`	float,float	Направление взгляда. Задается в градусах, в формате `[азимут направления,угол подъема над линией горизонта]`. Допустимые значения: от 0 до 360 градусов.
`panorama[span]`	float,float	Размер поля обзора. Задается в градусах, в формате `[горизонтальный размер, вертикальный размер]`.


Параметр	Тип данных	Описание
`panorama[point]`	float,float	Координаты точки, в которой показывается панорама (долгота, широта).
`panorama[direction]`	float,float	Направление взгляда. Задается в градусах, в формате `[азимут направления,угол подъема над линией горизонта]`. Допустимые значения: от 0 до 360 градусов.
`panorama[span]`	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"]];