Android 向け Google マップ インテント

Android 向け Google マップ アプリには、表示、検索、ナビゲーション、ストリートビューの各モードで Google マップを起動する際に使用できるインテントがいくつか用意されています。アプリに地図を埋め込む場合は、Google Maps Android API のスタートガイドをご覧ください。

概要

インテントを使用すると、実行するシンプルなアクション（「地図を表示する」や「空港までのルートを表示する」など）を Intent オブジェクトに記述することで、別のアプリのアクティビティを開始できます。Android 向け Google マップ アプリでは、Google マップ アプリを起動して次の 4 つのアクションのいずれかを実行できるよう、さまざまなインテントをサポートしています。

  1. 位置とズーム レベルを指定して地図を表示する。
  2. 位置やスポットを検索し、地図上に表示する。
  3. ある地点から別の地点への経路を要求する。ルートは、車、徒歩、自転車の 3 つの移動モードで返されます。
  4. Google ストリートビューにパノラマ画像を表示します。

このページでは、Android 向け Google マップ アプリで使用できるインテントについて説明します。インテントとインテント フィルタ、または Android プラットフォームに共通するインテントの詳細については、Android デベロッパー向けドキュメントをご覧ください。

インテント リクエスト

インテントを使用して Google マップを起動するには、まず Intent オブジェクトを作成して、そのアクション、URI、パッケージを指定する必要があります。

  • アクション: Google マップ インテントはすべて、ビュー アクション（ACTION_VIEW）として呼び出されます。
  • URI: Google マップ インテントでは、目的のアクションと、そのアクションの実行に使用するデータを指定する URL エンコードを使用します。
  • パッケージ: setPackage("com.google.android.apps.maps") を呼び出すと、Android 向け Google マップ アプリがインテントを確実に処理できるようになります。パッケージが設定されていない場合、Intent を処理できるアプリがシステムによって決定されます。複数のアプリが利用可能な場合、ユーザーはどのアプリを使用するかを尋ねられることがあります。

Intent を作成したら、さまざまな方法で関連アプリを起動するようシステムにリクエストできます。一般的な方法は、Intent を startActivity() メソッドに渡すことです。必要なアプリ（この場合は Google マップ）が起動され、対応する Activity が起動します。

Java

// Create a Uri from an intent string. Use the result to create an Intent.
Uri gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988");

// Create an Intent from gmmIntentUri. Set the action to ACTION_VIEW
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
// Make the Intent explicit by setting the Google Maps package
mapIntent.setPackage("com.google.android.apps.maps");

// Attempt to start an activity that can handle the Intent
startActivity(mapIntent);

Kotlin

// Create a Uri from an intent string. Use the result to create an Intent.
val gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988")

// Create an Intent from gmmIntentUri. Set the action to ACTION_VIEW
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
// Make the Intent explicit by setting the Google Maps package
mapIntent.setPackage("com.google.android.apps.maps")

// Attempt to start an activity that can handle the Intent
startActivity(mapIntent)

インテントに応答できるアプリをシステムが特定できない場合、アプリがクラッシュする可能性があります。このため、これらのインテントのいずれかをユーザーに提示する前に、受信側のアプリがインストールされていることを確認する必要があります。

アプリがインテントを受け取れるかどうかを確認するには、Intent オブジェクトで resolveActivity() を呼び出します。結果が null でない場合、インテントを処理できるアプリが少なくとも 1 つあるため、startActivity() を安全に呼び出すことができます。結果が null の場合は、インテントを使用しないでください。また、可能であれば、インテントを呼び出す機能を無効にする必要があります。

Java

if (mapIntent.resolveActivity(getPackageManager()) != null) {
  ...
}

Kotlin

mapIntent.resolveActivity(packageManager)?.let {
  ...
}

たとえば、サンフランシスコのマップを表示するには、次のコードを使用します。

Java

Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
if (mapIntent.resolveActivity(getPackageManager()) != null) {
  startActivity(mapIntent);
}

