Windows マップ アプリの起動Launch the Windows Maps app

アプリから Windows マップ アプリを起動する方法について説明します。Learn how to launch the Windows Maps app from your app. このトピックでは、bingmaps:、*ms-drive-to:、ms-walk-to:ms-settings: の各 URI (Uniform Resource Identifier) スキームについて説明します。This topic describes the *bingmaps:, *ms-drive-to:, ms-walk-to:* and ms-settings: Uniform Resource Identifier (URI) schemes. これらの URI スキームを使って、Windows マップ アプリを起動し、特定の地図、ルート案内、検索結果を表示したり、設定アプリから Windows マップ オフライン マップをダウンロードしたりします。Use these URI schemes to launch the Windows Maps app to specific maps, directions, and search results or to download Windows Maps offline maps from the Settings app.

ヒント アプリから Windows マップ アプリを起動する方法について詳しくは、GitHub の Windows-universal-samples リポジトリからユニバーサル Windows プラットフォーム (UWP) の地図サンプルをダウンロードしてください。Tip To learn more about launching the Windows Maps app from your app, download the Universal Windows Platform (UWP) map sample from the Windows-universal-samples repo on GitHub.

URI の概要Introducing URIs

URI スキームを使うと、ハイパーリンクのクリックによって (またはアプリでプログラム的に) アプリを開くことができます。URI schemes let you open apps by clicking hyperlinks (or programmatically, in your app). mailto: を使って新しいメールの作成を開始したり、http: を使って既定の Web ブラウザーを開いたりできるのと同様に、bingmaps:ms-drive-to:ms-walk-to: を使って Windows マップ アプリを開くことができます。Just as you can start a new email using mailto: or open a web browser using http:, you can open the Windows maps app using bingmaps:, ms-drive-to:, and ms-walk-to:.

  • bingmaps: URI は、位置情報、検索結果、ルート案内、交通情報用の地図を提供します。The bingmaps: URI provides maps for locations, search results, directions, and traffic.
  • ms-drive-to: URI は、現在の場所からのターン バイ ターン方式の自動車ルート案内を提供します。The ms-drive-to: URI provides turn-by-turn driving directions from your current location.
  • ms-walk-to: URI は、現在の場所からのターン バイ ターン方式の徒歩ルート案内を提供します。The ms-walk-to: URI provides turn-by-turn walking directions from your current location.

たとえば、次の URI は、Windows マップ アプリを開き、ニューヨークを中心とした地図を表示します。For example, the following URI opens the Windows Maps app and displays a map centered over New York City.

<bingmaps:?cp=40.726966~-74.006076>

ニューヨークを中心とした地図。

URI スキームについて次に説明します。Here is a description of the URI scheme:

bingmaps:?querybingmaps:?query

この URI スキームでは、query は、次のようなパラメーター名と値の一連のペアを示します。In this URI scheme, query is a series of parameter name/value pairs:

&param1=value1&param2=value2 …&param1=value1&param2=value2 …

使用可能なパラメーターの一覧については、bingmaps:ms-drive-to:ms-walk-to: のパラメーター リファレンスをご覧ください。For a full list of the available parameters, see the bingmaps:, ms-drive-to:, and ms-walk-to: parameter reference. このトピックでも後で例を示します。There are also examples later in this topic.

アプリからの URI の起動Launch a URI from your app

アプリから Windows マップ アプリを起動するには、bingmaps:ms-drive-to:、または ms-walk-to: URI を指定して LaunchUriAsync メソッドを呼び出します。To launch the Windows Maps app from your app, call the LaunchUriAsync method with a bingmaps:, ms-drive-to:, or ms-walk-to: URI. 次の例では、前の例と同じ URI を起動します。The following example launches the same URI from the previous example. URI によるアプリの起動について詳しくは、「URI に応じた既定のアプリの起動」をご覧ください。For more info about launching apps via URI, see Launch the default app for a 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 クラスを使っています。In this example, the LauncherOptions class is used to help ensure the Windows Maps app is launched.

既知の場所の表示Display known locations

地図の表示する部分を制御するための多くのオプションがあります。There are many options to control which part of the map to show. cp (中心点) パラメーターと rad (半径) パラメーターまたは lvl (ズーム レベル) パラメーターを使って、場所を表示し、ズーム インの程度を選択できます。You can use the cp (center point) parameter with either the rad (radius) or the lvl (zoom level) parameters to show a location and choose how close to zoom in to it. cp パラメーターを使う場合、hdg (向き) と pit (ピッチ) を指定して、表示する方向を制御できます。When you use the cp parameter, you can also specify a hdg (heading) and pit (pitch) to control what direction to look. もう 1 つの方法は、bb (境界ボックス) パラメーターを使って、表示する領域の東西南北の最大の座標を指定することです。Another method is to use the bb (bounding box) parameter to provide the maximum south, east, north, and west coordinates of the area you want to show.

