Skip to content

Waze

Waze 是一款导航应用和实时地图服务。Protocol Launcher 允许你生成 Waze Deep Links,用来打开 Waze、搜索地点或地址、显示地图位置、导航到坐标,以及导航到 Home 或 Work 收藏地点。

使用方式

有两种使用此库的方式:

  • 按需导入(On-Demand):从子路径导入支持 tree-shaking,保持较小的打包体积。
  • 完整导入(Full Import):从根包导入更方便,但会包含所有应用模块。

生产构建建议选择按需导入;快速脚本或演示可以使用完整导入。

选择安装方式

按需加载
推荐使用。生产环境优化。
全量导入
使用便捷。适合快速脚本。

注意事项

Waze 文档将 https://waze.com/ul 作为 Deep Links 的基础 URL。只有在确定用户已安装 Waze 应用时才应使用 waze:// URL scheme;否则,Waze 说明点击链接不会发生任何事情。这些 Deep Link 辅助函数默认使用 HTTPS,并且仅在 Waze 文档说明可用原生 scheme 替代基础 URL 的位置接受 protocol: 'waze'

utmSource 会映射到 Waze 文档中的 utm_source 参数。

打开 Waze

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

const url = open()

搜索

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

const url = search({
  q: '66 Acacia Avenue',
})

导航到位置

On-Demand
ts
import { navigateToLocation } from 'protocol-launcher/waze'

const url = navigateToLocation({
  ll: '40.75889500,-73.98513100',
  zoom: 17,
})

导航到收藏

On-Demand
ts
import { navigateToFavorite } from 'protocol-launcher/waze'

const url = navigateToFavorite({
  favorite: 'work',
})

在地图上显示

On-Demand
ts
import { showOnMap } from 'protocol-launcher/waze'

const url = showOnMap({
  z: 8,
})

在地图上显示位置

On-Demand
ts
import { showOnMap } from 'protocol-launcher/waze'

const url = showOnMap({
  ll: '45.6906304,-120.810983',
  z: 10,
})

搜索并导航

On-Demand
ts
import { searchAndNavigate } from 'protocol-launcher/waze'

const url = searchAndNavigate({
  q: '66 Acacia Avenue',
  ll: '45.6906304,-120.810983',
})

官方文档