在搭载 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://在应用完成时发出回调。回调通常用于将用户返回到最初打开 Google 地图 iOS 版的应用。请注意，在 iOS 9 中，系统会在状态栏的左上角自动提供“返回”链接。
comgooglemapsurl://- 借助此架构，您可以使用从桌面版 Google 地图网站派生的网址启动 iOS 版 Google 地图应用。这意味着，您可以为用户提供原生移动体验，而不是简单地加载 Google 地图网站。- 原始网址可以是
maps.google.com或google.com/maps，也可以使用任何有效的国家/地区顶级域名（而非com）。您还可以传递goo.gl/maps重定向网址。 - 您可以使用
x-source和x-success参数与comgooglemapsurl://网址架构一起发出回调。
- 原始网址可以是
启动 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
搜索
使用此网址协议可以在指定的视口位置显示搜索查询。
参数
除了用于显示地图的参数之外，Google 搜索还支持 q 参数。
q：搜索的查询字符串。
以下示例网址用于搜索指定地点附近的“披萨”：
comgooglemaps://?q=Pizza¢er=37.759748,-122.427135
其他一些示例如下：
comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA¢er=37.782652,-122.410126&views=satellite,traffic&zoom=15
comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan¢er=35.660888,139.73073&zoom=15&views=transit
显示路线
使用此架构请求并显示两个地点之间的路线。 您还可以指定交通方式。
参数
saddr：设置路线搜索的起点。可以是纬度、经度或查询格式的地址。如果查询字符串返回多个结果，系统会选择第一个结果。如果留空，则系统会使用用户的当前位置。daddr：设置路线搜索的终点。格式和行为与saddr相同。directionsmode：运输方式。可设置为：driving、transit、bicycling或walking。
以下示例网址会显示 Google NYC 和肯尼迪机场之间的公交路线：
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¢er=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¢er=37.423725,-122.0877&directionsmode=walking&zoom=17
指定回调网址
如果您想指定回调网址，则必须使用 comgooglemaps-x-callback:// 网址架构。此架构遵循 x-callback-url 规范。使用此架构调用适用于 iOS 的 Google 地图应用时，该应用会在屏幕顶部显示一个按钮。点按此按钮会向您指定的网址发出回调。
对 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¢er=37.759748,-122.427135
&x-success=sourceapp://?resume=true
&x-source=Nom+Nom
向应用添加导航栏
通过路线请求启动适用于 iOS 的 Google 地图应用，是让用户从您的应用中使用精细导航的一种简单方法。您可以使用 comgooglemaps:// 或 comgooglemaps-x-callback:// 网址架构。
以下代码段展示了如何使用 comgooglemaps-x-callback:// 架构请求路线，然后在用户准备就绪时返回您的应用。该代码将执行以下操作：
- 验证
comgooglemaps-x-callback://网址架构是否可用。 - 启动 iOS 版 Google 地图应用，然后请求导航至纽约市肯尼迪机场。将起始地址留空，即可请求从用户当前位置出发的路线。
- 向 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 地图网址（例如网页上或数据库中），则可以使用此架构在适用于 iOS 的 Google 地图应用中打开该网址，从而为用户提供最佳原生体验。
- 将
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