ビューの種類を制御するには、sty (スタイル) パラメーターと ss (Streetside) パラメーターを使います。To control the type of view, use the sty (style) and ss (Streetside) parameters. sty パラメーターは、道路図と航空写真表示を切り替えます。The sty parameter lets you switch between road and aerial views. ss パラメーターは、Streetside ビューに地図を配置します。The ss parameter puts the map into a Streetside view. これらのパラメーターやその他のパラメーターについて詳しくは、bingmaps: のパラメーター リファレンスをご覧ください。For more info about these and other parameters, see the bingmaps: parameter reference.

サンプル URISample URI 結果Results
bingmaps:?bingmaps:? マップ アプリを開きます。Opens the Maps app.
bingmaps:?cp=40.726966~-74.006076bingmaps:?cp=40.726966~-74.006076 ニューヨークを中心とした地図を表示します。Displays a map centered over New York City.
bingmaps:?cp=40.726966~-74.006076&lvl=10bingmaps:?cp=40.726966~-74.006076&lvl=10 ズーム レベル 10 でニューヨークを中心とした地図を表示します。Displays a map centered over New York City with a zoom level of 10.
bingmaps:?bb=39.719_-74.52~41.71_-73.5bingmaps:?bb=39.719_-74.52~41.71_-73.5 bb 引数で指定された領域に基づいてニューヨーク市の地図を表示します。Displays a map of New York City, which is the area specified in the bb argument.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&cp=47~-122bingmaps:?bb=39.719_-74.52~41.71_-73.5&cp=47~-122 境界ボックスの引数で指定された領域に基づいてニューヨークの地図を表示します。Displays a map of New York City, which is the area specified in the bounding box argument. bb が指定されているため、cp 引数で指定されたシアトルの中心点は無視されます。The center point for Seattle specified in the cp argument is ignored because bb is specified.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16 シーザーズ パレス (ラスベガス) という名前のポイントを使って地図を表示します。ズーム レベルは 16 に設定されます。Displays a map with a point named Caesars Palace (in Las Vegas) and sets the zoom level to 16.
bingmaps:?collection=point.40.726966_-74.006076_Some%255FBusinessbingmaps:?collection=point.40.726966_-74.006076_Some%255FBusiness Some_Business (ラスベガス) という名前のポイントを使って地図を表示します。Displays a map with a point named Some_Business (in Las Vegas).
bingmaps:?cp=40.726966~-74.006076&trfc=1&sty=abingmaps:?cp=40.726966~-74.006076&trfc=1&sty=a 航空写真の地図形式を使い、交通情報を有効にして、ニューヨーク市の地図を表示します。Displays a map of New York City with traffic on and aerial map style.
bingmaps:?cp=47.6204~-122.3491&sty=3dbingmaps:?cp=47.6204~-122.3491&sty=3d スペース ニードルの 3D ビューを表示します。Displays a 3D view of the Space Needle.
bingmaps:?cp=47.6204~-122.3491&sty=3d&rad=200&pit=75&hdg=165bingmaps:?cp=47.6204~-122.3491&sty=3d&rad=200&pit=75&hdg=165 半径 200 m、ピッチ 75 度、方位 165 度で、スペース ニードルの 3D ビューを表示します。Displays a 3D view of the Space Needle with a radius of 200m, a pitch of 75 degrees, and a heading of 165 degrees.
bingmaps:?cp=47.6204~-122.3491&ss=1bingmaps:?cp=47.6204~-122.3491&ss=1 スペース ニードルの Streetside ビューを表示します。Displays a Streetside view of the Space Needle.

検索結果の表示Display search results

q パラメーターを使って場所を検索する場合には、検索語句をできるだけ具体的に示すこと、また cpbb、または where の各パラメーターを使って、検索場所を指定することをお勧めします。When searching for places using the q parameter, we recommend making the terms as specific as possible and using the cp, bb, or where parameters to specify a search location. 検索場所が指定されず、ユーザーの現在の場所が利用できない場合は、検索が意味のある結果を返さない場合があります。If you do not specify a search location and the user's current location isn't available, the search may not return meaningful results. 検索結果は、最も適切な地図のビューに表示されます。Search results are displayed in the most appropriate map view. これらのパラメーターやその他のパラメーターについて詳しくは、bingmaps: のパラメーター リファレンスをご覧ください。For more info about these and other parameters, see the bingmaps: parameter reference.

サンプル URISample URI 結果Results
bingmaps:?q=1600%20Pennsylvania%20Ave,%20Washington,%20DCbingmaps:?q=1600%20Pennsylvania%20Ave,%20Washington,%20DC 地図を表示し、ワシントンD.C. のホワイト ハウスの住所を検索します。Displays a map and searches for the address of the White House in Washington, D.C.
bingmaps:?q=coffee&where=Seattlebingmaps:?q=coffee&where=Seattle シアトルでコーヒーを検索します。Searches for coffee in Seattle.
bingmaps:?cp=40.726966~-74.006076&where=New%20Yorkbingmaps:?cp=40.726966~-74.006076&where=New%20York 指定した中心点の近くのニューヨークを検索します。Searches for New York near the specified center point.
bingmaps:?bb=39.719_-74.52~41.71_-73.5&q=pizzabingmaps:?bb=39.719_-74.52~41.71_-73.5&q=pizza 指定した境界ボックス (ニューヨーク市) の中でピザを検索します。Searches for pizza in the specified bounding box (that is, in New York City).

