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

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

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

  1. Открыть карту
  2. Поставить метку
  3. Найти объекты
  4. Открыть карточку организации
  5. Показать «Что здесь?»
  6. Построить маршрут
  7. Показать панораму в заданной точке

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

Показать карту можно с помощью 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.

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

Пример 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/?{параметры}
Параметр Тип данных Описание
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 — наиболее подробный из возможных.

Пример 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, то строится маршрут с использованием общественного транспорта.

Примечание.

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

Тип карты в 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

Размер поля обзора.

Задается в градусах, в формате [горизонтальный размер, вертикальный размер].

Пример 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"]];