Protocol Launcher

Yandex Maps ​

Yandex Maps is Yandex's map and navigation app. Protocol Launcher allows you to generate Yandex Maps URL scheme links and web links.

Usage ​

There are two ways to use this library:

  • On-Demand import from subpaths enables tree-shaking and keeps bundles small.
  • Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand
Recommended. Optimized for production.
Full Import
Convenient. Good for quick scripts.

Notes ​

This module only wraps actions and parameters documented by Yandex for yandexmaps:// mobile app links, the Android geo: example supported by Yandex Maps, and https://yandex.ru/maps/ web links.

Yandex documents ll, pt, "What's here?", and panorama coordinates as longitude,latitude. Route rtext is documented separately as latitude,longitude~latitude,longitude, and the Android geo: example uses latitude,longitude. The mobile app route type is limited to auto, mt, and pd; the web route helper also supports the web-only bc bicycle route type.

Mobile App ​

Open Map ​

On-Demand
ts
import { openMap } from 'protocol-launcher/yandex-maps'

const url = openMap({
  ll: '37.619902,55.753716',
  z: 11,
  l: ['map', 'trf'],
})
Open Yandex Maps

Add Placemark ​

On-Demand
ts
import { showPoint } from 'protocol-launcher/yandex-maps'

const url = showPoint({
  pt: '30.335429,59.944869',
  z: 18,
  l: 'map',
})
Add Placemark

Find Objects ​

On-Demand
ts
import { search } from 'protocol-launcher/yandex-maps'

const url = search({
  ll: '30.310182,59.951059',
  z: 16,
  text: 'cafe with wi-fi',
})
Find Objects

Open Organization Card ​

On-Demand
ts
import { openOrganizationCard } from 'protocol-launcher/yandex-maps'

const url = openOrganizationCard({
  oid: 1184371713,
})
Open Organization Card

Show What's Here ​

On-Demand
ts
import { showWhatsHere } from 'protocol-launcher/yandex-maps'

const url = showWhatsHere({
  point: '37.444075,55.776788',
  zoom: 17,
})
Show What's Here

Plot Route ​

On-Demand
ts
import { route } from 'protocol-launcher/yandex-maps'

const url = route({
  rtext: '59.967870,30.242658~59.898495,30.299559',
  rtt: 'mt',
})
Plot Route

Show Panorama ​

On-Demand
ts
import { panorama } from 'protocol-launcher/yandex-maps'

const url = panorama({
  point: '37.444075,55.776788',
  direction: '228.970000,6.060547',
  span: '130.000000,71.919192',
})
Show Panorama

Android Geo Scheme ​

On-Demand
ts
import { androidGeo } from 'protocol-launcher/yandex-maps'

const url = androidGeo({
  coordinates: '47.6,-122.3',
  z: 11,
})
Open Android Geo Map

Web ​

Open Web Map ​

On-Demand
ts
import { webMap } from 'protocol-launcher/yandex-maps'

const url = webMap({
  ll: '30.310182,59.951059',
  z: 12,
  l: 'map',
})
Open Web Map

Add Web Placemark ​

On-Demand
ts
import { webShowPoint } from 'protocol-launcher/yandex-maps'

const url = webShowPoint({
  pt: '30.335429,59.944869',
  z: 18,
  l: 'map',
})
Add Web Placemark

Add Several Web Placemarks ​

On-Demand
ts
import { webShowPoints } from 'protocol-launcher/yandex-maps'

const url = webShowPoints({
  ll: '30.310182,59.951059',
  pt: '30.335429,59.944869~30.34127,59.89173',
  z: 12,
  l: 'map',
})
Add Several Web Placemarks

Find Web Objects ​

On-Demand
ts
import { webSearch } from 'protocol-launcher/yandex-maps'

const url = webSearch({
  ll: '30.310182,59.951059',
  z: 16,
  text: 'cafe with wi-fi',
})
Find Web Objects

Open Web Organization Card ​

On-Demand
ts
import { webOpenOrganizationCard } from 'protocol-launcher/yandex-maps'

const url = webOpenOrganizationCard({
  oid: 1184371713,
})
Open Web Organization Card

Show Web What's Here ​

On-Demand
ts
import { webShowWhatsHere } from 'protocol-launcher/yandex-maps'

const url = webShowWhatsHere({
  point: '37.444075,55.776788',
  zoom: 17,
})
Show Web What's Here

Plot Web Route ​

On-Demand
ts
import { webRoute } from 'protocol-launcher/yandex-maps'

const url = webRoute({
  rtext: '59.967870,30.242658~59.898495,30.299559',
  rtt: 'bc',
})
Plot Web Route

Show Web Panorama ​

On-Demand
ts
import { webPanorama } from 'protocol-launcher/yandex-maps'

const url = webPanorama({
  point: '37.444075,55.776788',
  direction: '228.970000,6.060547',
  span: '130.000000,71.919192',
})
Show Web Panorama

Official Documentation ​