このページは Cloud Translation API によって翻訳されました。

iOS 向け Google マップ URL スキーム

iOS 9 以降を搭載したデバイスでは、ユニバーサルリンクを使用して、Google マップの URL を取得済みの場合に Google マップを起動できます。

Google マップの URL スキームを使用すると、iOS 向け Google マップアプリの起動、検索、ルートリクエストの取得、地図ビューの表示ができます。Google マップを起動すると、リクエストの一部としてバンドル ID が自動的に送信されます。

Google マップの URL スキームを使用するために Google API キーは必要ありません。

ユニバーサルリンクと Google マップ

iOS 向け Google マップは、iOS 9 以降を搭載したデバイスでユニバーサルリンクをサポートしています。

URL が次の正規表現と一致し、デバイスが 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"]];

概要

URL スキームを使用すると、別の iOS アプリやウェブアプリケーションからネイティブ iOS アプリを起動できます。起動されたアプリに渡される URL にオプションを設定できます。iOS 向け Google マップアプリは、次の URL スキームをサポートしています。

comgooglemaps:// と comgooglemaps-x-callback:// - これらのスキームを使用すると、iOS 向け Google マップアプリを起動して、次のいずれかのアクションを実行できます。
- 位置とズームレベルを指定して地図を表示する。
- 位置やスポットを検索し、地図上に表示する。
- ある地点から別の地点への経路を要求する。ルートは、車、徒歩、自転車、公共交通機関の 4 つの移動手段で返されます。
- アプリにナビゲーションを追加します。
- iOS 8 では、comgooglemaps-x-callback:// を使用して、アプリの完了時にコールバックを発行します。多くの場合、コールバックは最初に iOS 向け Google マップを開いた元のアプリにユーザーを返すために使用されます。iOS 9 では、ステータスバーの左隅に [戻る] リンクが自動的に表示されます。
comgooglemapsurl:// - このスキームを使用すると、パソコン版の Google マップウェブサイトから取得した URL を使用して、iOS 向け Google マップアプリを起動できます。つまり、Google マップウェブサイトを読み込むのではなく、ネイティブのモバイルエクスペリエンスを提供できます。
- 元の URL は maps.google.com、google.com/maps のいずれか、または com の代わりに任意の有効なトップレベルの国ドメインを使用できます。goo.gl/maps リダイレクト URL を渡すこともできます。
- コールバックを発行するには、comgooglemapsurl:// URL スキームで x-source パラメータと x-success パラメータを使用します。

iOS 向け Google マップアプリの起動と特定の機能の実行

iOS 向け Google マップアプリを起動し、必要に応じてサポートされている機能のいずれかを実行するには、次の形式の URL スキームを使用します。

comgooglemaps://?parameters

または

comgooglemaps-x-callback://?parameters

パラメータについては、本書で後ほど解説します。

デバイスで Google マップアプリを使用できるか確認する

これらの URL のいずれかをアプリでユーザーに提示する前に、まずアプリがインストールされていることを確認する必要があります。次のコードを使用すると、アプリは URL スキームが使用可能かどうかを確認できます。

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://");
}

マップを表示する

URL スキームを使用して、指定したズームレベルと場所で地図を表示します。地図の上に他のビューをオーバーレイしたり、ストリートビュー画像を表示したりもできます。

パラメータ

以下に示すパラメータはすべて省略可能です。パラメータが設定されていない場合、URL スキームによって iOS 向け Google マップアプリが起動します。

center: 地図のビューポートの中心点です。latitude,longitude のカンマ区切り文字列としてフォーマットされます。
mapmode: 表示する地図の種類を設定します。standard または streetview に設定できます。指定しない場合は、現在のアプリケーション設定が使用されます。
views: 特定のビューのオンとオフを切り替えます。satellite、traffic、transit のいずれかに設定できます。カンマで区切って複数の値を設定できます。値を指定せずにパラメータを指定すると、すべてのビューがクリアされます。
zoom: 地図のズームレベルを指定します。

次の URL の例では、ニューヨークを中心とする地図をズーム 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: 検索のクエリ文字列。

次の URL の例では、指定した場所の周辺で「Pizza」を検索します。

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

ルートを表示する

このスキームは、2 地点間のルートをリクエストして表示する場合に使用します。その際に、移動モードを指定することもできます。

パラメータ

saddr: ルート検索の始点を設定します。緯度、経度、またはクエリ形式の住所を指定できます。複数の結果を返すクエリ文字列の場合は、最初の結果が選択されます。値を空白のままにした場合は、ユーザーの現在地が使用されます。
daddr: ルート検索の終点を設定します。形式と動作は saddr と同じです。
directionsmode: 移動手段。driving、transit、bicycling、walking に設定できます。

次の URL の例では、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

コールバック URL の指定

コールバック URL を指定する場合は、comgooglemaps-x-callback:// URL スキームを使用する必要があります。このスキームは、x-callback-url の仕様に準拠しています。このスキームを使用して iOS 向け Google マップアプリを呼び出すと、アプリの画面上部にボタンが表示されます。このボタンをタップすると、指定した URL にコールバックが行われます。

