Google Maps

Google Maps 是 Google 开发的网络地图服务。它提供地图、搜索、街景和路线功能。Protocol Launcher 允许你生成深度链接来打开 Google Maps、显示地图、搜索地点、获取路线，并打开受支持的 Google Maps 桌面版 URL。

使用方式

有两种使用此库的方式：

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

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

选择安装方式

按需加载

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

全量导入

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

注意事项

此模块只封装 Google 官方文档中明确列出的参数。官方页面提到了 comgooglemaps-x-callback://，但没有给出 x-callback 动作或 payload 参数，因此这里不暴露 x-callback 辅助函数。

打开 Google Maps

On-Demand

import { open } from 'protocol-launcher/google-maps'

const url = open()

打开 Google Maps

显示地图

On-Demand

import { displayMap } from 'protocol-launcher/google-maps'

const url = displayMap({
  center: '40.765819,-73.975866',
  zoom: 14,
  views: 'traffic',
})

显示交通地图

显示街景

On-Demand

import { displayMap } from 'protocol-launcher/google-maps'

const url = displayMap({
  center: '46.414382,10.013988',
  mapmode: 'streetview',
})

显示街景

清除图层

On-Demand

import { displayMap } from 'protocol-launcher/google-maps'

const url = displayMap({
  views: '',
})

清除图层

搜索

On-Demand

import { search } from 'protocol-launcher/google-maps'

const url = search({
  q: 'Pizza',
  center: '37.759748,-122.427135',
})

搜索 Pizza

带图层搜索

On-Demand

import { search } from 'protocol-launcher/google-maps'

const url = search({
  q: 'Steamers Lane Santa Cruz, CA',
  center: '37.782652,-122.410126',
  views: ['satellite', 'traffic'],
  zoom: 15,
})

带图层搜索

显示路线

On-Demand

import { directions } from 'protocol-launcher/google-maps'

const url = directions({
  saddr: 'Google Inc, 8th Avenue, New York, NY',
  daddr: 'John F. Kennedy International Airport, Van Wyck Expressway, Jamaica, New York',
  directionsmode: 'transit',
})

显示公共交通路线

从当前位置出发

On-Demand

import { directions } from 'protocol-launcher/google-maps'

const url = directions({
  saddr: '',
  daddr: 'John F. Kennedy International Airport',
  directionsmode: 'driving',
})

从当前位置出发

步行路线

On-Demand

import { directions } from 'protocol-launcher/google-maps'

const url = directions({
  saddr: '2025 Garcia Ave, Mountain View, CA, USA',
  daddr: 'Google, 1600 Amphitheatre Parkway, Mountain View, CA, United States',
  center: '37.423725,-122.0877',
  directionsmode: 'walking',
  zoom: 17,
})

显示步行路线

打开桌面版 URL

openUrl 只接受 Google 官方 URL scheme 正则覆盖的 Google Maps 桌面版 URL 格式：maps.google.{TLD}/、google.{TLD}/maps/ 或 www.google.{TLD}/maps/、以及 goo.gl/maps/，并允许省略或使用 http://、https:// 前缀。

On-Demand

import { openUrl } from 'protocol-launcher/google-maps'

const url = openUrl({
  url: 'https://www.google.com/maps/preview/@42.585444,13.007813,6z',
})

打开 Google Maps 桌面版 URL

官方文档

• Google Maps URL Scheme for iOS