複数のポイントの表示Display multiple points

地図上のポイントのカスタム セットを表示するには、collection パラメーターを使います。Use the collection parameter to show a custom set of points on the map. ポイントが複数ある場合は、ポイントの一覧が表示されます。If there is more than one point, a list of points is displayed. コレクションには 25 個までポイントを含めることができます。これらのポイントは指定された順序で表示されます。There can be up to 25 points in a collection and they are listed in the order provided. コレクションは、検索要求やルート案内の要求よりも優先されます。The collection takes precedence over search and directions requests. このパラメーターやその他のパラメーターについて詳しくは、bingmaps: のパラメーター リファレンスをご覧ください。For more info about this parameter and others, see the bingmaps: parameter reference.

サンプル URISample URI 結果Results
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palacebingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace ラスベガスのシーザーズ パレスを検索し、その結果を地図に表示します (最適な地図のビューで表示されます)。Searches for Caesar's Palace in Las Vegas and displays the results on a map in the best map view.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace&lvl=16 ラスベガスにあるシーザーズ パレスという名前のプッシュピンを表示し、ズーム レベルを 16 に設定します。Displays a pushpin named Caesars Palace in Las Vegas and zooms to level 16.
bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669bingmaps:?collection=point.36.116584_-115.176753_Caesars%20Palace~point.36.113126_-115.175188_The%20Bellagio&lvl=16&cp=36.114902~-115.176669 ラスベガスにあるシーザーズ パレスおよびベラジオという名前のプッシュピンを表示し、ズーム レベルを 16 に設定します。Displays a pushpin named Caesars Palace and a pushpin named The Bellagio in Las Vegas and zooms to level 16.
bingmaps:?collection=point.40.726966_-74.006076_Fake%255FBusiness%255Fwith%255FUnderscorebingmaps:?collection=point.40.726966_-74.006076_Fake%255FBusiness%255Fwith%255FUnderscore Fake_Business_with_Underscore という名前のプッシュピンと共にニューヨークを表示します。Displays New York with a pushpin named 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.176669bingmaps:?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 に設定します。Displays a list named Hotel List and two pushpins for Caesars Palace and The Bellagio in Las Vegas and zooms to level 16.

ルート案内と交通情報の表示Display directions and traffic

rtp パラメーターを使って、2 つのポイント間のルート案内を表示できます。これらのポイントは、住所または緯度と経度の座標で指定できます。You can display directions between two points using the rtp parameter; those points can be either addresses or latitude and longitude coordinates. 交通情報を表示するには、trfc パラメーターを使います。Use the trfc parameter to show traffic information. ルート案内の種類 (自動車、徒歩、乗り換え案内) を指定するには、mode パラメーターを使います。To specify the type of directions: driving, walking, or transit, use the mode parameter. mode が指定されていない場合、ルート案内は、ユーザーの交通手段の設定のモードを使って提供されます。If mode isn't specified, directions will be provided using the user's preferred mode of transportation. これらのパラメーターやその他のパラメーターについて詳しくは、bingmaps: のパラメーター リファレンスをご覧ください。For more info about these parameters and others, see the bingmaps: parameter reference.

ルート案内の例

