---
metadata:
  - name: generator
    content: Diplodoc Platform v5.28.0
alternate:
  - https://yandex.com/dev/yandex-apps-launch-maps/doc/en/concepts/yandexmaps-android-app.md
  - https://yandex.com/dev/yandex-apps-launch-maps/doc/ru/concepts/yandexmaps-android-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 Android app

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

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

[Support for geo scheme](#additonalscheme) section shows how to open the map using a different URI scheme. With this method, the user can choose which app to open.

## Open map {#openmaploc}

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)37.619902,55.753716&[z](*z)11&[l](*l)map
```

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[ll](*ll)37.619902,55.753716&[z](*z)11&[l](*l)map">Moscow map</a>
```

Sample Java call:

```no-highlight
Uri uri = Uri.parse("yandexmaps://maps.yandex.ru/?[ll](*ll)37.619902,55.753716&[z](*z)11&[l](*l)map");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
startActivity(intent);
```

![](../_assets/ymaps-android-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)=37.673098,55.757134&[z](*z)=12&[l](*l)=map
```

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[pt](*pt)=37.673098,55.757134&[z](*z)12&[l](*l)=map">Placemark</a>
```

Sample Java call:

```no-highlight
Uri uri = Uri.parse("yandexmaps://maps.yandex.ru/?[pt](*pt)=37.673098,55.757134&[z](*z)12&[l](*l)=map");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
startActivity(intent);
```

![](../_assets/ymaps-android-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)=37.619902,55.753716&[z](*z)=16&[text](*text)=кафе%20с%20wi-fi
```

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[ll](*ll)37.619902,55.753716&[z](*z)16&[text](*text)=cafe%20with%20wi-fi">Found</a>
```

Sample Java call:

```no-highlight
Uri uri = Uri.parse("yandexmaps://maps.yandex.ru/?[ll](*ll)=37.619902,55.753716&[z](*z)=16&[text](*text)=кафе%20с%20wi-fi");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
startActivity(intent);
```

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

## Open organization card {#org}

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

```no-highlight
yandexmaps://maps.yandex.ru/?{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-android-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)=1221676748
```

HTML link example:

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

Sample Java call:

```no-highlight
Uri uri = Uri.parse("yandexmaps://maps.yandex.ru/?[oid](*oid)=1221676748");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
startActivity(intent);
```

![](../_assets/ymaps-android-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 Java call:

```no-highlight
Uri uri = Uri.parse("yandexmaps://?whatshere[[point](*whatshere-point)]=37.444075,55.776788&whatshere[[zoom](*whatshere-zoom)]=17");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
startActivity(intent);
```

![](../_assets/ymaps-android-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, the value from the previous user session is used. If this information is not available, a driving route is built by default.

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)=55.745719,37.604337~55.76009,37.648801&[rtt](*rtt)=mt
```

HTML link example:

```no-highlight
<a href="yandexmaps://maps.yandex.com/?[rtext](*rtext)=55.745719,37.604337~55.76009,37.648801&[rtt](*rtt)=mt">Get directions</a>
```

Sample Java call:

```no-highlight
Uri uri = Uri.parse("yandexmaps://maps.yandex.ru/?[rtext](*rtext)=55.745719,37.604337~55.76009,37.648801&[rtt](*rtt)=mt");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
startActivity(intent);
```

![](../_assets/ymaps-android-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">Bridge</a>
```

Sample Java call:

```no-highlight
Uri uri = Uri.parse("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");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
startActivity(intent);
```

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


## Support for geo scheme {#additonalscheme}

The Yandex Maps app supports the [geo](http://developer.android.com/guide/appendix/app-intents.html) scheme. Other Android apps also support this scheme. The following example shows how to open the map of Seattle.

The map center coordinates and zoom are specified in the [URI](https://developer.android.com/guide/components/intents-common.html#Maps).

```no-highlight
// Opening the map of Seattle.
Uri uri = Uri.parse("geo:47.6,-122.3?z=11");Intent intent = new Intent(Intent.ACTION_VIEW, uri);startActivity(intent);
```

If the user's mobile device has multiple matching apps installed, the user will be prompted to choose the app for opening the map.


{% note info %}

Before calling the `startActivity` method, you can check [whether the Yandex Maps](https://yandex.com/dev/yandex-apps-launch-maps/doc/en/index.md#aboutgplay) app is installed on the user's device.

{% endnote %}


[*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) %}