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

# Launch Yandex Maps by URL

You can run [Yandex Maps](http://mobile.yandex.ru/apps/maps/) mobile app from [other applications](#application) and [website pages](#browser). You can also launch a platform-agnostic [web version of Yandex Maps](#web).

This document describes the methods to launch the Yandex Maps app and web version of Yandex Maps.


## Launch Yandex Maps mobile app from browser {#browser}

For the user to launch the Yandex Maps app from a browser page, generate a relevant app link. Instead of the network protocol name (usually http or https), the link specifies the [URL scheme](https://developer.apple.com/library/ios/featuredarticles/iPhoneURLScheme_Reference/Introduction/Introduction.html) responsible for launching the app.

The `yandexmaps` URL scheme is responsible for the [Yandex Maps](http://mobile.yandex.ru/apps/maps/) app launch. A link to open a map in the Yandex Maps app for Android and iOS, will look as follows:

```html
<a href="yandexmaps://maps.yandex.com/?ll=37.62, 55.75&z=12" >Open
Moscow map in Yandex Maps</a>
```

For the list of parameters that can be specified in the URL, see sections [Launch Yandex Maps iOS app](https://yandex.com/dev/yandex-apps-launch-maps/doc/en/concepts/yandexmaps-ios-app.md) and [Launch Yandex Maps Android app](https://yandex.com/dev/yandex-apps-launch-maps/doc/en/concepts/yandexmaps-android-app.md).


{% note info %}

The link can be generated dynamically, depending on the platform. The platform-related information can be retrieved from:

- ##[navigator](http://www.w3schools.com/jsref/obj_navigator.asp)## object, if the link is generated on the browser side (client side JavaScript)

- HTTP headers, if the link is generated on the server side.

{% endnote %}



## Launch Yandex Maps mobile app from native applications {#application}

### Android {#androidapp}

To launch the Yandex Maps from an Android-based Java app, create an object of the ##[Intent](http://developer.android.com/reference/android/content/Intent.html#Intent)## type`. When the object is created, the [ACTION_VIEW](https://developer.android.com/reference/android/content/Intent.html#ACTION_VIEW) action (see [action](http://developer.android.com/guide/topics/manifest/action-element.html)) and URI are passed to the constructor. After this, just call the ##[startActivity](http://developer.android.com/reference/android/content/Context.html#startActivity(android.content.Intent))## method of the ##[Context](http://developer.android.com/reference/android/content/Context.html)## class, and the [Activity](http://developer.android.com/reference/android/app/Activity.html) relevant to the action will run. For example, to open a map with given center coordinates and zoom in Yandex Maps, you need to add the following code.

```java
Uri uri = Uri.parse("yandexmaps://maps.yandex.ru/?ll=37.62,55.75&z=12");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
startActivity(intent);
```

The standard [ACTION_VIEW](https://developer.android.com/reference/android/content/Intent.html#ACTION_VIEW) action is used to launch the app. The map center coordinates and scale are specified in [URI](https://developer.android.com/guide/components/intents-common.html#Maps).

The list of possible parameters is provided in the [Launch Yandex Maps Android app](https://yandex.com/dev/yandex-apps-launch-maps/doc/en/concepts/yandexmaps-android-app.md) section.

If the app launched is not installed on the device, the `startActivity` method call will stop the app. To check whether the relevant app is installed, use the ##[queryIntentActivities](http://developer.android.com/reference/android/content/pm/PackageManager.html#queryIntentActivities(android.content.Intent,%20int))## method of the ##[PackageManager](http://developer.android.com/reference/android/content/pm/PackageManager.html)## class. If the app is not installed, you can open the Yandex Maps page in [Google Play](https://play.google.com).

```java
Uri uri = Uri.parse("yandexmaps://maps.yandex.com/");Intent intent = new Intent(Intent.ACTION_VIEW, uri);// Checking that at least one app which can run this action has been installed.
PackageManager packageManager = getPackageManager();
List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);
boolean isIntentSafe = activities.size() > 0;
if (isIntentSafe) {
  startActivity(intent);
} else {
// Opening the Yandex Maps app page in Google Play.
  intent = new Intent(Intent.ACTION_VIEW);
  intent.setData(Uri.parse("market://details?id=com.yandex.yandexmaps"));  startActivity(intent);}
```

### iOS {#iosapp}

To run external apps from applications written in Objective‑C, use the ##[openURL:](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIApplication_Class/Reference/Reference.html#//apple_ref/doc/uid/TP40006728-CH3-SW14)## method of the ##[UIApplication](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIApplication_Class/Reference/Reference.html#//apple_ref/occ/instm/UIApplication)## class. The method is passed a URL containing a [scheme](https://developer.apple.com/library/ios/featuredarticles/iPhoneURLScheme_Reference/Introduction/Introduction.html) of the app launched, and its startup parameters, if needed. For example, to open the [Yandex Maps](http://mobile.yandex.ru/apps/maps/) app and display the map of Moscow, you can use the following code.

```objectivec
[[UIApplication sharedApplication] openURL:
 [NSURL URLWithString:@"yandexmaps://maps.yandex.ru/?ll=37.62,55.75&z=12"]];
```

Here `yandexmaps` is the name of the Yandex Maps app URL scheme. The list of possible parameters is provided in the [Launch Yandex Maps iOS app](https://yandex.com/dev/yandex-apps-launch-maps/doc/en/concepts/yandexmaps-ios-app.md) section.

Before calling the `openURL` method you should check if the Yandex Maps app is installed on the device. To do this, use the ##[canOpenURL:](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIApplication_Class/Reference/Reference.html#//apple_ref/occ/instm/UIApplication/canOpenURL:)## method. If the app is not installed, you can open the Yandex Maps page in [App Store](https://itunes.apple.com/ru/genre/mobile-software-applications/id36?mt=8).

```objectivec
if ([[UIApplication sharedApplication] canOpenURL:[NSURL URLWithString:@"yandexmaps://"]]) {   [[UIApplication sharedApplication] openURL:[NSURL URLWithString:@"yandexmaps://maps.yandex.com/?ll=37.62,55.75&z=12"]];} else {// Opening the Yandex Maps page in App Store.
   [[UIApplication sharedApplication] openURL:    [NSURL URLWithString:@"https://itunes.apple.com/ru/app/yandex.maps/id313877526?mt=8"]];}

```


## Launch web version of Yandex Maps {#web}

To launch the web version of Yandex Maps, pass the request parameters in the URL. The URL will look like this:

```
<a href="https://yandex.ru/maps/?ll=37.62,55.75&z=12">Open the map of
        Moscow in the web version of Yandex Maps</a>
```

For the list of available parameters, see the [Web](https://yandex.com/dev/yandex-apps-launch-maps/doc/en/concepts/yandexmaps-web.md) section.

When you open the link on mobile devices, the system may suggest opening the link in the installed app. On computers, the link opens in a browser.