サンプル URISample URI 結果Results
bingmaps:?rtp=pos.44.9160_-110.4158~pos.45.0475_-109.4187bingmaps:?rtp=pos.44.9160_-110.4158~pos.45.0475_-109.4187 ポイント ツー ポイントのルート案内と共に地図を表示します。Displays a map with point-to-point directions. mode が指定されていないため、ルート案内は、ユーザーの交通手段の設定のモードを使って提供されます。Because mode is not specified, directions will be provided using the user's mode of transportation preference.
bingmaps:?cp=43.0332~-87.9167&trfc=1bingmaps:?cp=43.0332~-87.9167&trfc=1 ウィスコンシン州のミルウォーキーを中心とした地図と交通情報を表示します。Displays a map centered over Milwaukee, WI with traffic.
bingmaps:?rtp=adr.One Microsoft Way, Redmond, WA 98052~pos.39.0731_-108.7238bingmaps:?rtp=adr.One Microsoft Way, Redmond, WA 98052~pos.39.0731_-108.7238 指定した住所から指定した場所までのルート案内と共に地図を表示します。Displays a map with directions from the specified address to the specified location.
bingmaps:?rtp=adr.1%20Microsoft%20Way,%20Redmond,%20WA,%2098052~pos.36.1223_-111.9495_Grand%20Canyon%20northern%20rimbingmaps:?rtp=adr.1%20Microsoft%20Way,%20Redmond,%20WA,%2098052~pos.36.1223_-111.9495_Grand%20Canyon%20northern%20rim 1 Microsoft Way, Redmond, WA、98052 からグランドキャニオンの北端までのルート案内を表示します。Displays directions from 1 Microsoft Way, Redmond, WA, 98052 to the Grand Canyon's northern rim.
bingmaps:?rtp=adr.Davenport, CA~adr.Yosemite Villagebingmaps:?rtp=adr.Davenport, CA~adr.Yosemite Village 指定した場所から指定したランドマークまでの自動車ルート案内と共に地図を表示します。Displays a map with driving directions from the specified location to the specified landmark.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=dbingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=d カリフォルニア州のマウンテンビューからカリフォルニア州のサンフランシスコ国際空港までの自動車ルート案内を表示します。Displays driving directions from Mountain View, CA to San Francisco International Airport, CA.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=wbingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=w カリフォルニア州のマウンテンビューからカリフォルニア州のサンフランシスコ国際空港までの徒歩ルート案内を表示します。Displays walking directions from Mountain View, CA to San Francisco International Airport, CA.
bingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=tbingmaps:?rtp=adr.Mountain%20View,%20CA~adr.San%20Francisco%20International%20Airport,%20CA&mode=t カリフォルニア州のマウンテンビューからカリフォルニア州のサンフランシスコ国際空港までの乗り換え案内を表示します。Displays transit directions from Mountain View, CA to San Francisco International Airport, CA.

ターン バイ ターン方式のルート案内の表示Display turn-by-turn directions

ms-drive-to:ms-walk-to: の各 URI スキームでは、直接ターン バイ ターン方式のルート案内を起動できます。The ms-drive-to: and ms-walk-to: URI schemes let you launch directly into a turn-by-turn view of a route. これらの URI スキームでは、ユーザーの現在の場所からのルート案内のみを提供できます。These URI schemes can only provide directions from the user's current location. ユーザーの現在の場所を含まないポイント間のルート案内を提供する必要がある場合は、前のセクションで説明した bingmaps: URI スキームを使います。If you must provide directions between points that do not include the user's current location, use the bingmaps: URI scheme as described in the previous section. これらの URI スキームについて詳しくは、ms-drive-to:ms-walk-to: のパラメーター リファレンスをご覧ください。For more info about these URI schemes, see the ms-drive-to: and ms-walk-to: parameter reference.

重要 ms-drive-to: または ms-walk-to: の URI スキームが呼び出されると、マップ アプリは、デバイスで GPS 位置情報の修正が行われたことがあるかどうかを確認します。Important When the ms-drive-to: or ms-walk-to: URI schemes are launched, the Maps app will check to see if the device has ever had a GPS location fix. 行われたことがある場合は、ターン バイ ターン方式のルート案内に進みます。If it has, then the Maps app will proceed to turn-by-turn directions. 行われたことがない場合は、「ルート案内と交通情報の表示」で説明したルートの概要を表示します。If it hasn't, the app will display the route overview, as described in Display directions and traffic.

ターン バイ ターン方式のルート案内の例

サンプル URISample URI 結果Results
ms-drive-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lakems-drive-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake 現在の場所からグリーン湖までのターン バイ ターン方式の自動車ルート案内と共に地図を表示します。Displays a map with turn-by-turn driving directions to Green Lake from your current location.
ms-walk-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lakems-walk-to:?destination.latitude=47.680504&destination.longitude=-122.328262&destination.name=Green Lake 現在の場所からグリーン湖までのターン バイ ターン方式の徒歩ルート案内と共に地図を表示します。Displays a map with turn-by-turn walking directions to Green Lake from your current location.

オフライン マップのダウンロードDownload offline maps

ms-settings: URI スキームでは、設定アプリで特定のページを直接起動することができます。The ms-settings: URI scheme lets you launch directly into a particular page in the Settings app. ms-settings: URI スキームでは、マップ アプリが起動されませんが、設定アプリでオフライン マップ ページを直接起動し、マップ アプリが使用するオフライン マップをダウンロードするための確認ダイアログ ボックスを表示することができます。While the ms-settings: URI scheme doesn't launch into the Maps app, it does allow you to launch directly to the Offline Maps page in the Settings app and displays a confirmation dialog to download the offline maps used by the Maps app. URI スキームは、緯度と経度で指定されたポイントを受け取り、そのポイントが含まれる地域のオフライン マップが利用できるかどうかを自動的に判定します。The URI scheme accepts a point specified by a latitude and longitude and automatically determines if there are offline maps available for a region containing that point. 渡された緯度と経度が複数のダウンロード地域内にある場合、ユーザーは、確認ダイアログ ボックスでダウンロードする地域を選択できます。If the latitude and longitude passed happen to fall within multiple download regions, the confirmation dialog will let the user pick which of those regions to download. そのポイントが含まれる地域のオフライン マップが利用できない場合、設定アプリのオフライン マップ ページがエラー ダイアログと共に表示されます。If offline maps are not available for a region containing that point, the offline Maps page in the Settings app is displayed with an error dialog.

