Windows マップ アプリの起動
アプリから Windows マップ アプリを起動する方法について説明します。 このトピックでは、bingmaps:、ms-drive-to:、ms-walk-to:、ms-settings: の各 URI (Uniform Resource Identifier) スキームについて説明します。 これらの URI スキームを使って、Windows マップ アプリを起動し、特定の地図、ルート案内、検索結果を表示したり、設定アプリから Windows マップ オフライン マップをダウンロードしたりします。
ヒント アプリから Windows マップ アプリを起動する方法について詳しくは、GitHub の Windows-universal-samples リポジトリからユニバーサル Windows プラットフォーム (UWP) の地図サンプルをダウンロードしてください。
URI の概要
URI スキームを使うと、ハイパーリンクのクリックによって (またはアプリでプログラム的に) アプリを開くことができます。 mailto: を使って新しいメールの作成を開始したり、http: を使って既定の Web ブラウザーを開いたりできるのと同様に、bingmaps:、ms-drive-to:、ms-walk-to: を使って Windows マップ アプリを開くことができます。
- bingmaps: URI は、位置情報、検索結果、ルート案内、交通情報用の地図を提供します。
- ms-drive-to: URI は、現在の場所からのターン バイ ターン方式の自動車ルート案内を提供します。
- ms-walk-to: URI は、現在の場所からのターン バイ ターン方式の徒歩ルート案内を提供します。
たとえば、次の URI は、Windows マップ アプリを開き、ニューヨークを中心とした地図を表示します。
<bingmaps:?cp=40.726966~-74.006076>
URI スキームについて次に説明します。
bingmaps:?query
この URI スキームでは、query は、次のようなパラメーター名と値の一連のペアを示します。
¶m1=value1¶m2=value2 …
使用可能なパラメーターの一覧については、bingmaps:、ms-drive-to:、ms-walk-to: のパラメーター リファレンスをご覧ください。 このトピックでも後で例を示します。
アプリからの URI の起動
アプリから Windows マップ アプリを起動するには、bingmaps:、ms-drive-to:、または ms-walk-to: URI を指定して LaunchUriAsync メソッドを呼び出します。 次の例では、前の例と同じ URI を起動します。 URI によるアプリの起動について詳しくは、「URI に応じた既定のアプリの起動」をご覧ください。
// Center on New York City
var uriNewYork = new Uri(@"bingmaps:?cp=40.726966~-74.006076");
// Launch the Windows Maps app
var launcherOptions = new Windows.System.LauncherOptions();
launcherOptions.TargetApplicationPackageFamilyName = "Microsoft.WindowsMaps_8wekyb3d8bbwe";
var success = await Windows.System.Launcher.LaunchUriAsync(uriNewYork, launcherOptions);
この例では、Windows マップ アプリを確実に起動するために LauncherOptions クラスを使っています。
既知の場所の表示
地図の表示する部分を制御するための多くのオプションがあります。 cp (中心点) パラメーターと rad (半径) パラメーターまたは lvl (ズーム レベル) パラメーターを使って、場所を表示し、ズーム インの程度を選択できます。 cp パラメーターを使う場合、hdg (向き) と pit (ピッチ) を指定して、表示する方向を制御できます。 もう 1 つの方法は、bb (境界ボックス) パラメーターを使って、表示する領域の東西南北の最大の座標を指定することです。
ビューの種類を制御するには、sty (スタイル) パラメーターと ss (Streetside) パラメーターを使います。 sty パラメーターは、道路図と航空写真表示を切り替えます。 ss パラメーターは、Streetside ビューに地図を配置します。 これらのパラメーターやその他のパラメーターについて詳しくは、bingmaps: のパラメーター リファレンスをご覧ください。
| サンプル URI | 結果 |
|---|---|
| bingmaps:? | マップ アプリを開きます。 |
| bingmaps:?cp=40.726966~-74.006076 | ニューヨークを中心とした地図を表示します。 |
| bingmaps:?cp=40.726966~-74.006076&lvl=10 | ズーム レベル 10 でニューヨークを中心とした地図を表示します。 |
| bingmaps:?bb=39.719_-74.52~41.71_-73.5 | bb 引数で指定された領域に基づいてニューヨーク市の地図を表示します。 |
| bingmaps:?bb=39.719_-74.52~41.71_-73.5&cp=47~-122 | 境界ボックスの引数で指定された領域に基づいてニューヨークの地図を表示します。 bb が指定されているため、cp 引数で指定されたシアトルの中心点は無視されます。 |
| bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16 | シーザーズ パレス (ラスベガス) という名前のポイントを使って地図を表示します。ズーム レベルは 16 に設定されます。 |
| bingmaps:?collection=point.40.726966_-74.006076_Some%255FBusiness | Some_Business (ラスベガス) という名前のポイントを使って地図を表示します。 |
| bingmaps:?cp=40.726966~-74.006076&trfc=1&sty=a | 航空写真の地図形式を使い、交通情報を有効にして、ニューヨーク市の地図を表示します。 |
| bingmaps:?cp=47.6204~-122.3491&sty=3d | スペース ニードルの 3D ビューを表示します。 |
| bingmaps:?cp=47.6204~-122.3491&sty=3d&rad=200&pit=75&hdg=165 | 半径 200 m、ピッチ 75 度、方位 165 度で、スペース ニードルの 3D ビューを表示します。 |
| bingmaps:?cp=47.6204~-122.3491&ss=1 | スペース ニードルの Streetside ビューを表示します。 |
検索結果を表示する
q パラメーターを使って場所を検索する場合には、検索語句をできるだけ具体的に示すこと、また cp、bb、または where の各パラメーターを使って、検索場所を指定することをお勧めします。 検索場所が指定されず、ユーザーの現在の場所が利用できない場合は、検索が意味のある結果を返さない場合があります。 検索結果は、最も適切な地図のビューに表示されます。 これらのパラメーターやその他のパラメーターについて詳しくは、bingmaps: のパラメーター リファレンスをご覧ください。
| サンプル URI | 結果 |
|---|---|
| bingmaps:?q=1600%20Pennsylvania%20Ave,%20Washington,%20DC | 地図を表示し、ワシントンD.C. のホワイト ハウスの住所を検索します。 |
| bingmaps:?q=coffee&where=Seattle | シアトルでコーヒーを検索します。 |
| bingmaps:?cp=40.726966~-74.006076&where=New%20York | 指定した中心点の近くのニューヨークを検索します。 |
| bingmaps:?bb=39.719_-74.52~41.71_-73.5&q=pizza | 指定した境界ボックス (ニューヨーク市) の中でピザを検索します。 |
複数のポイントの表示
地図上のポイントのカスタム セットを表示するには、collection パラメーターを使います。 ポイントが複数ある場合は、ポイントの一覧が表示されます。 コレクションには 25 個までポイントを含めることができます。これらのポイントは指定された順序で表示されます。 コレクションは、検索要求やルート案内の要求よりも優先されます。 このパラメーターやその他のパラメーターについて詳しくは、bingmaps: のパラメーター リファレンスをご覧ください。
| サンプル URI | 結果 |
|---|---|
| bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace | ラスベガスのシーザーズ パレスを検索し、その結果を地図に表示します (最適な地図のビューで表示されます)。 |
| bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16 | ラスベガスにあるシーザーズ パレスという名前のプッシュピンを表示し、ズーム レベルを 16 に設定します。 |
| bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669 | ラスベガスにあるシーザーズ パレスおよびベラジオという名前のプッシュピンを表示し、ズーム レベルを 16 に設定します。 |
| bingmaps:?collection=point.40.726966_-74.006076_Fake%255FBusiness%255Fwith%255FUnderscore | Fake_Business_with_Underscore という名前のプッシュピンと共にニューヨークを表示します。 |
| bingmaps:?collection=name.Hotel%20List~point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669 | Hotel List という名前の一覧、およびラスベガスにあるシーザーズ パレスとベラジオの 2 つのプッシュピンを表示し、ズーム レベルを 16 に設定します。 |
ルート案内と交通情報の表示
rtp パラメーターを使って、2 つのポイント間のルート案内を表示できます。これらのポイントは、住所または緯度と経度の座標で指定できます。 交通情報を表示するには、trfc パラメーターを使います。 ルート案内の種類 (自動車、徒歩、乗り換え案内) を指定するには、mode パラメーターを使います。 mode が指定されていない場合、ルート案内は、ユーザーの交通手段の設定のモードを使って提供されます。 これらのパラメーターやその他のパラメーターについて詳しくは、bingmaps: のパラメーター リファレンスをご覧ください。
| サンプル URI | 結果 |
|---|---|
| bingmaps:?rtp=pos.44.9160_-110.4158~pos.45.0475_-109.4187 | ポイント ツー ポイントのルート案内と共に地図を表示します。 mode が指定されていないため、ルート案内は、ユーザーの交通手段の設定のモードを使って提供されます。 |
| bingmaps:?cp=43.0332~-87.9167&trfc=1 | ウィスコンシン州のミルウォーキーを中心とした地図と交通情報を表示します。 |
| bingmaps:?rtp=adr.One Microsoft Way, Redmond, WA 98052~pos.39.0731_-108.7238 | 指定した住所から指定した場所までのルート案内と共に地図を表示します。 |
| bingmaps:?rtp=adr.1%20Microsoft%20Way,%20Redmond,%20WA,%2098052~pos.36.1223_-111.9495_Grand%20Canyon%20northern%20rim | 1 Microsoft Way, Redmond, WA、98052 からグランドキャニオンの北端までのルート案内を表示します。 |
| bingmaps:?rtp=adr.Davenport, CA~adr.Yosemite Village | 指定した場所から指定したランドマークまでの自動車ルート案内と共に地図を表示します。 |
| bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=d | カリフォルニア州のマウンテンビューからカリフォルニア州のサンフランシスコ国際空港までの自動車ルート案内を表示します。 |
| bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=w | カリフォルニア州のマウンテンビューからカリフォルニア州のサンフランシスコ国際空港までの徒歩ルート案内を表示します。 |
| bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=t | カリフォルニア州のマウンテンビューからカリフォルニア州のサンフランシスコ国際空港までの乗り換え案内を表示します。 |
ターン バイ ターン方式のルート案内の表示
ms-drive-to: と ms-walk-to: の各 URI スキームでは、直接ターン バイ ターン方式のルート案内を起動できます。 これらの URI スキームでは、ユーザーの現在の場所からのルート案内のみを提供できます。 ユーザーの現在の場所を含まないポイント間のルート案内を提供する必要がある場合は、前のセクションで説明した bingmaps: URI スキームを使います。 これらの URI スキームについて詳しくは、ms-drive-to: と ms-walk-to: のパラメーター リファレンスをご覧ください。
重要ms-drive-to: または ms-walk-to: の URI スキームが呼び出されると、マップ アプリは、デバイスで GPS 位置情報の修正が行われたことがあるかどうかを確認します。 行われたことがある場合は、ターン バイ ターン方式のルート案内に進みます。 行われたことがない場合は、「ルート案内と交通情報の表示」で説明したルートの概要を表示します。
| サンプル URI | 結果 |
|---|---|
| ms-drive-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake | 現在の場所からグリーン湖までのターン バイ ターン方式の自動車ルート案内と共に地図を表示します。 |
| ms-walk-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake | 現在の場所からグリーン湖までのターン バイ ターン方式の徒歩ルート案内と共に地図を表示します。 |
オフライン マップのダウンロード
ms-settings: URI スキームでは、設定アプリで特定のページを直接起動することができます。 ms-settings: URI スキームでは、マップ アプリが起動されませんが、設定アプリでオフライン マップ ページを直接起動し、マップ アプリが使用するオフライン マップをダウンロードするための確認ダイアログ ボックスを表示することができます。 URI スキームは、緯度と経度で指定されたポイントを受け取り、そのポイントが含まれる地域のオフライン マップが利用できるかどうかを自動的に判定します。 渡された緯度と経度が複数のダウンロード地域内にある場合、ユーザーは、確認ダイアログ ボックスでダウンロードする地域を選択できます。 そのポイントが含まれる地域のオフライン マップが利用できない場合、設定アプリのオフライン マップ ページがエラー ダイアログと共に表示されます。
| サンプル URI | 結果 |
|---|---|
| ms-settings:maps-downloadmaps?latlong=47.6,-122.3 | 設定アプリで、確認ダイアログ ボックスが表示されたオフライン マップ ページを開き、緯度と経度で指定されたポイントが含まれた地域のマップをダウンロードします。 |
bingmaps: のパラメーター リファレンス
次に示す各パラメーターの構文は、拡張バッカスナウア記法 (ABNF) を使って表されています。
| パラメーター | 定義 | ABNF での定義と例 | 詳細 |
|---|---|---|---|
cp |
中心点 |
cp = "cp=" cpval cpval = degreeslat "~" degreeslon degreeslat = ["-"] 1*3DIGIT ["." 1*7DIGIT] degreeslon = ["-"] 1*2DIGIT ["." 1*7DIGIT] 例: cp=40.726966~-74.006076 |
どちらの値も、10 進角で表し、チルダ (~) で区切る必要があります。 有効な経度の値の範囲は -180 ～ +180 です (両端の値を含む)。 有効な緯度の値の範囲は -90 ～ +90 です (両端の値を含む)。 |
bb |
境界ボックス |
bb = "bb=" southlatitude "_" westlongitude "~" northlatitude "_" eastlongitude southlatitude = degreeslat northlatitude = degreeslat westlongitude = degreeslon eastlongitude = degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] 例: bb=39.719_-74.52~41.71_-73.5 |
境界ボックスを指定する四角形の領域。10 進角で表し、左下隅と右上隅を区別するためにチルダ (~) を使います。 それぞれの緯度と経度は、アンダー スコア (_) で区切られます。 有効な経度の値の範囲は -180 ～ +180 です (両端の値を含む)。 有効な緯度の値の範囲は -90 ～ +90 です (両端の値を含む)。 境界ボックスが提供されている場合、cp パラメーターと lvl パラメーターは無視されます。 |
where |
場所 |
where = "where=" whereval whereval = 1*( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "*" / "+" / "," / ";" / ":" / "@" / "/" / "?") 例: where=1600%20Pennsylvania%20Ave,%20Washington,%20DC |
特定の所在地、ランドマーク、または場所を検索するための語句。 |
q |
クエリ語句 |
q = "q=" whereval 例: q=mexican%20restaurants |
各地のビジネスや業種を検索するための語句。 |
lvl |
ズーム レベル |
lvl = "lvl=" 12DIGIT ["." 12DIGIT] 例: lvl=10.50 |
地図ビューのズーム レベルを定義します。 有効な値は 1 ～ 20 です。1 は、最も縮小された状態で表示します。 |
sty |
スタイル |
sty = "sty=" ("a" / "r"/"3d") 例: sty=a |
地図の形式を定義します。 このパラメーターの有効な値は次のとおりです。
Windows 10 では、航空写真表示と 3D ビューのスタイルは同じです。
注sty パラメーターを省略すると、sty=r と同じ結果が表示されます。
|
rad |
Radius |
rad = "rad=" 1*8DIGIT 例: rad=1000 |
目的の地図ビューを表す円形領域です。 半径の値はメートル単位で指定します。 |
pit |
[Pitch] (傾斜) |
pit = "pit=" pitch 例: pit=60 |
地図を表示する角度を指定します。90 は水平方向を見ること (最大) を表し、0 は真下を見下ろすこと (最小) を表します。 有効なピッチの値の範囲は 0 ～ 90 です (両端の値を含む)。 |
hdg |
[Heading] (方向) |
hdg = "hdg=" heading 例: hdg=180 |
地図の向いている方位を角度で指定します。0 または 360 は北、90 は東、180 は南、270 は西を表します。 |
ss |
Streetside |
ss = "ss=" BIT 例: ss=1 |
注 ストリート レベルの画像は、すべての地域で利用できるわけではありません。
|
trfc |
トラフィック |
trfc = "trfc=" BIT 例: trfc=1 |
交通情報を地図に含めるかどうかを指定します。 trfc パラメーターを省略すると、
注 交通情報のデータは、すべての地域で利用できるわけではありません。
|
rtp |
ルート |
rtp = "rtp=" (waypoint "~" [waypoint]) / ("~" waypoint) waypoint = ("pos." point) / ("adr." whereval) point = "point." pointval ["_" title] pointval = degreeslat "" degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] title = whereval whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") 例: rtp=adr.Mountain%20View,%20CA~adr.SFO rtp=adr.One%20Microsoft%20Way,%20Redmond,%20WA~pos.45.23423_-122.1232 _My%20Picnic%20Spot |
地図上に表示するルートの開始地点と終了地点を、チルダ (~) で区切って定義します。 各中間点は、緯度、経度、オプションのタイトルを使った位置、または住所の識別情報を使って定義します。 完全なルートとは、中間点が 2 つだけ含まれるルートです。 たとえば、2 つの中間点を持つルートは、 不完全なルートを指定することもできます。 たとえば、ルートの開始地点だけを定義する場合は、 ルートの終点のみが指定されている場合は、 不完全なルートが指定されている場合は、ルートの線は表示されません。 mode パラメーターと組み合わせて使うと、交通手段のモード (自動車、公共交通機関、徒歩) を指定できます。 mode が指定されていない場合、ルート案内は、ユーザーの交通手段の設定のモードを使って提供されます。
注pos パラメーターの値によって場所が指定されている場合、その場所に対してタイトルを使うことができます。 緯度と経度が表示される代わりに、タイトルが表示されます。
|
mode |
交通手段モード |
mode = "mode=" ("d" / "t" / "w") 例: mode=d |
交通手段モードを定義します。 このパラメーターの有効な値は次のとおりです。
交通手段案内の rtp パラメーターと組み合わせて使います。 mode が指定されていない場合、ルート案内は、ユーザーの交通手段の設定のモードを使って提供されます。 現在の位置情報からこのモード用のルート案内に入力するルート パラメーターなしに、mode を提供することができます。 |
collection |
コレクション |
collection = "collection="(name"~"/)point["~"point] name = "name." whereval whereval = 1( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?") point = "point." pointval ["_" title] pointval = degreeslat "" degreeslon degreeslat = ["-"] 13DIGIT ["." 17DIGIT] degreeslon = ["-"] 12DIGIT ["." 17DIGIT] title = whereval 例: collection=name.My%20Trip%20Stops~point.36.116584_-115.176753_Las%20Vegas~point.37.8268_-122.4798_Golden%20Gate%20Bridge |
地図と一覧に追加されるポイントのコレクションです。 name パラメーターを使用して、ポイントのコレクションに名前を付けることができます。 ポイントは、緯度、経度、およびオプションのタイトルを使用して指定されます。 名前と複数のポイントをチルダ (~) で区切ります。 指定した項目にチルダが含まれている場合は、そのチルダを 重要 指定した項目にアンダースコアが含まれている場合は、そのアンダースコアを %255F としてダブル エンコードしてください。 |
ms-drive-to: のパラメーター リファレンス
ターン バイ ターン方式の自動車ルート案内の要求を起動する URI は、エンコードする必要がありません。その形式は、次のようになります。
注 この URI スキームでは出発地を指定しません。 常に、現在の場所が出発地であると見なされます。 現在の場所以外の出発地を指定する必要がある場合は、「ルート案内と交通情報の表示」をご覧ください。
| パラメーター | 定義 | 例 | 詳細 |
|---|---|---|---|
| destination.latitude | 目的地の緯度 | 例: destination.latitude=47.6451413797194 | 目的地の緯度です。 有効な緯度の値の範囲は -90 ～ +90 です (両端の値を含む)。 |
| destination.longitude | 目的地の経度 | 例: destination.longitude=-122.141964733601 | 目的地の経度です。 有効な経度の値の範囲は -180 ～ +180 です (両端の値を含む)。 |
| destination.name | 目的地の名前 | 例: destination.name=Redmond, WA | 対象の名前です。 destination.name 値をエンコードする必要はありません。 |
ms-walk-to: のパラメーター リファレンス
ターン バイ ターン方式の徒歩ルート案内の要求を起動する URI は、エンコードする必要がありません。その形式は、次のようになります。
注 この URI スキームでは出発地を指定しません。 常に、現在の場所が出発地であると見なされます。 現在の場所以外の出発地を指定する必要がある場合は、「ルート案内と交通情報の表示」をご覧ください。
| パラメーター | 定義 | 例 | 詳細 |
|---|---|---|---|
| destination.latitude | 目的地の緯度 | 例: destination.latitude=47.6451413797194 | 目的地の緯度です。 有効な緯度の値の範囲は -90 ～ +90 です (両端の値を含む)。 |
| destination.longitude | 目的地の経度 | 例: destination.longitude=-122.141964733601 | 目的地の経度です。 有効な経度の値の範囲は -180 ～ +180 です (両端の値を含む)。 |
| destination.name | 目的地の名前 | 例: destination.name=Redmond, WA | 対象の名前です。 destination.name 値をエンコードする必要はありません。 |
ms-settings: のパラメーター リファレンス
ms-settings: URI スキームのマップ アプリ固有のパラメーターの構文は、次のように定義されます。 maps-downloadmaps は、ms-settings: URI と共に ms-settings:maps-downloadmaps? の形式で指定され、オフライン マップの設定ページを示します。
| パラメーター | 定義 | 例 | 詳細 |
|---|---|---|---|
| latlong | オフライン マップの地域を定義するポイント。 | 例: latlong=47.6,-122.3 | GeoPoint は、コンマ区切りの緯度と経度で指定されます。 有効な緯度の値の範囲は -90 ～ +90 です (両端の値を含む)。 有効な経度の値の範囲は -180 ～ +180 です (両端の値を含む)。 |