Windows マップ アプリの起動

アプリから Windows マップ アプリを起動する方法について説明します。 このトピックでは、 bingmaps:、 ms-drive-to:、 ms-walk-to:、ms-settings: の Uniform Resource Identifier (URI) スキームについて説明します。 特定のマップ、ルート案内、および検索結果のためにWindows マップ アプリを起動したり、設定アプリからWindows マップのオフライン マップをダウンロードしたりするために、これらの URI スキームを使用します。

ヒント アプリから Windows マップ アプリを起動する方法については、GitHub の Windows ユニバーサル サンプル リポジトリから、ユニバーサル Windows プラットフォーム (UWP) マップ サンプルをダウンロードしてください。

URI について

URI スキームを使用すると、ハイパーリンクをクリックして (またはアプリ内でプログラムによって) アプリを開けるようになります。 mailto: を使用した新しい Email の開始や、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);

この例では、LauncherOptions クラスを使用して、Windows マップ アプリが適切に起動されるようにしています。

既知の場所を表示する

マップのどの部分を表示するかを制御するために、多くのオプションが用意されています。 cp (中心点) パラメーターを rad (半径) パラメーターまたは lvl (ズーム レベル) パラメーターのどちらかと共に使用すると、ある位置を表示し、そこにズームでどの程度接近するかを選択できます。 cp パラメーターを使用する際には、hdg (方位) と pit (ピッチ) を指定して、視線の方向を制御することもできます。 他には、bb (境界ボックス) パラメーターを使用して、表示する領域の南、東、北、および西の最大座標を指定する方法があります。

ビューの種類を制御するには、sty (スタイル) パラメーターと ss (ストリートサイド) パラメーターを使用します。 sty パラメーターを使用すると、道路標示と航空写真を切り替えることができます。 ss パラメーターは、マップをストリートサイド ビューに設定します。 これらの情報とその他のパラメーターの詳細については、「bingmaps: パラメーター リファレンス」を参照してください。

検索結果を表示する

q パラメーターを使用して場所を検索する場合は、条件を可能な限り具体的にし、cp、bb、または where パラメーターを使用して検索場所を指定するようにお勧めします。 検索場所が指定されておらず、ユーザーの現在の場所を使用できない場合、検索が意味のある結果を返さない場合があります。 検索結果は、最も適切なマップ ビューに表示されます。 これらの情報とその他のパラメーターの詳細については、「bingmaps: パラメーター リファレンス」を参照してください。

複数のポイントを表示する

collection パラメーターを使用すると、マップ上にポイントのカスタム セットが表示できます。 ポイントが複数ある場合は、ポイントの一覧が表示されます。 コレクションには最大 25 個のポイントを含めることができ、指定された順序で一覧表示されます。 コレクションは、検索とルート案内の要求よりも優先されます。 このパラメーターとその他の詳細な情報については、「bingmaps: パラメーターリファレンス」を参照してください。

ルート案内と交通情報を表示する

rtp パラメーターを使用すると、2 つのポイント間のルート案内を表示できます。これらのポイントは、住所または緯度と経度の座標で指定します。 交通情報を表示するには、 trfc パラメーターを使用します。 ルート案内の種類 (運転、歩行、または乗換) を指定するには、mode パラメーターを使用します。 mode が指定されていない場合は、ユーザーが設定した移動モードを使用してルート案内が提供されます。 これらのパラメーターとその他の詳細な情報については、「bingmaps: パラメーターリファレンス」を参照してください。

道案内を表示する

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 位置情報の修正が行われたことがあるかどうかを確認します。 修正があった場合、マップ アプリは道路に沿ったルート案内に進みます。 修正がない場合は、「ルート案内と交通情報を表示する」の説明にあるように、アプリはルートの概要を表示します。

オフライン マップをダウンロードする

ms-settings: URI スキームを使用すると、設定 アプリ内の特定のページを直接起動できます。 ms-settings: URI スキームはマップ アプリでは起動しませんが、設定 アプリの [オフライン マップ] ページを直接起動でき、マップ アプリで使用されているオフライン マップをダウンロードするための確認ダイアログを表示することができます。 URI スキームは、緯度と経度で指定されたポイントを受け入れ、そのポイントを含むリージョンについて、利用可能なオフライン マップが存在するかどうかを自動的に判断します。 渡された緯度と経度が複数のダウンロード リージョンに含まれている場合、確認ダイアログは、ユーザーに対しダウンロードするリージョンの選択を促します。 渡されたポイントを含むリージョンでオフライン マップを使用できない場合は、設定アプリのオフライン マップ ページがエラー ダイアログと共に表示されます。

bingmaps: パラメーター リファレンス

この表の中で、各パラメーターの構文は拡張 Backus-Naur Form (ABNF) を使用して示されています。

ms-drive-to: パラメーター リファレンス

道路に沿ったドライブ ルート案内の要求を起動する URI はエンコードの必要はなく、次の形式を使用します。

注 この URI スキームでは出発地を指定しません。 始点には常に現在の場所が想定されます。 始点を現在の場所以外に指定する必要がある場合は、「ルート案内と交通情報を表示する」を参照してください。

ms-walk-to: パラメーター リファレンス

道路に沿った徒歩ルート案内の要求を開始する URI はエンコードの必要はなく、次の形式を使用します。

注 この URI スキームでは出発地を指定しません。 始点には常に現在の場所が想定されます。 始点を現在の場所以外に指定する必要がある場合は、「ルート案内と交通情報を表示する」を参照してください。  

ms-settings: パラメーター リファレンス

ms-settings: URI スキームについての、マップ アプリに固有のパラメーター構文を以下に定義します。 maps-downloadmaps は、ms-settings: URI と共に (ms-settings:maps-downloadmaps? の形式で) 指定され、オフライン マップ設定ページを示します。