サンプル URISample URI 結果Results
ms-settings:maps-downloadmaps?latlong=47.6,-122.3ms-settings:maps-downloadmaps?latlong=47.6,-122.3 設定アプリで、確認ダイアログ ボックスが表示されたオフライン マップ ページを開き、緯度と経度で指定されたポイントが含まれた地域のマップをダウンロードします。Opens the Settings app to the Offline Maps page with a confirmation dialog displayed to download maps for the region containing the specified latitude-longitude point.

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

次に示す各パラメーターの構文は、拡張バッカスナウア記法 (ABNF) を使って表されています。The syntax for each parameter in this table is shown by using Augmented Backus–Naur Form (ABNF).

パラメーターParameter 定義Definition ABNF での定義と例ABNF Definition and Example 詳細Details

cpcp

中心点Center point

cp = "cp=" cpvalcp = "cp=" cpval

cpval = degreeslat "~" degreesloncpval = degreeslat "~" degreeslon

degreeslat = ["-"] 13DIGIT ["." 17DIGIT]degreeslat = ["-"] 13DIGIT ["." 17DIGIT]

degreeslon = ["-"] 12DIGIT ["." 17DIGIT]degreeslon = ["-"] 12DIGIT ["." 17DIGIT]

例:Example:

cp=40.726966~-74.006076cp=40.726966~-74.006076

どちらの値も、10 進角で表し、チルダ (~) で区切る必要があります。Both values must be expressed in decimal degrees and separated by a tilde(~).

有効な経度の値の範囲は -180 ~ +180 です (両端の値を含む)。Valid longitude values are between -180 and +180 inclusive.

有効な緯度の値の範囲は -90 ~ +90 です (両端の値を含む)。Valid latitude values are between -90 and +90 inclusive.

bbbb

境界ボックスBounding box

bb = "bb=" southlatitude "" westlongitude "~" northlatitude "" eastlongitudebb = "bb=" southlatitude "" westlongitude "~" northlatitude "" eastlongitude

southlatitude = degreeslatsouthlatitude = degreeslat

northlatitude = degreeslatnorthlatitude = degreeslat

westlongitude = degreeslonwestlongitude = degreeslon

eastlongitude = degreesloneastlongitude = degreeslon

degreeslat = ["-"] 13DIGIT ["." 17DIGIT]degreeslat = ["-"] 13DIGIT ["." 17DIGIT]

degreeslon = ["-"] 12DIGIT ["." 17DIGIT]degreeslon = ["-"] 12DIGIT ["." 17DIGIT]

例:Example:

bb=39.719_-74.52~41.71_-73.5bb=39.719_-74.52~41.71_-73.5

境界ボックスを指定する四角形の領域。10 進角で表し、左下隅と右上隅を区別するためにチルダ (~) を使います。A rectangular area that specifies the bounding box expressed in decimal degrees, using a tilde (~) to separate the lower left corner from the upper right corner. それぞれの緯度と経度は、アンダー スコア () で区切られます。Latitude and longitude for each are separated with an underscore ().

有効な経度の値の範囲は -180 ~ +180 です (両端の値を含む)。Valid longitude values are between -180 and +180 inclusive.

有効な緯度の値の範囲は -90 ~ +90 です (両端の値を含む)。Valid latitude values are between -90 and +90 inclusive.

境界ボックスが提供されている場合、cp パラメーターと lvl パラメーターは無視されます。The cp and lvl parameters are ignored when a bounding box is provided.

wherewhere

位置情報Location

where = "where=" wherevalwhere = "where=" whereval

whereval = 1 ( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")whereval = 1 ( ALPHA / DIGIT / "-" / "." / "_" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")

以下に例を示します。Example:

where=1600%20Pennsylvania%20Ave,%20Washington,%20DCwhere=1600%20Pennsylvania%20Ave,%20Washington,%20DC

特定の所在地、ランドマーク、または場所を検索するための語句。Search term for a specific location, landmark or place.

qq

クエリ語句Query Term

q = "q="q = "q="

wherevalwhereval

例:Example:

q=mexican%20restaurantsq=mexican%20restaurants

各地のビジネスや業種を検索するための語句。Search term for local business or category of businesses.

lvllvl

ズーム レベルZoom Level

lvl = "lvl=" 12DIGIT ["." 12DIGIT]lvl = "lvl=" 12DIGIT ["." 12DIGIT]

例:Example:

lvl=10.50lvl=10.50

地図ビューのズーム レベルを定義します。Defines the zoom level of the map view. 有効な値は 1 ~ 20 です。1 は、最も縮小された状態で表示します。Valid values are 1-20 where 1 is zoomed all the way out.

