在搭載 iOS 9 以上版本的裝置上，您可以使用通用連結取得 Google 地圖網址，藉此啟動 Google 地圖。
你可以使用 Google 地圖網址配置啟動 Google 地圖應用程式 iOS 版，並執行搜尋、取得路線要求，以及顯示地圖檢視。啟動 Google 地圖時，系統會自動將套件 ID 隨要求一併傳送。
您不需要 Google API 金鑰，就能使用 Google 地圖網址架構。
通用連結與 Google 地圖
Google 地圖 iOS 版支援搭載 iOS 9 以上版本的裝置上的通用連結。
如果網址與下列規則運算式相符，而且裝置搭載 iOS 9 以上版本，建議你直接使用 openURL: 方法。
(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 應用程式或網頁應用程式啟動原生 iOS 應用程式。您可以在網址中設定要傳遞給啟動應用程式的選項。Google 地圖應用程式 iOS 版支援下列網址配置：
comgooglemaps://和comgooglemaps-x-callback://- 這些配置可讓您啟動 iOS 版 Google 地圖應用程式，並執行下列其中一項操作：- Display a map at a specified location and zoom level.
- Search for locations or places, and display them on a map.
- Request directions from one location to another. 系統可根據四種交通方式傳迴路線：開車、步行、騎單車和大眾運輸。
- 在應用程式中加入導覽功能。
- 在 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://");
}
顯示地圖
使用網址架構，按照指定的縮放等級和位置顯示地圖。You can also overlay other views on top of your map, or display Street View imagery.
參數
All of the following parameters are optional. 如未設定任何參數，網址配置就會啟動 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
搜尋
Use this scheme to display search queries in a specified viewport location.
參數
除了用於顯示地圖的參數外，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
顯示路線
使用此配置來要求及顯示兩個地點之間的路線。You can also specify the transportation mode.
參數
saddr：設定路線搜尋的起點。這可以是緯度、經度或查詢格式化地址。如果查詢字串傳回多個結果，系統會選取第一個結果。如果值為空白，系統會使用使用者目前的位置。daddr：設定路線搜尋的終點。格式和行為與saddr相同。directionsmode：交通方式，可設為：driving、transit、bicycling或walking。
此範例網址顯示 Google NYC 和 JFK Airport 之間的大眾運輸路線：
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 規格。透過這個配置呼叫 Google 地圖應用程式 iOS 版時，應用程式會在螢幕頂端顯示按鈕。點選此按鈕後，系統就會向您指定的網址發出回呼。
對「comgooglemaps-x-callback://」發出的要求必須採用以下格式：
comgooglemaps-x-callback://?parameters
參數
X 回呼網址配置可接受與 comgooglemaps:// 網址配置相同的參數，並額外提供下列參數。這兩個參數都是必要的。
x-source：傳送 x 回呼要求的應用程式名稱。建議使用簡稱。x-success：完成時呼叫的網址。這通常是應用程式本身的網址配置，可讓使用者返回原始應用程式。
請注意，您的應用程式必須註冊自己的網址配置，以便回應回呼網址。
- 確保應用程式已註冊可回應回呼要求的網址配置。
- 透過
x-source參數傳遞回呼按鈕的標籤。 - 透過
x-success參數傳遞回呼網址。
下例將啟動 Google 地圖應用程式 iOS 版，並顯示以紐約為中心的地圖。應用程式也會顯示標示「SourceApp」的按鈕。有人點選「SourceApp」按鈕後，Google 地圖應用程式 iOS 版會核發虛構網址配置的回呼 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 回呼網址配置。您的應用程式可以透過下列程式碼，檢查網址配置是否可用：
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
在應用程式中新增導覽
您可以利用路線要求啟動 Google 地圖應用程式 iOS 版，讓使用者能輕鬆存取應用程式的即時路線導航。您可以使用 comgooglemaps:// 或 comgooglemaps-x-callback:// 網址配置。
此程式碼片段說明如何使用 comgooglemaps-x-callback:// 配置來查詢路線，然後在使用者準備就緒時返回應用程式。程式碼會執行以下作業：
- 確認
comgooglemaps-x-callback://網址配置可以使用。 - 啟動 iOS 版 Google 地圖應用程式，要求前往紐約市的 JFK 機場。將起始地址留白，即可從使用者目前的位置要求路線。
- 在 Google 地圖應用程式 iOS 版上新增「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 地圖電腦版網址啟動 Google 地圖應用程式 iOS 版
如果您的應用程式可以存取網頁或既有的地圖網址 (例如網頁或資料庫)，則建議使用這個配置，在 iOS 版 Google 地圖應用程式中開啟網址，以提供最佳的使用者體驗。
- 以
comgooglemapsurl://取代http://或https://配置。 - 如要使用回呼，請加入
x-source和x-success參數。這項配置符合 x-callback-url 規格。
支援的 Google 地圖網址格式
comgooglemapsurl:// 配置可支援與此規則運算式相符的網址，其中 {TLD} 是指任何有效的頂層網域國家/地區網域。新增分節符號以清楚呈現：
(http(s?)://)?
((maps\.google\.{TLD}/)|
((www\.)?google\.{TLD}/maps/)|
(goo.gl/maps/))
.*
檢查 Google 地圖應用程式是否可用
確認裝置已安裝 Google 地圖應用程式 iOS 版，並支援網址配置：
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 回呼的東京鐵塔路線：
原始 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
下例將啟動 Google 地圖應用程式 iOS 版，並顯示地圖中顯示東京鐵塔的路線 (如上方原始 Google 地圖網址所述)。應用程式也會顯示標籤為「SourceApp」的按鈕。按一下「SourceApp」(來源應用程式) 按鈕後，Google 地圖應用程式 iOS 版就會向虛構的網址配置 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