Kotlin

val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
mapIntent.resolveActivity(packageManager)?.let {
  startActivity(mapIntent)
}

URL エンコードされたクエリ文字列

Google マップ インテントに渡される文字列はすべて URI エンコードする必要があります。たとえば、文字列「1st & Pike, Seattle」は 1st%20%26%20Pike%2C%20Seattle になります。文字列内の空白文字は、%20 にエンコードするか、プラス記号（+）に置き換えます。

android.net.Uri parse() メソッドを使用して文字列をエンコードできます。次に例を示します。

Java

Uri gmmIntentUri =
  Uri.parse("geo:37.7749,-122.4192?q=" + Uri.encode("1st & Pike, Seattle"));

Kotlin

val gmmIntentUri =
  Uri.parse("geo:37.7749,-122.4192?q=" + Uri.encode("1st & Pike, Seattle"))

マップを表示する

geo: インテントを使用して、指定した場所とズームレベルの地図を表示します。

geo:latitude,longitude?z=zoom

パラメータ

  • latitude と longitude は、地図の中心点を設定します。
  • z は必要に応じて地図の初期ズームレベルを設定します。指定できる値の範囲は 0（全世界）～ 21（個々の建物）です。上限は、選択したスポットで利用可能な地図データによって異なります。

例

Java

// Creates an Intent that will load a map of San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

// Creates an Intent that will load a map of San Francisco
val gmmIntentUri = Uri.parse("geo:37.7749,-122.4194")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

場所の検索

このインテントを使用して、指定したビューポート内に検索クエリを表示します。クエリの結果が 1 つしかない場合、このインテントを使用して、特定の場所や住所（ランドマーク、お店やサービス、地理的対象物、町など）にピンを表示できます。

geo:latitude,longitude?q=query
geo:0,0?q=my+street+address
geo:0,0?q=latitude,longitude(label)

パラメータ

地図の表示に使用するパラメータに加えて、検索では以下のパラメータがサポートされています。

  • q は、地図上でハイライト表示する場所を定義します。q パラメータは、すべての検索リクエストに必要です。場所は場所の名前または住所で指定できます。文字列は URL エンコードする必要があります。たとえば、「City Hall, New York, NY」のような住所は「City+Hall,New+York,NY」に変換します。

  • label を使用すると、地図上で識別される場所にカスタムラベルを設定できます。label は文字列として指定する必要があります。

一般的な検索キーワードを渡すと、Google マップは指定された緯度/経度の近くにある、条件に一致する場所を探します。場所が指定されていない場合、Google マップは付近のリスティングを探します。次に例を示します。

Java

// Search for restaurants nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

// Search for restaurants in San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

// Search for restaurants nearby
val gmmIntentUri = Uri.parse("geo:0,0?q=restaurants")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

// Search for restaurants in San Francisco
val gmmIntentUri =
  Uri.parse("geo:37.7749,-122.4194?q=restaurants")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

サンフランシスコのレストランを検索

クエリ文字列とともにズーム パラメータを指定すると、検索結果をさらに絞り込むことができます。次の例では、ズーム 10 を追加すると、付近ではなく都市レベルのレストランが検索されます。

Java

Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

val gmmIntentUri =
  Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

特定の住所を検索すると、その位置にピンが表示されます。

Java

Uri gmmIntentUri = Uri.parse("geo:0,0?q=1600 Amphitheatre Parkway, Mountain+View, California");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

val gmmIntentUri =
  Uri.parse("geo:0,0?q=1600 Amphitheatre Parkway, Mountain+View, California")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

上記の例では、緯度/経度 0,0 を設定していますが、住所をクエリ文字列として渡しています。特定の場所を検索する場合、緯度と経度は必要ありません。ただし、正確な住所が不明な場合は、座標を指定して検索結果をバイアスできます。たとえば、「Main Street」に対して住所検索を実行すると、返される結果の数は多くなります。

Java

