Protocol Launcher

English

简体中文

English

简体中文

Appearance

Yandex Navigator ​

Yandex Navigator is a navigation app from Yandex. Protocol Launcher allows you to generate official yandexnavi:// links to open Yandex Navigator, build routes, search the map, and show a point.

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 Navigator: build_route_on_map, map_search, and show_point_on_map.

Yandex documents route coordinates as separate latitude and longitude parameters. Intermediate route points are serialized as lat_via_0, lon_via_0, then lat_via_1, lon_via_1, and so on.

Yandex says sending coordinates, search queries, and other data to Navigator requires an access key. Signed URLs use the documented client and signature parameters; these helpers accept those optional fields, but the RSA signature must be generated outside Protocol Launcher with your Yandex access key.

Open Navigator ​

On-Demand
ts
import { open } from 'protocol-launcher/yandex-navigator'

const url = open()
Open Yandex Navigator

Build Route ​

On-Demand
ts
import { buildRoute } from 'protocol-launcher/yandex-navigator'

const url = buildRoute({
  lat_from: '55.74',
  lon_from: '37.60',
  lat_to: '55.76',
  lon_to: '37.64',
})
Build Route

Build Route From Current Location ​

On-Demand
ts
import { buildRoute } from 'protocol-launcher/yandex-navigator'

const url = buildRoute({
  lat_to: '55.70',
  lon_to: '37.64',
})
Build Route From Current Location

Build Route With Via Point ​

On-Demand
ts
import { buildRoute } from 'protocol-launcher/yandex-navigator'

const url = buildRoute({
  lat_from: '55.75',
  lon_from: '37.58',
  lat_to: '55.75',
  lon_to: '37.64',
  via: [{ lat: '55.75', lon: '37.62' }],
})
Build Route With Via Point
On-Demand
ts
import { search } from 'protocol-launcher/yandex-navigator'

const url = search({
  text: 'заправка',
})
Search

Show Point ​

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

const url = showPoint({
  lat: 55.77,
  lon: 37.44,
  zoom: 12,
  'no-balloon': 0,
  desc: 'кафе с wi-fi',
})
Show Point

Signed URL Parameters ​

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

const url = showPoint({
  lat: 55.75,
  lon: 37.64,
  zoom: 14,
  client: '007',
  signature: 'REPLACE_WITH_SIGNATURE',
})

Official Documentation ​