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

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

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

概要

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

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

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

インテントリクエスト

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

アクション: Google マップのすべてのインテントは、View アクション（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)

パラメータ

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

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

カテゴリ検索

一般的な検索キーワードを指定すると、指定した緯度/経度の近くで、条件に合致する場所が検索されます。場所が指定されていない場合、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: 移動手段を設定します。モードは省略可能で、次のいずれかに設定できます。
- 車で 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.streetview インテントを使用して Google ストリートビューを起動します。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 は Android アプリの StreetViewPanoramaLocation オブジェクトで使用できます。
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 に設定されます。Zoom は、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)

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

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

概要

インテント リクエスト

Java

Kotlin

Java

Kotlin

Java

Kotlin

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

Java

Kotlin

マップを表示する

Java

Kotlin

場所の検索

カテゴリ検索

Java

Kotlin

Java

Kotlin

場所の検索

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

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

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

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

Java

Kotlin

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

インテントリクエスト

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