// Searching for 'Main Street' will return too many results
Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");

Kotlin

// Searching for 'Main Street' will return too many results
val gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street")

インテント URI に緯度/経度を追加すると、特定の地域を優先して結果にバイアスをかけることができます。

Java

// Searches for 'Main Street' near San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

// Searches for 'Main Street' near San Francisco
val gmmIntentUri =
  Uri.parse("geo:37.7749,-122.4194?q=101+main+street")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

検索で 1 つの値が返されることがわかっている場合は、任意のラベルを渡すことをおすすめします。ラベルは文字列として指定する必要があり、地図上のマーカーの下に表示されます。ラベルは、q が緯度/経度座標として指定されている場合にのみ使用できます。

Java

// Display a label at the location of Google's Sydney office
Uri gmmIntentUri = Uri.parse("geo:0,0?q=Google+Sydney@-33.8666,151.1957");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

// Display a label at the location of Google's Sydney office
val gmmIntentUri =
  Uri.parse("geo:0,0?q=-33.8666,151.1957(Google+Sydney)")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

番地や緯度と経度の代わりに、plus code を使用すると、既知の場所にピンを表示できます。

Java

// Display the location of Google, San Francisco using a global plus code.
Uri gmmIntentUri = Uri.parse("http://plus.codes/849VQJQ5+XX");
// Equivalently, define the same location using a local plus code
gmmIntentUri = Uri.parse("https://plus.codes/QJQ5+XX,San%20Francisco");
// Construct and use the Intent as in the examples above

Kotlin

// Display the location of Google, San Francisco using a global plus code.
var gmmIntentUri = Uri.parse("http://plus.codes/849VQJQ5+XX")
// Equivalently, define the same location using a local plus code
gmmIntentUri = Uri.parse("https://plus.codes/QJQ5+XX,San%20Francisco")
// Construct and use the Intent as in the examples above

ターンバイターン方式ナビの起動

このインテントを使用して、指定した住所または座標へのターンバイターン方式のルート案内を含む Google マップ ナビゲーションを起動します。ルートは常にユーザーの現在地を起点として提供されます。

google.navigation:q=a+street+address
google.navigation:q=latitude,longitude

パラメータ

  • q: ナビゲーション検索の終点を設定します。この値は、緯度、経度の座標、またはクエリ形式の住所になります。複数の結果を返すクエリ文字列の場合は、最初の結果が選択されます。

  • mode は移動手段を設定します。mode はオプションで、次のいずれかに設定できます。

    • 車での d（デフォルト）
    • b: 自転車
    • オートバイ: l
    • w（徒歩）

  • avoid は、ルートで回避すべき対象物を設定します。avoid は省略可能で、次のいずれか 1 つ以上に設定できます。

    • 有料道路: t
    • 高速道路: h
    • フェリー: f

例

以下の Intent は、オーストラリアのシドニーのタロンガ動物園までのターンバイターン方式のナビゲーションをリクエストします。

Java

Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

val gmmIntentUri =
  Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

タロンガ動物園へのルート

通行料の支払いやフェリーの利用を希望しない場合は、このようなことを避けるためにルートをリクエストすることができます。

Java

Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

val gmmIntentUri =
  Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

少し運動したい場合は、自転車ルートをリクエストできます。

Java

Uri gmmIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&mode=b");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

val gmmIntentUri =
  Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&mode=b")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

自動二輪車を使う場合は、狭い道路や自動車では通行できない小道を含むルートをリクエストできます。以下の intent は、インドのルートを返します。

Java

Uri gmmIntentUri = Uri.parse("google.navigation:q=Connaught+Place,+New+Delhi,Delhi&mode=l");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

val gmmIntentUri =
  Uri.parse("google.navigation:q=Connaught+Place,+New+Delhi,Delhi&mode=l")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

ストリートビュー パノラマの表示