comgooglemaps-x-callback:// へのリクエストの形式は次のとおりです。

comgooglemaps-x-callback://?parameters

パラメータ

x-callback URL スキームは、comgooglemaps:// URL スキームと同じパラメータを受け入れますが、次の追加パラメータがあります。どちらのパラメータも必須です。

x-source - x コールバックリクエストを送信するアプリケーションの名前。短めの名前を指定することが推奨されています。
x-success - 完了時に呼び出す URL。多くの場合、これは自分のアプリの URL スキームになり、ユーザーは元のアプリに戻ることができます。

なお、アプリがコールバック URL に応答できるように、アプリは独自の URL スキームを登録する必要があります。

コールバックリクエストに応答できる URL スキームがアプリに登録されていることを確認します。
x-source パラメータでコールバックボタンのラベルを渡します。
x-success パラメータでコールバック URL を渡します。

次の例では、iOS 向け Google マップアプリが起動され、ニューヨークを中心とした地図が表示されます。アプリには [SourceApp] というラベルのボタンも表示されます。[SourceApp] ボタンがクリックされると、iOS 向け Google マップアプリは架空の URL スキーム sourceapp://?resume=true へのコールバックを発行します。

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

comgooglemaps:// URL スキームと同様に、まず iOS 向け Google マップアプリがデバイスで利用可能で、x-callback URL スキームをサポートしていることを確認する必要があります。次のコードを使用すると、URL スキームが使用可能かどうかを確認できます。

Swift

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

Objective-C

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

これは、ユーザーがデザートを検索した後にアプリに戻るための URL の例です。

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

ルートリクエストを使用して iOS 向け Google マップアプリを起動すると、アプリからターンバイターン方式のナビにアクセスする簡単な方法となります。comgooglemaps:// または comgooglemaps-x-callback:// の URL スキームを使用できます。

次のコードスニペットは、comgooglemaps-x-callback:// スキームを使用して経路をリクエストし、ユーザーの準備が整ったらアプリに戻る方法を示しています。このコードは次の処理を行います。

comgooglemaps-x-callback:// URL スキームが使用可能であることを確認します。
iOS 向け Google マップアプリを起動して、ニューヨーク市の JFK 空港までのルートをリクエストします。ユーザーの現在地からの経路を検索するには、出発地の住所を空白のままにします。
iOS 向け Google マップアプリに「AirApp」というボタンを追加します。ボタンのラベルは、x-source パラメータで定義します。
ユーザーが戻るボタンをクリックしたときに、架空の URL スキーム 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 マップのデスクトップ URL から iOS 向け Google マップアプリを起動する

ウェブページやデータベースなど、アプリから既存の Google マップ URL にアクセスできる場合は、このスキームを使用して iOS 向け Google マップアプリで URL を開くことができるため、ネイティブユーザーに最適なエクスペリエンスを提供できます。

http:// または https:// スキームを comgooglemapsurl:// に置き換えます。
コールバックを使用する場合は、x-source パラメータと x-success パラメータを含めます。このスキームは、x-callback-url の仕様に準拠しています。

サポートされている Google マップの URL 形式

comgooglemapsurl:// スキームは、この正規表現に一致する URL をサポートします。ここで、{TLD} は有効なトップレベルの国ドメインを指します。わかりやすくするため、改行が追加されています。

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

Google マップアプリをご利用いただけるかどうか確認しています

まず、iOS 向け Google マップアプリがデバイスで利用可能で、URL スキームをサポートしていることを確認します。

Swift

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

Objective-C

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

例

Google マップの汎用 URL の例:

元の Google マップ URL:

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

使用する URL スキーム:

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

Google マップの汎用 URL の例:

元の Google マップ URL:

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

使用する URL スキーム:

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

x-callback で東京タワーへのルートをリクエストする例:

元の Google マップ URL:

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 マップの URL（上記）で指定されているように、東京タワーまでのルートを含む地図が表示されます。アプリには [SourceApp] というラベルのボタンも表示されます。[SourceApp] ボタンをクリックすると、iOS 向け Google マップアプリは、架空の URL スキーム 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 マップ URL スキーム

ユニバーサル リンクと Google マップ

Swift

Objective-C

概要

iOS 向け Google マップ アプリの起動と特定の機能の実行

デバイスで Google マップ アプリを使用できるか確認する

Swift

Objective-C

Swift

Objective-C

マップを表示する

検索

ルートを表示する

コールバック URL の指定

Swift

Objective-C

アプリにナビゲーションを追加する

Swift

Objective-C

Google マップのデスクトップ URL から iOS 向け Google マップ アプリを起動する

サポートされている Google マップの URL 形式

Google マップ アプリをご利用いただけるかどうか確認しています

Swift

Objective-C

例

ユニバーサルリンクと Google マップ

iOS 向け Google マップアプリの起動と特定の機能の実行

デバイスで Google マップアプリを使用できるか確認する

Google マップのデスクトップ URL から iOS 向け Google マップアプリを起動する

Google マップアプリをご利用いただけるかどうか確認しています