---
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/en/llms.txt

# Launch Yandex Maps iOS app

This section applies to the [Yandex Maps](https://mobile.yandex.ru/apps/maps/iphone/) mobile app, version 7.1.1 or higher.

You can launch mobile Yandex Maps for iOS [from an Objective-C app](https://yandex.com/dev/yandex-apps-launch-maps/doc/en/index.md#iosapp) or browser page. Use the `yandexmaps` URL scheme to launch the app. Yandex Maps can run the following actions on launch:

## Open map {#openmap}

You can display the map using the following URL format:

```no-highlight
yandexmaps://maps.yandex.com/?{parameters}
```

#|
||
**Parameter** | **Data type** | **Description**
||
||
`ll`
|
float,float
|
Map center coordinates (longitude, latitude).
||
||
`z`
|
int
|
Map zoom. An integer from 1 to 18, where 1 is the least detailed map zoom (whole world), and 18 is the highest zoom possible.
||
||
`spn`
|
float,float
|
Viewport. Longitudinal and latitudinal size of the viewport in degrees, comma-separated. For example, to set a viewport of 10.5 degrees, specify: `spn=10.5, 10.5`.

The viewport center is set using the `ll` parameter (map center).

If `z` (zoom) is already set, then `spn` is ignored.
||
||
`l`
|
string
|
Map type and traffic information.

Type of map: `map` (Map), `sat` (Satellite), `skl` (Hybrid), `pmap` (Public Map).

Show road traffic: `trf` ("traffic" layer). You can enable the traffic layer only, or combine it with some map type. In this case, the parameter values are comma-separated. For example: `l=map,trf`.
||
|#


{% note info %}

If the map parameters are not passed in the URL, the previous user session parameters are used.

{% endnote %}


URL example:

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

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[ll](*ll)=30.310182,59.951059&[z](*z)=12&[l](*l)=map">Map of Saint Petersburg</a>
```

Sample Objective-C call:

```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)

## Add placemark {#showpoint}

You can display the map with a placemark using the following URL format:

```no-highlight
yandexmaps://maps.yandex.com/?{parameters}
```

#|
||
**Parameter** | **Data type** | **Description**
||
||
`pt`
|
float,float
|
Placemark coordinates (longitude, latitude).

If the [ll](*ll) parameter (map center) is not specified, the map is centered at the point specified in `pt`.
||
|#


URL example:

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

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[pt](*pt)=30.335429,59.944869&[z](*z)=18&[l](*l)=map">Summer Garden</a>
```

Sample Objective-C call:

```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)

## Find objects {#search}

To show objects in a specified area of the map, use the following URL format:

```no-highlight
yandexmaps://maps.yandex.com/?{parameters}
```


#|
||
**Parameter** | **Data type** | **Description**
||
||
`text`
|
string
|
Text of the search query.

To set the search area, specify the map center [ll](*ll) and the zoom level or viewport. If the search area is not specified, the parameters of the previous user session are used.
||
|#


URL example:

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

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[ll](*ll)=30.310182,59.951059&[z](*z)=16&[text](*text)=cafe%20with%20wi-fi">Show cafes with Wi-Fi</a>
```

Example (map center and viewport of `0.05×0.05` degrees are specified):

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

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

## Open organization card {#org}

You can display the organization card using the following URL format:

```no-highlight
yandexmaps://maps.yandex.com/?{parameters}
```


#|
||
**Parameter** | **Data type** | **Description**
||
||
`oid`
|
int
|
Unique organization ID in the Yandex Maps app.


{% note tip %}

To find out the organization ID, open the organization card in the mobile app and click upon ![](../_assets/ymaps-ios-send.png) in the upper right corner of the screen. The resulting link will contain the ID.

{% endnote %}
||
|#


URL example:

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

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[oid](*oid)=1184371713">Museum of Soviet gaming machines</a>
```

Sample Objective-C call:

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

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

## Show What's here?" {#whatshere}

To open a card for an object located at a specified point, use the following URL format:

```no-highlight
yandexmaps://?{parameters}
```


#|
||
**Parameter** | **Data type** | **Description**
||
||
`whatshere[point]`
|
float,float
|
Object coordinates.

An object can be, for example, a street, public transport stop, or organization.
||
||
`whatshere[zoom]`
|
float,float
|
Map zoom. An integer from 1 to 18, where 1 is the least detailed map zoom (whole world), and 18 is the highest zoom possible.
||
|#


URL example:

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

HTML link example:

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

Sample Objective-C call:

```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)

## Plot route {#buildroute}

To show a route on the map, enter the start and end points of the route in the URL. The route is always plotted based on traffic.

```no-highlight
yandexmaps://maps.yandex.com/?{parameters}
```

#|
||
**Parameter** | **Data type** | **Description**
||
||
`rtext`
|
float,float~float,float
| Coordinates of the start and end points of the route (latitude, longitude).
||
||
`rtt`
|
string
|
Route type: `auto (driving route), mt (public transport route), pd` (pedestrian route.)

For example, if `rtt=mt`, then a public transport route is built.
||
|#


{% note info %}

If the route type is not set, a driving route is built.

The map type cannot be passed in the URL: the map parameters are kept as in the previous user session.

{% endnote %}


URL example:

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

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[rtext](*rtext)=59.967870,30.242658~59.898495,30.299559&[rtt](*rtt)=mt">Get directions</a>
```

Sample Objective-C call:

```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)

## Show a panorama from a specified point {#streetview}

To show a panoramic view from a specified point, use the following URL:

```no-highlight
yandexmaps://?{parameters}
```


#|
||
**Parameter** | **Data type** | **Description**
||
||
`panorama[point]`
|
float,float
|
Coordinates of the point of the panoramic view (longitude, latitude).
||
||
`panorama[direction]`
|
float,float
|
View direction.

Set in degrees, in the format: `[direction azimuth, angle of elevation above the horizon]`.

Acceptable values: from 0 to 360 degrees.
||
||
`panorama[span]`
|
float,float
|
Size of the viewport.

Set in degrees, in the format: `[horizontal size, vertical size]`.
||
|#


URL example:

```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
```

HTML link example:

```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">Panorama</a>
```

Sample Objective-C call:

```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-094df24a16ab.md#ll) %}

[*1184371713]: {% include notitle [1184371713](../_includes/popups-094df24a16ab.md#1184371713) %}

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

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

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

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

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

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

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

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

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

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

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

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

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