Google ストリートビューを起動するには、google.streetview インテントを使用します。Google ストリートビューは、対象地域全体について、指定された場所からのパノラマビューを提供します。ユーザーの投稿による 360°写真や、ストリートビューのスペシャル コレクションも利用できます。

google.streetview:cbll=latitude,longitude&cbp=0,bearing,0,zoom,tilt
google.streetview:panoid=id&cbp=0,bearing,0,zoom,tilt

パラメータ

すべての google.streetview URI には、cbll パラメータまたは panoid パラメータのいずれかを含める必要があります。

  • cbll は、緯度と経度をカンマ区切り値（46.414382,10.013988）として受け取ります。アプリは、この場所の近くで撮影されたパノラマを表示します。ストリートビューの画像は定期的に更新され、毎回わずかに異なる位置から撮影されることがあるため、画像の更新時に場所が異なるパノラマにスナップされる可能性があります。

  • panoid は特定のパノラマ ID です。panoid と cbll の両方が指定されている場合、Google マップはパノラマ ID を使用します。パノラマ ID は StreetViewPanoramaLocation オブジェクトから Android アプリで使用できます。

  • cbp は、カメラの初期の向きを調整する省略可能なパラメータです。cbp パラメータには 5 つのカンマ区切り値を指定できます。値はすべて省略可能です。最も重要な値は 2 番目、4 番目、5 番目の値で、それぞれ方向、ズーム、傾斜を設定します。1 つ目と 3 つ目の値はサポートされていないため、0 に設定する必要があります。

    • bearing: カメラのコンパス方位を北から時計回りの度数で示します。真北が 0、東が 90、南が 180、西が 270 です。bearing に渡される値はラップされます。つまり、0°、360°、720° はすべて同じ方向を指しています。bearing は、5 つのカンマ区切り値のうち 2 番目の値として定義されます。
    • zoom: カメラのズームレベルを設定します。デフォルトのズームレベルは 0 に設定されています。ズームを 1 にすると、倍率が 2 倍になります。ズームは、0 から現在のパノラマの最大ズームレベルの範囲内に固定されます。つまり、この範囲外の値はすべて、範囲内にある最も近い極値に設定されます。たとえば、-1 の値は 0 に設定されます。ズームは、5 つのカンマ区切り値の 4 つ目です。
    • tilt: カメラの角度（上または下）を指定します。範囲は -90 ～ 0 ～ 90 で、90 では真下を向き、0 では水平を向き、-90 では真上を向きます。

例

次に、ストリートビュー インテントの使用例をいくつか示します。

Java

// Displays an image of the Swiss Alps
Uri gmmIntentUri = Uri.parse("google.streetview:cbll=46.414382,10.013988");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

// Uses a PanoID to show an image from Maroubra beach in Sydney, Australia
Uri gmmIntentUri = Uri.parse("google.streetview:panoid=Iaa2JyfIggYAAAQfCZU9KQ");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

// Opens Street View between two Pyramids in Giza. The values passed to the
// cbp parameter will angle the camera slightly up, and towards the east.
Uri gmmIntentUri = Uri.parse("google.streetview:cbll=29.9774614,31.1329645&cbp=0,30,0,0,-15");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Kotlin

// Displays an image of the Swiss Alps
val gmmIntentUri =
  Uri.parse("google.streetview:cbll=46.414382,10.013988")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

// Uses a PanoID to show an image from Maroubra beach in Sydney, Australia
val gmmIntentUri =
  Uri.parse("google.streetview:panoid=Iaa2JyfIggYAAAQfCZU9KQ")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

// Opens Street View between two Pyramids in Giza. The values passed to the
// cbp parameter will angle the camera slightly up, and towards the east.
val gmmIntentUri =
  Uri.parse("google.streetview:cbll=29.9774614,31.1329645&cbp=0,30,0,0,-15")
val mapIntent = Intent(Intent.ACTION_VIEW, gmmIntentUri)
mapIntent.setPackage("com.google.android.apps.maps")
startActivity(mapIntent)

ストリートビューのピラミッド