stysty

形式Style

sty = "sty=" ("a" / "r"/"3d")sty = "sty=" ("a" / "r"/"3d")

例:Example:

sty=asty=a

地図の形式を定義します。Defines the map style. このパラメーターの有効な値は次のとおりです。Valid values for this parameter include:

  • a: 地図の航空写真を表示します。a: Display an aerial view of the map.
  • r: 地図の道路図を表示します。r: Display a road view of the map.
  • 3d: 地図を 3D で表示します。3d: Display a 3D view of the map. cp パラメーターと組み合わせて使います。必要に応じて、rad パラメーターと共に使うこともできます。Use in conjunction with the cp parameter and optionally with the rad parameter.

Windows 10 では、航空写真表示と 3D ビューのスタイルは同じです。In Windows 10, the aerial view and 3D view styles are the same.

sty パラメーターを省略すると、sty=r と同じ結果が表示されます。 Note Omitting the sty parameter produces the same results as sty=r.

radrad

半径Radius

rad = "rad=" 1*8DIGITrad = "rad=" 1*8DIGIT

例:Example:

rad=1000rad=1000

目的の地図ビューを表す円形領域です。A circular area that specifies the desired map view. 半径の値はメートル単位で指定します。The radius value is measured in meters.

pitpit

ピッチPitch

pit = "pit=" pitchpit = "pit=" pitch

例:Example:

pit=60pit=60

地図を表示する角度を指定します。90 は水平方向を見ること (最大) を表し、0 は真下を見下ろすこと (最小) を表します。Indicates the angle that the map is viewed at, where 90 is looking out at the horizon (maximum) and 0 is looking straight down (minimum).

有効なピッチの値の範囲は 0 ~ 90 です (両端の値を含む)。Valid pitch values are between 0 and 90 inclusive.

hdghdg

方位Heading

hdg = "hdg=" headinghdg = "hdg=" heading

例:Example:

hdg=180hdg=180

地図の向いている方位を角度で指定します。0 または 360 は北、90 は東、180 は南、270 は西を表します。Indicates the direction the map is heading in degrees, where 0 or 360 = North, 90 = East, 180 = South, and 270 = West.

ssss

StreetsideStreetside

ss = "ss=" BITss = "ss=" BIT

例: Example:

ss=1ss=1

ss=1 の場合は、ストリート レベルの画像が表示されることを示します。Indicates that street-level imagery is shown when ss=1. ss パラメーターを省略すると、ss=0 と同じ結果が表示されます。Omitting the ss parameter produces the same result as ss=0. cp パラメーターと組み合わせて使うと、ストリート レベル ビューの場所を指定できます。Use in conjunction with the cp parameter to specify the location of the street-level view.

ストリート レベルの画像は、すべての地域で利用できるわけではありません。 Note Street-level imagery is not available in all regions.

trfctrfc

交通情報Traffic

trfc = "trfc=" BITtrfc = "trfc=" BIT

例:Example:

trfc=1trfc=1

交通情報を地図に含めるかどうかを指定します。Specifies whether traffic information is included on the map. trfc パラメーターを省略すると、trfc=0 と同じ結果が表示されます。Omitting the trfc parameter produces the same results as trfc=0.

交通情報のデータは、すべての地域で利用できるわけではありません。 Note Traffic data is not available in all regions.

rtprtp

ルートRoute

rtp = "rtp=" (waypoint "~" [waypoint]) / ("~" waypoint)rtp = "rtp=" (waypoint "~" [waypoint]) / ("~" waypoint)

waypoint = ("pos."waypoint = ("pos." point ) / ("adr."point ) / ("adr." whereval)whereval)

point = "point."point = "point." pointval ["" title]pointval ["" title]

pointval = degreeslat "" degreeslonpointval = degreeslat "" degreeslon

degreeslat = ["-"] 13DIGIT ["." 17DIGIT]degreeslat = ["-"] 13DIGIT ["." 17DIGIT]

degreeslon = ["-"] 12DIGIT ["." 17DIGIT]degreeslon = ["-"] 12DIGIT ["." 17DIGIT]

title = wherevaltitle = whereval

whereval = 1( ALPHA / DIGIT / "-" / "." / "" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")whereval = 1( ALPHA / DIGIT / "-" / "." / "" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")

例:Examples:

rtp=adr.Mountain%20View,%20CA~adr.SFOrtp=adr.Mountain%20View,%20CA~adr.SFO

rtp=adr.One%20Microsoft%20Way,%20Redmond,%20WA~pos.45.23423_-122.1232 My%20Picnic%20Spotrtp=adr.One%20Microsoft%20Way,%20Redmond,%20WA~pos.45.23423-122.1232_My%20Picnic%20Spot

地図上に表示するルートの開始地点と終了地点を、チルダ (~) で区切って定義します。Defines the start and end of a route to draw on the map, separated by a tilde (~). 各中間点は、緯度、経度、オプションのタイトルを使った位置、または住所の識別情報を使って定義します。Each of the waypoints is defined by either a position using ltitude, longitude, and optional title or an address identifier.

