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

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

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

注: マップ URL を使用すると、プラットフォームをまたいで使用できる共通の URL を作成して、Google マップを起動したり、検索、ルート検索、地図表示、パノラマ画像の表示を行ったりできます。クロスプラットフォームの Maps URL を使用して Google マップを起動することをおすすめします。このユニバーサル URL では、ユーザーが利用しているプラットフォームに関係なく、地図に関するより幅広いリクエストを処理できるためです。Android 固有のマップインテントは、ターンバイターンナビゲーションなどのモバイルプラットフォームでのみ機能する可能性のある機能にのみ使用してください。

概要

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

位置とズームレベルを指定して地図を表示する。
位置やスポットを検索し、地図上に表示する。
ある地点から別の地点への経路を要求する。運転、徒歩、自転車の 3 つの移動手段のルートを返すことができます。
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 Maps Intents に渡す文字列はすべて 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 に設定していますが、住所をクエリ文字列として渡しています。特定の場所を検索する場合、緯度と経度は必要ありません。ただし、正確な住所が不明な場合は、座標を指定して検索結果を絞り込みます。たとえば、「メインストリート」に対して住所検索を行うと、あまりにも多くの結果が返されます。

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 は、経路で避けるべき機能を設定します。「任意」はオプションで、次のいずれかを設定できます。
- 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 マップインテント

インテントリクエスト

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