inRoute

inRoute 是一款路线规划与导航应用。Protocol Launcher 可以生成 inRoute URL scheme 链接。

使用方式

这个库有两种使用方式：

• On-Demand 从子路径导入，支持 tree-shaking，能让产物更小。
• Full Import 从根包导入，适合快速脚本或演示，但会包含全部 app 模块。

生产构建建议选择 On-Demand；快速脚本或 demo 可以选择 Full Import。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

URL Methods

此模块对齐 inRoute 官方 URL Scheme 页：通过 inroute://coordinates 导入坐标、通过 inroute://searches 导入搜索位置、通过 inroute://view 查看地图 pin、通过 inroute://route 导航到 pin、使用 action=opt 优化 waypoint 顺序，以及通用 back_url 返回参数。

官方页面没有记录裸打开 App 的命令，也没有记录更多路线设置，所以本模块不会暴露这些 helper。

Coordinates

把基于坐标的路线位置发送到 inRoute。每个位置会序列化成官方记录的重复 loc={name}/{latitude}/{longitude} 参数。

On-Demand

import { coordinates } from 'protocol-launcher/inroute'

const url = coordinates({
  optimize: true,
  locations: [
    { name: 'Lazy K’s', latitude: 47.648434, longitude: -121.914307 },
    { name: 'Greek Food', latitude: 47.739555, longitude: -121.985924 },
  ],
})

导入坐标

Search

把基于搜索词的路线位置发送到 inRoute。helper 名为 search，但会生成官方记录的 inroute://searches 命令。

On-Demand

import { search } from 'protocol-launcher/inroute'

const url = search({
  optimize: true,
  locations: [
    { name: 'Lazy K’s', search: 'Lazy K’, Carnation WA 98014' },
    { name: 'Greek Food', search: '15410 Main St NE, Duvall WA 98019' },
  ],
})

导入搜索位置

View

查看指定坐标的地图 pin。

On-Demand

import { view } from 'protocol-launcher/inroute'

const url = view({
  geo: '48.8582,2.2946',
})

查看 Pin

Route

导航到指定坐标的地图 pin。

On-Demand

import { route } from 'protocol-launcher/inroute'

const url = route({
  geo: '48.8582,2.2946',
})

导航到 Pin

Return to Caller

任意 inRoute URL 都可以携带官方记录的 back_url 参数，在本模块中对应 backUrl。

On-Demand

import { view } from 'protocol-launcher/inroute'

const url = view({
  geo: '48.8582,2.2946',
  backUrl: 'myapp://',
})

查看并携带返回 URL

生成的 URL

coordinates({
  optimize: true,
  locations: [
    { name: 'Lazy K’s', latitude: 47.648434, longitude: -121.914307 },
    { name: 'Greek Food', latitude: 47.739555, longitude: -121.985924 },
  ],
})
// => 'inroute://coordinates?action=opt&loc=Lazy%20K’s/47.648434/-121.914307&loc=Greek%20Food/47.739555/-121.985924'

search({
  optimize: true,
  locations: [
    { name: 'Lazy K’s', search: 'Lazy K’, Carnation WA 98014' },
    { name: 'Greek Food', search: '15410 Main St NE, Duvall WA 98019' },
  ],
})
// => 'inroute://searches?action=opt&loc=Lazy%20K’s/Lazy%20K’,%20Carnation%20WA%2098014&loc=Greek%20Food/15410%20Main%20St%20NE,%20Duvall%20WA%2098019'

view({ geo: '48.8582,2.2946' })
// => 'inroute://view?geo=48.8582,2.2946'

route({ geo: '48.8582,2.2946' })
// => 'inroute://route?geo=48.8582,2.2946'

view({ geo: '48.8582,2.2946', backUrl: 'myapp://' })
// => 'inroute://view?geo=48.8582,2.2946&back_url=myapp%3A%2F%2F'

官方文档

• inRoute URL Scheme