完全なルートとは、中間点が 2 つだけ含まれるルートです。A complete route contains exactly two waypoints. たとえば、2 つの中間点を持つルートは、rtp="A"~"B" のように定義されます。For example, a route with two waypoints is defined by rtp="A"~"B".

不完全なルートを指定することもできます。It's also acceptable to specify an incomplete route. たとえば、ルートの開始地点だけを定義する場合は、rtp="A"~ のように指定できます。For example, you can define only the start of a route with rtp="A"~. この場合、ルート案内の入力が表示されると、[出発地] フィールドには指定された中間点が表示され、[目的地] フィールドにフォーカスが設定されます。In this case, the directions input is displayed with the provided waypoint in the From field and the To field has focus.

rtp=~"B" のようにルートの終了地点のみを指定した場合は、ルート案内のパネルが表示されると、[目的地] フィールドには指定された中間点が表示されます。If only the end of a route is specified, as with rtp=~"B", the directions panel is displayed with the provided waypoint in the To field. 現在の正確な位置情報にアクセスできる場合、[出発地] フィールドに現在の場所があらかじめ入力され、フォーカスが設定されます。If an accurate current location is available, the current location is pre-populated in the From field with focus.

不完全なルートが指定されている場合は、ルートの線は表示されません。No route line is drawn when an incomplete route is given.

mode パラメーターと組み合わせて使うと、交通手段のモード (自動車、公共交通機関、徒歩) を指定できます。Use in conjunction with the mode parameter to specify the mode of transportation (driving, transit, or walking). mode が指定されていない場合、ルート案内は、ユーザーの交通手段の設定のモードを使って提供されます。If mode isn't specified, directions will be provided using the user's mode of transportation preference.

pos パラメーターの値によって場所が指定されている場合、その場所に対してタイトルを使うことができます。 Note A title can be used for a location if the location is specified by the pos parameter value. 緯度と経度が表示される代わりに、タイトルが表示されます。Rather than showing the latitude and longitude, the title will be displayed.

modemode

交通手段モードTransportation mode

mode = "mode=" ("d" / "t" / "w")mode = "mode=" ("d" / "t" / "w")

例:Example:

mode=dmode=d

交通手段モードを定義します。Defines the transportation mode. このパラメーターの有効な値は次のとおりです。Valid values for this parameter include:

  • d: 自動車ルート案内のルートの概要を表示します。d: Displays route overview for driving directions
  • t: 乗り換え案内のルートの概要を表示します。t: Displays route overview for transit directions
  • w: 徒歩ルート案内のルートの概要を表示します。w: Displays route overview for walking directions

交通手段案内の rtp パラメーターと組み合わせて使います。Use in conjunction with the rtp parameter for transportation directions. mode が指定されていない場合、ルート案内は、ユーザーの交通手段の設定のモードを使って提供されます。If mode isn't specified, directions will be provided using the user's mode of transportation preference. 現在の位置情報からこのモード用のルート案内に入力するルート パラメーターなしに、mode を提供することができます。A mode can be provided with no route parameter to enter directions input for that mode from the current location.

collectioncollection

コレクションCollection

collection = "collection="(name"~"/)point["~"point]collection = "collection="(name"~"/)point["~"point]

name = "name."name = "name." wherevalwhereval

