---
metadata:
  - name: generator
    content: Diplodoc Platform v5.28.0
alternate:
  - https://yandex.com/dev/yandex-apps-launch-maps/doc/en/concepts/yandexmaps-ios-app.md
  - https://yandex.com/dev/yandex-apps-launch-maps/doc/ru/concepts/yandexmaps-ios-app.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/yandex-apps-launch-maps/doc/ru/llms.txt

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

Информация, приведенная в этом разделе, актуальна для мобильного приложения [Яндекс Карты](https://mobile.yandex.ru/apps/maps/iphone/) версии 7.1.1 и выше.

Мобильные Яндекс Карты для платформы iOS можно [запустить из приложения на Objective‑C](https://yandex.com/dev/yandex-apps-launch-maps/doc/ru/index.md#iosapp) или со страницы, отображаемой в браузере. Для запуска используется URL-схема `yandexmaps`. При запуске приложение Яндекс Карты может выполнить следующие действия.

## Открыть карту {#openmap}

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

```no-highlight
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`.
||
|#


{% note info %}

Если параметры карты в URL не переданы, будут использоваться параметры предыдущей пользовательской сессии.

{% endnote %}


Пример URL:

```no-highlight
yandexmaps://maps.yandex.ru/?[ll](*ll)=30.310182,59.951059&[z](*z)=12&[l](*l)=map
```

Пример HTML‑ссылки:

```no-highlight
<a href="yandexmaps://maps.yandex.ru/?[ll](*ll)=30.310182,59.951059&[z](*z)=12&[l](*l)=map">Карта Санкт-Петербурга</a>
```

Пример Objective‑C вызова:

```no-highlight
[[UIApplication sharedApplication] openURL:
 [NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?[ll](*ll)=30.310182,59.951059&[z](*z)=12&[l](*l)=map"]];
```

![](../_assets/ymaps-ios-app-openmap.png)

## Поставить метку {#showpoint}

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

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

#|
||
**Параметр** | **Тип данных** | **Описание**
||
||
`pt`
|
float,float
|
Координаты метки (долгота, широта).

Если параметр [ll](*ll) не задан, карта центрируется в точке, указанной в `pt`.
||
|#

{% include [yandexmaps-ios-app-urlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/urlexample-1bbdff6521f3.md) %}


```no-highlight
yandexmaps://maps.yandex.ru/?[pt](*pt)=30.335429,59.944869&[z](*z)=18&[l](*l)=map
```

{% include [yandexmaps-ios-app-htmlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/htmlexample-eb15528e34d4.md) %}


```no-highlight
<a href="yandexmaps://maps.yandex.ru/?[pt](*pt)=30.335429,59.944869&[z](*z)=18&[l](*l)=map">Летний сад</a>
```

{% include [yandexmaps-ios-app-codeexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/codeexample-388d85b59f1e.md) %}


```no-highlight
[[UIApplication sharedApplication] openURL:
 [NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?[pt](*pt)=30.335429,59.944869&[z](*z)=18&[l](*l)=map"]];
```

![](../_assets/ymaps-ios-app-showpoint.png)

## Найти объекты {#search}

Показать объекты, расположенные в заданной области карты, можно с помощью URL вида:

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

#|
||
**Параметр** | **Тип данных** | **Описание**
||
||
`text`
|
string
|
Текст поискового запроса.

Чтобы задать область поиска, укажите центр карты [ll](*ll) и уровень масштабирования или область показа. Если область поиска не задана, будут использоваться параметры предыдущей пользовательской сессии.
||
|#

{% include [yandexmaps-ios-app-urlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/urlexample-1bbdff6521f3.md) %}


```no-highlight
yandexmaps://maps.yandex.ru/?[ll](*ll)=30.310182,59.951059&[z](*z)=16&[text](*text)=кафе%20с%20wi-fi
```

{% include [yandexmaps-ios-app-htmlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/htmlexample-eb15528e34d4.md) %}


```no-highlight
<a href="yandexmaps://maps.yandex.ru/?[ll](*ll)=30.310182,59.951059&[z](*z)=16&[text](*text)=кафе%20с%20wi-fi">Показать кафе с wi-fi</a>
```

Пример (задан центр карты и область показа `0,05x0,05` градуса):

```no-highlight
NSURL *url = [NSURL URLWithString:[@"yandexmaps://maps.yandex.ru/?[ll](*ll)=30.310182,59.951059&spn=0.05,0.05&[text](*text)=кафе с wi-fi" stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];
[[UIApplication sharedApplication] openURL:url];
```

![](../_assets/ymaps-ios-app-search.png)

## Открыть карточку организации {#org}

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

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

#|
||
**Параметр** | **Тип данных** | **Описание**
||
||
`oid`
|
int
|
Уникальный идентификатор организации в приложении Яндекс Карты.


{% note tip %}

Чтобы узнать идентификатор организации, откройте в мобильном приложении карточку организации и нажмите на значок ![](../_assets/ymaps-ios-send.png) в правом верхнем углу экрана. Сформированная ссылка будет содержать идентификатор.

{% endnote %}

{% include [yandexmaps-ios-app-urlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/urlexample-1bbdff6521f3.md) %}
||
|#


```no-highlight
yandexmaps://maps.yandex.ru/?[oid](*oid)=1184371713
```

{% include [yandexmaps-ios-app-htmlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/htmlexample-eb15528e34d4.md) %}


```no-highlight
<a href="yandexmaps://maps.yandex.ru/?[oid](*oid)=1184371713">Музей советских игровых автоматов</a>
```

{% include [yandexmaps-ios-app-codeexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/codeexample-388d85b59f1e.md) %}


```no-highlight
[[UIApplication sharedApplication] openURL:
 [NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?[oid](*oid)=1184371713"]];
```

![](../_assets/ymaps-ios-app-org.png)

## Показать «Что здесь?» {#whatshere}

Чтобы открыть карточку объекта, находящегося в заданной точке, используйте URL вида:

```no-highlight
yandexmaps://?{параметры}
```

#|
||
**Параметр** | **Тип данных** | **Описание**
||
||
`whatshere[point]`
|
float,float
|
Координаты объекта.

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

{% include [yandexmaps-ios-app-urlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/urlexample-1bbdff6521f3.md) %}


```no-highlight
yandexmaps://?whatshere[[point](*whatshere-point)]=37.444075,55.776788&whatshere[[zoom](*whatshere-zoom)]=17
```

{% include [yandexmaps-ios-app-htmlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/htmlexample-eb15528e34d4.md) %}


```no-highlight
<a href="yandexmaps://?whatshere[[point](*whatshere-point)]=37.444075,55.776788&whatshere[[zoom](*whatshere-zoom)]=17">Мост</a>
```

{% include [yandexmaps-ios-app-codeexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/codeexample-388d85b59f1e.md) %}


```no-highlight
[[UIApplication sharedApplication] openURL:
 [NSURL URLWithString:@"yandexmaps://?whatshere[[point](*whatshere-point)]=37.444075,55.776788&whatshere[[zoom](*whatshere-zoom)]=17"]];
```

![](../_assets/ymaps-ios-app-whatshere.png)


## Построить маршрут {#buildroute}

Чтобы показать на карте маршрут, нужно указать в URL начальную и конечную точку маршрута. Маршрут всегда строится с учетом пробок.

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

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

Например, если параметр `rtt=mt`, то строится маршрут с использованием общественного транспорта.
||
|#


{% note info %}

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

Тип карты в URL передать нельзя, параметры карты остаются такими же, как в предыдущей пользовательской сессии.

{% endnote %}


{% include [yandexmaps-ios-app-urlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/urlexample-1bbdff6521f3.md) %}


```no-highlight
yandexmaps://maps.yandex.ru/?[rtext](*rtext)=59.967870,30.242658~59.898495,30.299559&[rtt](*rtt)=mt
```

{% include [yandexmaps-ios-app-htmlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/htmlexample-eb15528e34d4.md) %}


```no-highlight
<a href="yandexmaps://maps.yandex.ru/?[rtext](*rtext)=59.967870,30.242658~59.898495,30.299559&[rtt](*rtt)=mt">Как добраться</a>
```

{% include [yandexmaps-ios-app-codeexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/codeexample-388d85b59f1e.md) %}


```no-highlight
[[UIApplication sharedApplication] openURL:
 [NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?[rtext](*rtext)=59.967870,30.242658~59.898495,30.299559&[rtt](*rtt)=mt"]];
```

![](../_assets/ymaps-ios-app-buildroute.png)

## Показать панораму в заданной точке {#streetview}

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

```no-highlight
yandexmaps://?{параметры}
```
#|
||
**Параметр** | **Тип данных** | **Описание**
||
||
`panorama[point]`
|
float,float
|
Координаты точки, в которой показывается панорама (долгота, широта).
||
||
`panorama[direction]`
|
float,float
|
Направление взгляда.

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

Допустимые значения: от 0 до 360 градусов.
||
||
`panorama[span]`
|
float,float
|
Размер поля обзора.

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


{% include [yandexmaps-ios-app-urlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/urlexample-1bbdff6521f3.md) %}


```no-highlight
yandexmaps://?panorama[[point](*panorama-point)]=37.444075,55.776788&panorama[[direction](*panorama-direction)]=228.970000,6.060547&panorama[[span](*panorama-span)]=130.000000,71.919192
```

{% include [yandexmaps-ios-app-htmlexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/htmlexample-eb15528e34d4.md) %}


```no-highlight
<a href="yandexmaps://?panorama[[point](*panorama-point)]=37.444075,55.776788&panorama[[direction](*panorama-direction)]=228.970000,6.060547&panorama[[span](*panorama-span)]=130.000000,71.919192">Панорама</a>
```

{% include [yandexmaps-ios-app-codeexample](../_includes/concepts/yandexmaps-ios-app/id-yandexmaps-ios-app/codeexample-388d85b59f1e.md) %}


```no-highlight
[[UIApplication sharedApplication] openURL:
 [NSURL URLWithString:@"yandexmaps://?panorama[[point](*panorama-point)]=37.444075,55.776788&panorama[[direction](*panorama-direction)]=228.970000,6.060547&panorama[[span](*panorama-span)]=130.000000,71.919192"]];
```

![](../_assets/ymaps-ios-app-streetview.png)



[*ll]: {% include notitle [ll](../_includes/popups-14000baac3c6.md#ll) %}

[*z]: {% include notitle [z](../_includes/popups-14000baac3c6.md#z) %}

[*l]: {% include notitle [l](../_includes/popups-14000baac3c6.md#l) %}

[*pt]: {% include notitle [pt](../_includes/popups-14000baac3c6.md#pt) %}

[*text]: {% include notitle [text](../_includes/popups-14000baac3c6.md#text) %}

[*rtext]: {% include notitle [rtext](../_includes/popups-14000baac3c6.md#rtext) %}

[*oid]: {% include notitle [oid](../_includes/popups-14000baac3c6.md#oid) %}

[*rtt]: {% include notitle [rtt](../_includes/popups-14000baac3c6.md#rtt) %}

[*panorama-point]: {% include notitle [panorama-point](../_includes/popups-14000baac3c6.md#panorama-point) %}

[*panorama-direction]: {% include notitle [panorama-direction](../_includes/popups-14000baac3c6.md#panorama-direction) %}

[*panorama-span]: {% include notitle [panorama-span](../_includes/popups-14000baac3c6.md#panorama-span) %}

[*spn]: {% include notitle [spn](../_includes/popups-14000baac3c6.md#spn) %}

[*whatshere-point]: {% include notitle [whatshere-point](../_includes/popups-14000baac3c6.md#whatshere-point) %}

[*whatshere-zoom]: {% include notitle [whatshere-zoom](../_includes/popups-14000baac3c6.md#whatshere-zoom) %}