此页面由 Cloud Translation API 翻译。

iOS 版 Google 地图网址方案

在搭载 iOS 9 及更高版本的设备上，您可以使用通用链接在拥有 Google 地图网址时启动 Google 地图。

您可以使用 Google 地图网址方案启动 iOS 版 Google 地图应用，并执行搜索、获取路线请求和显示地图视图。当您启动 Google 地图时，系统会自动将您的软件包标识符作为请求的一部分发送。

您无需 Google API 密钥即可使用 Google 地图网址方案。

通用链接和 Google 地图

适用于 iOS 的 Google 地图支持在搭载 iOS 9 或更高版本的设备上使用通用链接。

如果您的网址与以下正则表达式匹配，并且设备运行的是 iOS 9 或更高版本，您不妨考虑直接使用 open网址: 方法。

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

例如，

Swift

UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)

Objective-C

[[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];

概览

借助网址方案，您可以从另一个 iOS 应用或 Web 应用启动原生 iOS 应用。您可以在将传递给启动的应用的网址中设置选项。iOS 版 Google 地图应用支持以下网址方案：

comgooglemaps:// 和 comgooglemaps-x-callback:// - 这些方案可让您启动 iOS 版 Google 地图应用并执行以下操作之一：
- 在指定位置以指定的缩放级别显示地图。
- 搜索地点或位置，然后在地图上显示出来。
- 请求从一个地点到另一个地点的路线。系统可以返回四种交通方式的路线：驾车、步行、骑车和乘坐公共交通。
- 向应用添加导航功能。
- 在 iOS 8 及更低版本中，当应用完成时，使用 comgooglemaps-x-callback:// 发出回调。回调通常用于将用户返回到最初打开 iOS 版 Google 地图的应用。请注意，在 iOS 9 上，系统会在状态栏的左角自动提供“返回”链接。
comgooglemapsurl:// - 此方案允许您使用从桌面版 Google 地图网站派生的网址启动 iOS 版 Google 地图应用。这意味着，您可以为用户提供原生移动体验，而不仅仅是加载 Google 地图网站。
- 原始网址可以是 maps.google.com 或 google.com/maps，也可以使用任何有效的顶级国家/地区网域（而不是 com）。您还可以传递 goo.gl/maps 重定向网址。
- 您可以使用 comgooglemapsurl:// 网址方案以及 x-source 和 x-success 参数来发出回调。

启动 iOS 版 Google 地图应用并执行特定功能

如需启动 iOS 版 Google 地图应用并选择性地执行其中一项受支持的功能，请使用以下格式的网址方案：

comgooglemaps://?parameters

或者：

comgooglemaps-x-callback://?parameters

本文档中稍后将详细描述相关参数。

检查设备上 Google 地图应用的可用性

在应用中向用户显示其中一个网址之前，您应先验证相应应用是否已安装。您的应用可以使用以下代码检查网址方案是否可用：

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

例如，如需显示纽约中央公园的地图，您可以使用以下代码：

Swift

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

Objective-C

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

显示地图

使用网址方案以指定缩放级别和位置显示地图。您也可以在地图上叠加其他视图，或显示街景图像。

参数

以下所有参数都是可选的。如果未设置任何参数，网址方案将启动 iOS 版 Google 地图应用。

center：这是地图视口的中心点。格式为以逗号分隔的 latitude,longitude 字符串。
mapmode：设置显示的地图类型。可以设置为：standard 或 streetview。如果未指定，则使用当前应用设置。
views：开启/关闭特定视图。可设置为：satellite、traffic 或 transit。您可以使用逗号分隔符设置多个值。如果指定了该参数但未提供值，则系统会清除所有视图。
zoom：指定地图的缩放级别。

以下示例网址显示了以纽约为中心、缩放级别为 14 且开启了交通视图的地图：

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

纽约路况地图

以下是一些其他示例：

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

搜索

使用此网址协议可以在指定的视口位置显示搜索查询。

参数

除了用于显示地图的参数之外，Search 还支持 q 参数。

q：搜索查询字符串。

以下网址示例用于搜索指定位置附近的“披萨”：

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

附近的比萨店

以下是一些其他示例：

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

显示路线

使用此方案可请求并显示两个位置之间的路线。您还可以指定交通方式。

参数

saddr：设置路线搜索的起点。可以是纬度、经度或查询格式的地址。如果它是返回多个结果的查询字符串，系统将选择第一个结果。如果该值留空，则使用用户的当前位置。
daddr：设置路线搜索的终点。具有与 saddr 相同的格式和行为。
directionsmode：交通方式。可设置为：driving、transit、bicycling 或 walking。

以下示例网址显示了从 Google 纽约办事处到 JFK 机场的公交路线：

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

公交路线

以下是一些其他示例：

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10

comgooglemaps://?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

指定回调网址

如果您想指定回调网址，必须使用 comgooglemaps-x-callback:// 网址架构。此方案遵循 x-callback-url 规范。当您使用此方案调用 Google 地图 iOS 版应用时，该应用会在屏幕顶部显示一个按钮。点按此按钮会向您指定的网址发出回调。

对 comgooglemaps-x-callback:// 的请求必须采用以下格式：

comgooglemaps-x-callback://?parameters

参数

x-callback 网址方案接受与 comgooglemaps:// 网址方案相同的参数，但还接受以下其他参数。这两个参数都是必需的。

x-source - 发送 x-callback 请求的应用的名称。最好使用短名称。
x-success - 完成时要调用的网址。通常，这会是您自己应用的网址方案，让用户能够返回到原始应用。

请注意，您的应用必须注册自己的网址架构，以便能够响应回调网址。

确保您的应用已注册可响应回调请求的网址架构。
在 x-source 参数中传递回调按钮的标签。
在 x-success 参数中传递回调网址。

以下示例将启动 iOS 版 Google 地图应用，并显示以纽约为中心的地图。应用还会显示一个标记为“SourceApp”的按钮。当用户点击“SourceApp”按钮时，iOS 版 Google 地图应用会向虚构的网址方案 sourceapp://?resume=true 发出回调。

comgooglemaps-x-callback://?center=40.765819,-73.975866&zoom=14
   &x-success=sourceapp://?resume=true
   &x-source=SourceApp

与 comgooglemaps:// 网址方案一样，您应先验证设备上是否安装了适用于 iOS 的 Google 地图应用，以及该应用是否支持 x-callback 网址方案。您的应用可以使用以下代码检查网址方案是否可用：

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemaps-x-callback://"]];

以下网址示例可让用户在搜索甜点后返回应用。

comgooglemaps-x-callback://?q=dessert&center=37.759748,-122.427135
   &x-success=sourceapp://?resume=true
   &x-source=Nom+Nom

通过启动 Google 地图 iOS 应用并发送路线请求，您可以让用户轻松地从您的应用获取精细导航。您可以使用 comgooglemaps:// 或 comgooglemaps-x-callback:// 网址架构。

此代码段展示了如何使用 comgooglemaps-x-callback:// 方案来请求路线，然后在用户准备就绪时返回到您的应用。代码将执行以下操作：

验证 comgooglemaps-x-callback:// 网址方案是否可用。
启动 iOS 版 Google 地图应用，然后请求前往纽约市 JFK 机场的路线。将出发地址留空，即可请求从用户的当前位置出发的路线。
向 iOS 版 Google 地图应用添加一个名为“AirApp”的按钮。按钮标签由 x-source 参数定义。
当用户点击返回按钮时，调用虚构的网址方案 sourceapp://。

Swift

let testURL = URL(string: "comgooglemaps-x-callback://")!
if UIApplication.shared.canOpenURL(testURL) {
  let directionsRequest = "comgooglemaps-x-callback://" +
    "?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
    "&x-success=sourceapp://?resume=true&x-source=AirApp"

  let directionsURL = URL(string: directionsRequest)!
  UIApplication.shared.openURL(directionsURL)
} else {
  NSLog("Can't use comgooglemaps-x-callback:// on this device.")
}

Objective-C

NSURL *testURL = [NSURL URLWithString:@"comgooglemaps-x-callback://"];
if ([[UIApplication sharedApplication] canOpenURL:testURL]) {
  NSString *directionsRequest = @"comgooglemaps-x-callback://" +
      @"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
      @"&x-success=sourceapp://?resume=true&x-source=AirApp";
  NSURL *directionsURL = [NSURL URLWithString:directionsRequest];
  [[UIApplication sharedApplication] openURL:directionsURL];
} else {
  NSLog(@"Can't use comgooglemaps-x-callback:// on this device.");
}

从 Google 地图桌面版网址启动 iOS 版 Google 地图应用

如果您的应用可以访问预先存在的 Google 地图网址（例如网页上或数据库中的网址），则可以使用此方案在 Google 地图 iOS 应用中打开该网址，从而为用户提供最佳原生体验。

将 http:// 或 https:// 方案替换为 comgooglemapsurl://。
如果您想使用回调，请添加 x-source 和 x-success 参数。此方案遵循 x-callback-url 规范。

支持的 Google 地图网址格式

comgooglemapsurl:// 方案支持与此正则表达式匹配的网址，其中 {TLD} 是指任何有效的顶级国家/地区域名。为了清楚起见，我们添加了换行符：

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

检查 Google 地图应用是否可用

首先，验证设备上是否提供适用于 iOS 的 Google 地图应用，以及该应用是否支持网址方案：

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

示例

通用 Google 地图网址示例：

原来的 Google 地图网址：

https://www.google.com/maps/preview/@42.585444,13.007813,6z

使用网址架构：

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

通用 Google 地图网址示例：

原来的 Google 地图网址：

https://maps.google.com/?q=@37.3161,-122.1836

使用网址架构：

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836

使用 x-callback 请求前往东京塔的路线的示例：

原来的 Google 地图网址：

http://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1

以下示例将启动 iOS 版 Google 地图应用，并显示一张包含前往东京塔的路线的地图，如原始 Google 地图网址（上文）中所指定的那样。该应用还会显示一个标记为“SourceApp”的按钮。当用户点击“SourceApp”按钮时，iOS 版 Google 地图应用会向虚构的网址方案 sourceapp://?resume=true 发出回调。

comgooglemapsurl://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
    &x-source=SourceApp
    &x-success=sourceapp://?resume=true

iOS 版 Google 地图网址方案 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

通用链接和 Google 地图

Swift

Objective-C

概览

启动 iOS 版 Google 地图应用并执行特定功能

检查设备上 Google 地图应用的可用性

Swift

Objective-C

Swift

Objective-C

显示地图

搜索

显示路线

指定回调网址

Swift

Objective-C

向应用添加导航

Swift

Objective-C

从 Google 地图桌面版网址启动 iOS 版 Google 地图应用

支持的 Google 地图网址格式

检查 Google 地图应用是否可用

Swift

Objective-C

示例

iOS 版 Google 地图网址方案