whereval = 1( ALPHA / DIGIT / "-" / "." / "" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")whereval = 1( ALPHA / DIGIT / "-" / "." / "" / pct-encoded / "!" / "$" / "'" / "(" / ")" / "" / "+" / "," / ";" / ":" / "@" / "/" / "?")

point = "point."point = "point." pointval ["" title]pointval ["" title]

pointval = degreeslat "" degreeslonpointval = degreeslat "" degreeslon

degreeslat = ["-"] 13DIGIT ["." 17DIGIT]degreeslat = ["-"] 13DIGIT ["." 17DIGIT]

degreeslon = ["-"] 12DIGIT ["." 17DIGIT]degreeslon = ["-"] 12DIGIT ["." 17DIGIT]

title = wherevaltitle = whereval

例:Example:

collection=name.My%20Trip%20Stops~point.36.116584_-115.176753_Las%20Vegas~point.37.8268_-122.4798_Golden%20Gate%20Bridgecollection=name.My%20Trip%20Stops~point.36.116584_-115.176753_Las%20Vegas~point.37.8268_-122.4798_Golden%20Gate%20Bridge

地図と一覧に追加されるポイントのコレクションです。Collection of points to be added to the map and list. name パラメーターを使用して、ポイントのコレクションに名前を付けることができます。The collection of points can be named using the name parameter. ポイントは、緯度、経度、およびオプションのタイトルを使用して指定されます。A point is specified using a latitude, longitude, and optional title.

名前と複数のポイントをチルダ (~) で区切ります。Separate name and multiple points with tildes (~).

指定した項目にチルダが含まれている場合は、そのチルダを %7E としてエンコードしてください。If the item you specify contains a tilde, make sure the tilde is encoded as %7E. 中心点のパラメーターやズーム レベルのパラメーターと共に使わない場合、コレクションによって、最適な地図ビューが表示されます。If not accompanied by Center point and Zoom Level parameters, the collection will provide the best map view.

重要 指定した項目にアンダースコアが含まれている場合は、そのアンダースコアを %255F としてダブル エンコードしてください。Important If the item you specify contains an underscore, make sure the underscore is double encoded as %255F.

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

ターン バイ ターン方式の自動車ルート案内の要求を起動する URI は、エンコードする必要がありません。その形式は、次のようになります。The URI to launch a request for turn-by-turn driving directions does not need to be encoded and has the following format.

この URI スキームでは出発地を指定しません。Note You don’t specify the starting point in this URI scheme. 常に、現在の場所が出発地であると見なされます。The starting point is always assumed to be the current location. 現在の場所以外の出発地を指定する必要がある場合は、「ルート案内と交通情報の表示」をご覧ください。If you need to specify a starting point other than the current location, see Display directions and traffic.

パラメーターParameter 定義Definition Example 詳細Details
destination.latitudedestination.latitude 目的地の緯度Destination latitude 例: destination.latitude=47.6451413797194Example: destination.latitude=47.6451413797194 目的地の緯度です。The latitude of the destination. 有効な緯度の値の範囲は -90 ~ +90 です (両端の値を含む)。Valid latitude values are between -90 and +90 inclusive.
destination.longitudedestination.longitude 目的地の経度Destination longitude 例: destination.longitude=-122.141964733601Example: destination.longitude=-122.141964733601 目的地の経度です。The longitude of the destination. 有効な経度の値の範囲は -180 ~ +180 です (両端の値を含む)。Valid longitude values are between -180 and +180 inclusive.
destination.namedestination.name 目的地の名前Name of the destination 例: destination.name=Redmond, WAExample: destination.name=Redmond, WA 目的地の名前です。The name of the destination. destination.name 値をエンコードする必要はありません。You do not have to encode the destination.name value.

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

ターン バイ ターン方式の徒歩ルート案内の要求を起動する URI は、エンコードする必要がありません。その形式は、次のようになります。The URI to launch a request for turn-by-turn walking directions does not need to be encoded and has the following format.

この URI スキームでは出発地を指定しません。Note You don’t specify the starting point in this URI scheme. 常に、現在の場所が出発地であると見なされます。The starting point is always assumed to be the current location. 現在の場所以外の出発地を指定する必要がある場合は、「ルート案内と交通情報の表示」をご覧ください。If you need to specify a starting point other than the current location, see Display directions and traffic.

パラメーターParameter 定義Definition Example 詳細Details
destination.latitudedestination.latitude 目的地の緯度Destination latitude 例: destination.latitude=47.6451413797194Example: destination.latitude=47.6451413797194 目的地の緯度です。The latitude of the destination. 有効な緯度の値の範囲は -90 ~ +90 です (両端の値を含む)。Valid latitude values are between -90 and +90 inclusive.
destination.longitudedestination.longitude 目的地の経度Destination longitude 例: destination.longitude=-122.141964733601Example: destination.longitude=-122.141964733601 目的地の経度です。The longitude of the destination. 有効な経度の値の範囲は -180 ~ +180 です (両端の値を含む)。Valid longitude values are between -180 and +180 inclusive.
destination.namedestination.name 目的地の名前Name of the destination 例: destination.name=Redmond, WAExample: destination.name=Redmond, WA 目的地の名前です。The name of the destination. destination.name 値をエンコードする必要はありません。You do not have to encode the destination.name value.

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

ms-settings: URI スキームのマップ アプリ固有のパラメーターの構文は、次のように定義されます。The syntax for maps app specific parameters for the ms-settings: URI scheme is defined below. maps-downloadmaps は、ms-settings: URI と共に ms-settings:maps-downloadmaps? の形式で指定され、オフライン マップの設定ページを示します。maps-downloadmaps is specified along with the ms-settings: URI in the form of ms-settings:maps-downloadmaps? to indicate the offline maps settings page.

パラメーターParameter 定義Definition Example 詳細Details
latlonglatlong オフライン マップの地域を定義するポイント。Point defining offline map region. 例: latlong=47.6,-122.3Example: latlong=47.6,-122.3 GeoPoint は、コンマ区切りの緯度と経度で指定されます。The geopoint is specified by a comma separated latitude and longitude. 有効な緯度の値の範囲は -90 ~ +90 です (両端の値を含む)。Valid latitude values are between -90 and +90 inclusive. 有効な経度の値の範囲は -180 ~ +180 です (両端の値を含む)。Valid longitude values are between -180 and +180 inclusive.