Azure Maps と Google マップでは、どちらの場合も REST Web サービスを介して空間 API にアクセスすることができます。 これらのプラットフォームの API インターフェイスは同様の機能を実行します。 ただし、使用される名前付け規則と応答オブジェクトが異なります。
このチュートリアルでは、次の方法について説明します。
- 順方向ジオコーディングと逆方向ジオコーディング
- 目的地を検索する
- ルートと道順を計算する
- マップ イメージを取得する
- 距離行列を計算する
- タイム ゾーンの詳細を取得する
また、次のことも学習します。
- Google Maps から Web サービスを移行した場合に使用する Azure Maps REST サービス
- Azure Maps サービスを最大限に活用するためのヒント
- 関連するその他の Azure Maps サービスの情報
次の表に、記載されている Google マップ サービス API と同様の機能を持つ Azure Maps サービス API を示します。
| Google マップ サービス API | Azure Maps サービス API |
|---|---|
| Directions | Route |
| Distance Matrix | Post Route Matrix |
| ジオコーディング | Search |
| 場所の検索 | Search |
| Place Autocomplete | Search |
| Snap to Road | 「ルートと道順を計算する」セクションを参照してください。 |
| 速度制限 | 「座標の逆ジオコーディング」セクションを参照してください。 |
| 静的マップ | Render |
| タイム ゾーン | タイム ゾーン |
次のサービス API は、Azure Maps では現在使用できません。
- Geolocation - Azure Maps には、Geolocation というサービスがあります。これは、位置情報に IP アドレスを提供しますが、現在、携帯電話基地局および WiFi の三角測量をサポートしていません。
- 場所の詳細と写真 - 電話番号と Web サイトの URL は、Azure Maps Search API で入手できます。
- Map URLs
- 最短経路 - 基本的な道路へのスナップ ロジックのサンプルで示されているように、Web SDK を使用して実現できますが、現時点ではサービスとして利用することはできません。
- 静的ストリートビュー
前提条件
Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。
注
Azure Maps での認証の詳細については、「Azure Maps での認証の管理」を参照してください。
住所のジオコーディング
ジオコーディングは、住所を座標に変換するプロセスです。 たとえば、"1 Microsoft way, Redmond, WA" は、経度: -122.1298、緯度: 47.64005 に変換されます。 その後、マーカーをマップの中心に配置するなど、さまざまな目的に座標を使用できます。
Azure Maps により、住所をジオコーディングするための複数の方法が提供されます。
- Get Search Address: 自由形式の住所のジオコーディングを使用して、単一の住所文字列 (
"1 Microsoft way, Redmond, WA"など) を指定し、要求を直ちに処理します。 このサービスは、個々の住所を迅速にジオコーディングする必要がある場合に推奨されます。 - Get Search Address Structured: 単一の住所の一部 (番地、市区町村、国または地域、郵便番号など) を指定し、要求を直ちに処理します。 この API は、個々の住所を迅速にジオコーディングする必要があり、データが既に個別の住所の一部として解析されている場合に推奨されます。
- Post Search Address Batch: 最大 10,000 個の住所を含む要求を作成し、それらを一定時間内で処理します。 すべての住所はサーバーで並行してジオコーディングされ、完了すると、完全な結果セットをダウンロードできます。 これは、大きなデータ セットをジオコーディングする場合に推奨されます。
- Get Search Fuzzy: あいまい検索 API は住所ジオコーディングと目的地検索を組み合わせます。 住所、場所、ランドマーク、目的地、または目的地のカテゴリを自由形式の文字列として指定することができます。要求はただちに処理されます。 この API は、ユーザーが同じテキスト ボックスから住所や目的地を検索できるアプリケーションに適しています。
- Post Search Fuzzy Batch: あいまいバッチ検索を使用して、最大 10,000 個の住所、場所、ランドマーク、または目的地を含む要求を作成し、それらを一定時間内に処理します。 すべてのデータはサーバーで並行して処理され、完了すると、完全な結果セットをダウンロードすることができます。
次の表では、Google マップ API パラメーターと、それに相当する Azure Maps 内の API パラメーターを相互参照で示しています。
| Google マップ API パラメーター | 相当する Azure Maps API パラメーター |
|---|---|
address |
query |
bounds |
topLeft および btmRight |
components |
streetNumberstreetNamecrossStreetpostalCodemunicipality - 市区町村municipalitySubdivision - 地域、地区、副都市／スーパーシティcountrySubdivision - 都道府県countrySecondarySubdivision - 郡countryTertiarySubdivision - 区countryCode -2 文字の国または地域コード |
key |
subscription-key - 詳細については、「Azure Maps による認証」を参照してください。 |
language |
language - 詳細については、「Azure Maps でのローカライズのサポート」を参照してください。 |
region |
countrySet |
Search Service の使用方法の詳細については、「Azure Maps Search Service を使用して場所を検索する」を参照してください。 検索のベスト プラクティスをぜひご覧ください。
ヒント
自由形式のアドレスのジオコーディング API とあいまい検索 API は、&typeahead=true を要求 URL に追加することにより、オートコンプリート モードで使用できます。 これにより、入力テキストが完全ではない可能性がサーバーに通知され、検索は予測モードになります。
座標の逆ジオコーディング
逆ジオコーディングは、地理座標をおおよその住所に変換するプロセスです。 "経度: -122.1298、緯度: 47.64005" という座標は、"1 Microsoft way, Redmond, WA" に変換されます。
Azure Maps では、複数の逆ジオコーディング メソッドが提供されています。
- Get Search Address Reverse: 単一の地理座標を指定し、この座標に対応するおおよその住所を取得します。 要求は、ほぼリアルタイムで処理されます。
- Get Search Address Reverse Cross Street: 単一の地理座標を指定して周辺の交差点情報を取得し、要求を直ちに処理します。 たとえば、1st Ave と Main St. の交差点が返されます。
- Post Search Address Reverse Batch: 最大 10,000 個の座標を含む要求を作成し、それらを一定時間内に処理します。 すべてのデータはサーバーで並列処理されます。 要求が完了したら、すべての結果をまとめてダウンロードできます。
次の表では、Google マップ API パラメーターと、それに相当する Azure Maps の API パラメーターを相互参照で示しています。
| Google マップ API パラメーター | 相当する Azure Maps API パラメーター |
|---|---|
key |
subscription-key - 詳細については、「Azure Maps による認証」を参照してください。 |
language |
language - 詳細については、「Azure Maps でのローカライズのサポート」を参照してください。 |
latlng |
query |
location_type |
N/A |
result_type |
entityType |
詳しくは、「検索のベスト プラクティス」をご覧ください。
Azure Maps の逆ジオコーディング API には、Google マップでは利用できないその他の機能がいくつかあります。 ご自分のアプリケーションを移行する際に、それらの機能をアプリに統合することもできます。
- 速度制限のデータを取得する
- 道路使用情報を取得する (地方の道路、幹線道路、自動車専用道路、ランプなど)
- 座標が通りのどちら側に位置するかを取得する
目的地を検索する
Google マップで目的地データを検索するには、場所検索 API を使用します。 この API により、目的地を検索するための 3 つの異なる方法が提供されます。
- テキストから場所を検索する: 目的地を名前、住所、または電話番号に基づいて検索します。
- 近隣検索: ある場所から特定の距離内にある目的地を検索します。
- テキスト検索: 目的地や場所の情報を含む自由形式のテキストを使用して場所を検索します。 たとえば、"ニューヨークのピザ" や "メイン ストリート付近のレストラン" などです。
Azure Maps には、目的地を検索するための複数の検索 API が用意されています。
- Get Search POI: 目的地を名前で検索します。 たとえば、"スターバックス" などです。
- Get Search POI Category: 目的地をカテゴリで検索します。 たとえば、"レストラン" などです。
- Get Search Nearby: ある場所から一定の距離内にある目的地を検索します。
- Get Search Fuzzy: あいまい検索 API は住所ジオコーディングと目的地検索を組み合わせます。 住所、場所、ランドマーク、目的地、または目的地のカテゴリを自由形式の文字列として指定することができます。要求はただちに処理されます。 この API は、ユーザーが同じテキスト ボックスから住所や目的地を検索できるアプリケーションに適しています。
- Post Search Inside Geometry: 指定されたジオメトリ内にある注目すべき点を検索します。 たとえば、多角形の範囲内の目的地を検索します。
- Post Search Along Route: 指定されたルート パスに沿った目的地を検索します。
- Post Search Fuzzy Batch: あいまいバッチ検索を使用して、最大 10,000 個の住所、場所、ランドマーク、または目的地を含む要求を作成し、それらを一定時間内に処理します。 すべてのデータはサーバーで並行して処理され、完了すると、完全な結果セットをダウンロードすることができます。
現在、Azure Maps には、Google マップのテキスト検索 API に相当する API はありません。
ヒント
POI 検索、POI カテゴリ検索、あいまい検索の各 API は、&typeahead=true を要求 URL に追加することにより、オートコンプリート モードで使用できます。 これにより、入力テキストが完全ではない可能性がサーバーに通知されます。API によって検索が予測モードで実行されます。
詳しくは、「検索のベスト プラクティス」をご覧ください。
テキストから場所を検索する
Azure Maps の Get Search POI および Get Search Fuzzy を使用して、目的地を名前もしくは住所で検索します。
次の表では、Google マップ API パラメーターと、それに相当する Azure Maps の API パラメーターを相互参照で示しています。
| Google マップ API パラメーター | 相当する Azure Maps API パラメーター |
|---|---|
fields |
N/A |
input |
query |
inputtype |
N/A |
key |
subscription-key - 詳細については、「Azure Maps による認証」を参照してください。 |
language |
language - 詳細については、「Azure Maps でのローカライズのサポート」を参照してください。 |
locationbias |
lat、lon、radiustopLeft および btmRightcountrySet |
近隣検索
Get Search Nearby API を使用して、Azure Maps で付近の目的地を取得します。
次の表は、Google マップ API パラメーターと、それに相当する Azure Maps の API パラメーターを示しています。
| Google マップ API パラメーター | 相当する Azure Maps API パラメーター |
|---|---|
key |
subscription-key - 詳細については、「Azure Maps による認証」を参照してください。 |
keyword |
categorySet および brandSet |
language |
language - 詳細については、「Azure Maps でのローカライズのサポート」を参照してください。 |
location |
lat および lon |
maxprice |
N/A |
minprice |
N/A |
name |
categorySet および brandSet |
opennow |
N/A |
pagetoken |
ofs および limit |
radius |
radius |
rankby |
N/A |
type |
categorySet – 詳細については、サポートされている検索カテゴリに関する記事を参照してください。 |
ルートと道順を計算する
Azure Maps を使用してルートと道順を計算します。 Azure Maps には、Google マップの経路探索サービスと同じ機能が数多く用意されています。たとえば、次のようなものがあります。
- 到着および出発の時刻。
- リアルタイムおよび予測ベースの交通路。
- さまざまな移動手段 車、徒歩、自転車など。
注
Azure Maps では、すべてのウェイポイントを座標にする必要があります。 住所は、最初にジオコーディングする必要があります。
Azure Maps のルート指定サービスでは、ルート指定の計算用として次の API が提供されます。
- Get Route Directions: ルートを計算し、要求を直ちに処理します。 この API では、
GET要求とPOST要求の両方がサポートされます。 大量のウェイポイントを指定する場合、または多くのルート オプションを使用する場合は、URL 要求が長くなりすぎて問題が発生することがないようにPOST要求が推奨されます。 Azure Maps のPOSTRoute Direction には、数千のサポート ポイントを受け取り、それらを使用してポイント間の論理ルート パスを再作成するオプションがあります (Snap to Road)。 - Post Route Directions Batch: 最大 1,000 個のルート要求を含む要求を作成し、それらを一定時間内に処理します。 すべてのデータはサーバーで並行して処理され、完了すると、完全な結果セットをダウンロードすることができます。
次の表では、Google マップ API パラメーターと、それに相当する Azure Maps の API パラメーターを相互参照で示しています。
| Google マップ API パラメーター | 相当する Azure Maps API パラメーター |
|---|---|
alternatives |
maxAlternatives |
arrival_time |
arriveAt |
avoid |
avoid |
departure_time |
departAt |
destination |
query - "lat0,lon0:lat1,lon1…." 形式の座標 |
key |
subscription-key - 詳細については、「Azure Maps による認証」を参照してください。 |
language |
language - 詳細については、「Azure Maps でのローカライズのサポート」を参照してください。 |
mode |
travelMode |
optimize |
computeBestOrder |
origin |
query |
region |
N/A - これはジオコーディング関連の機能です。 Azure Maps ジオコーディング API を使用する場合は、countrySet パラメーターを使用します。 |
traffic_model |
N/A - 交通情報データを traffic パラメーターで使用する必要がある場合のみ指定できます。 |
units |
N/A - Azure Maps ではメートル法のみが使用されます。 |
waypoints |
query |
ヒント
既定では、Azure Maps Route API は概要のみを返します。 距離と時間、ルートの座標が返されます。 道案内の指示を取得するには、instructionsType パラメーターを使用します。 また、概要とルートをフィルター処理するには、routeRepresentation パラメーターを使用します。
Azure Maps のルート指定 API には、これらの他に、Google マップでは利用できない機能があります。 アプリを移行する際は、以下の機能の使用を検討してください。
- ルートの種類のサポート: 最短、最速、スリリング、最も燃費が良い。
- 他の移動手段のサポート: バス、バイク、タクシー、トラック、バン。
- 150 個のウェイポイントのサポート。
- 1 つの要求で複数の移動時間を計算: 過去の交通量、現在の交通量、交通量なし。
- 他の道路の種類を回避: 自動車の相乗り用車線、未舗装道路、既に使用したことがある道路。
- 回避するカスタム領域を指定。
- ルート内に含まれる標高の上昇を制限します。
- エンジンの仕様に基づくルート。 エンジンの仕様と、燃料または充電の残量に基づいてガソリン車または電気自動車のルートを計算します。
- 商用車両のルート パラメーターをサポート 車両の寸法、重量、アクセル回数、積み荷の種類など。
- 車両の最大速度を指定。
さらに、Azure Maps のルート サービスは、Get Route Range もサポートしています。 ルーティング可能な範囲の計算は、等時線とも呼ばれます。 その際、出発地点から任意の方向に移動できる領域をカバーする多角形が生成されます。 そのすべては、指定された時間内または燃料や充電の残量内で行われます。
詳しくは、ルーティングのベスト プラクティスに関する記事を参照してください。
マップ イメージを取得する
Azure Maps には、静的マップ イメージにデータを重ねてレンダリングするための API が用意されています。 Azure Maps の Get Map Static Image API は、Google Maps の静的マップ API に相当します。
注
Azure Maps では、中央、すべてのマーカー、経路の位置を "経度,緯度" 形式の座標にする必要があります。 一方、Google マップでは、"緯度,経度" 形式が使用されます。 住所は、最初にジオコーディングする必要があります。
次の表では、Google マップ API パラメーターと、それに相当する Azure Maps の API パラメーターを相互参照で示しています。
| Google マップ API パラメーター | 相当する Azure Maps API パラメーター |
|---|---|
center |
center |
format |
format - URL パスの一部として指定されます。 現時点では、PNG のみがサポートされています。 |
key |
subscription-key - 詳細については、「Azure Maps による認証」を参照してください。 |
language |
language - 詳細については、「Azure Maps でのローカライズのサポート」を参照してください。 |
maptype |
layer および style - 詳細については、「サポートされているマップ スタイル」を参照してください。 |
markers |
pins |
path |
path |
region |
N/A – ジオコーディング関連の機能です。 Azure Maps のジオコーディング API を使用する場合は、countrySet パラメーターを使用します。 |
scale |
N/A |
size |
width および height – 最大サイズは 8192 x 8192 です。 |
style |
N/A |
visible |
N/A |
zoom |
zoom |
注
Azure Maps のタイル システムでは、Google マップで使用されるマップ タイルの 2 倍のサイズが使用されます。 このため、Azure Maps のズーム レベル値では、Google マップと比べて 1 つ上のズーム レベルが表示されます。 この違いを相殺するため、移行する要求では、ズーム レベルを 1 つ下げてください。
詳細については、「ラスター マップ上にカスタム データをレンダリングする」を参照してください。
Azure Maps Render サービスでは、静的マップ イメージを生成できるだけでなく、ラスター (PNG) 形式とベクター形式でマップ タイルに直接アクセスできます。
- Get Map Static Image: ベース マップ (道路、境界、背景) のラスター (PNG) およびベクター タイルを取得します。
- Get Map Tile: 航空写真と衛星画像のタイルを取得します。
ヒント
多くの Google Maps アプリケーションでは、数年前に対話型のマップ エクスペリエンスから静的マップ画像に切り替えられました。 これは、コスト削減の手段として行われたものです。 Azure Maps では、多くの場合、Web SDK の対話型マップ コントロールを使用する方がはるかに費用対効果が高くなります。 対話型マップ コントロールは、タイルの読み込み回数に基づいて課金されます。 Azure Maps では、サイズの大きいマップ タイルが使用されます。 多くの場合、数個のタイルだけで静的マップと同じマップ ビューを再作成することができます。 マップ タイルはブラウザーによって自動的にキャッシュされます。 このため、対話型のマップ コントロールでは、静的マップ ビューを再作成する際、トランザクションの一部を生成するだけで済むことがほとんどです。 パンおよびズームでは読み込まれるタイルは増えますが、マップ コントロール内にこの動作を無効にするオプションがあります。 対話型マップ コントロールには、静的マップ サービスで提供される以上の視覚化オプションも用意されています。
マーカー URL パラメーターの形式の比較
移行前:Google Maps
マーカーは、URL の markers パラメーターを使用して追加します。 markers パラメーターには、次に示すように、スタイルと、そのスタイルを使用してマップにレンダリングされる場所の一覧が含まれます。
&markers=markerStyles|markerLocation1|markerLocation2|...
他のスタイルを追加するには、URL に markers パラメーターを使用して、別のスタイルや場所のセットを指定します。
マーカーの場所は、"緯度,経度" の形式で指定します。
マーカーのスタイルを追加するには、optionName:value 形式を使用します。複数のスタイルを指定する場合は、"optionName1:value1|optionName2:value2" のようにパイプ (|) 文字で区切ります。 オプションの名前と値はコロン (:) で区切ることに注意してください。 Google マップでマーカーのスタイルを設定するには、次の名前のスタイル オプションを使用します。
color- 既定のマーカー アイコンの色。 24 ビットの 16 進カラー値 (0xrrggbb)、または値black、brown、green、purple、yellow、blue、gray、orange、red、whiteのいずれかを指定できます。label- アイコンの上に表示する 1 文字の大文字の英数字。size- マーカーのサイズ。tiny、mid、またはsmallを指定できます。
Google マップのカスタム アイコンには、次のスタイル オプション名を使用します。
anchor- アイコン イメージを座標に合わせて配置する方法を指定します。 ピクセル (x,y) 値、または値top、bottom、left、right、center、topleft、topright、bottomleft、bottomrightのいずれかを指定できます。icon- アイコン イメージを指す URL。
たとえば、マップの経度: -110、緯度: 45 の位置に、赤色で中サイズのマーカーを追加してみましょう。
&markers=color:red|size:mid|45,-110
Azure Maps の後
静的マップ画像に対するマーカーは、URL で pins パラメーターを指定することによって追加します。 Google マップと同様、このパラメーターでスタイルと場所の一覧を指定します。 異なるスタイルのマーカーをサポートするために、pins パラメーターを複数回指定することができます。
&pins=iconType|pinStyles||pinLocation1|pinLocation2|...
他のスタイルを使用するには、URL に pins パラメーターをさらに追加して、別のスタイルや場所のセットを指定します。
Azure Maps では、ピンの位置を "経度,緯度" 形式で指定する必要があります。 Google マップでは、"緯度,経度" 形式が使用されます。 Azure Maps 形式では、経度と緯度をコンマではなくスペースで区切ることにも注意してください。
作成するピンの種類は、iconType で指定します。 次のいずれかの値になります。
default- 既定のピン アイコン。none- アイコンは表示されず、ラベルのみがレンダリングされます。custom- カスタム アイコンを使用することを指定します。 アイコン イメージを指す URL は、ピンの位置情報の後、pinsパラメーターの末尾に追加できます。
ピンのスタイルは、optionNameValue 形式で追加します。 複数のスタイルは、パイプ (|) 文字で区切ります。 (例: iconType|optionName1Value1|optionName2Value2)。 オプションの名前と値との間に区切りはありません。 マーカーにスタイルを設定するには、次のスタイル オプション名を使用します。
al- マーカーの不透明度 (アルファ) を指定します。 0 から 1 までの数値を選択します。an- ピンのアンカーを指定します。 X と y のピクセル値を "x y" 形式で指定します。co- ピンの色。 24 ビットの 16 進カラー値 (000000からFFFFFF) を指定します。la- ラベルのアンカーを指定します。 X と y のピクセル値を "x y" 形式で指定します。lc- ラベルの色。 24 ビットの 16 進カラー値 (000000からFFFFFF) を指定します。ls- ラベルのサイズ (ピクセル単位)。 0 より大きい数値を選択します。ro- アイコンを回転させる角度の値。 -360 から 360 までの数値を選択します。sc- ピン アイコンのスケール値。 0 より大きい数値を選択します。
それぞれのピン位置に使用するラベルの値を指定します。 このアプローチの方が、場所の一覧内にあるすべてのマーカーに単一のラベル値を適用するよりも効率的です。 ラベル値には、複数の文字で構成される文字列を指定することができます。 また、誤ってスタイルや場所の値として解釈されないようにするため、その文字列を一重引用符で囲むこともできます。
赤色 (FF0000) の既定のアイコンを追加し、その下 (15 50) に "Space Needle" というラベルを配置しましょう。 アイコンの位置は、経度: -122.349300、緯度: 47.620180 です。
&pins=default|coFF0000|la15 50||'Space Needle' -122.349300 47.620180
ラベル値が "1"、"2"、"3" の 3 つのピンを追加します。
&pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12
経路 URL パラメーターの形式の比較
移行前:Google Maps
静的マップ画像に対する線と多角形は、URL に path パラメーターを使用して追加します。 path パラメーターは、次に示すように、スタイルと、マップにレンダリングされる場所のリストを受け取ります。
&path=pathStyles|pathLocation1|pathLocation2|...
URL に path パラメーターをさらに追加して、別のスタイルや場所のセットを指定することにより、他のスタイルを使用します。
経路の位置は、latitude1,longitude1|latitude2,longitude2|… 形式で指定します。 経路は、エンコードすることも、地点の住所を含めることもできます。
経路のスタイルは、optionName:value 形式で追加します。複数のスタイルを指定する場合は、パイプ (|) 文字で区切ります。 さらに、オプションの名前と値はコロン (:) で区切ります。 (例: optionName1:value1|optionName2:value2)。 Google マップで経路のスタイルを設定するには、次のスタイル オプション名を使用します。
color- 経路またはポリゴンの枠線の色。 24 ビットの 16 進カラー値 (0xrrggbb)、32 ビットの 16 進カラー値 (0xrrggbbbaa)、または値 black、brown、green、purple、yellow、blue、gray、orange、red、white のいずれかを指定できます。fillColor- 経路領域 (ポリゴン) を塗りつぶす色。 24 ビットの 16 進カラー値 (0xrrggbb)、32 ビットの 16 進カラー値 (0xrrggbbbaa)、または値 black、brown、green、purple、yellow、blue、gray、orange、red、white のいずれかを指定できます。geodesic- 経路を地球の曲線に沿った線にする必要があるかどうかを示します。weight- 経路の線の太さ (ピクセル単位)。
マップ上の座標間に、赤色の線の不透明度と太さ (ピクセル) を URL パラメーターで追加します。 次の例では、線の不透明度は 50% で、太さは 4 ピクセルです。 座標は、経度: -110、緯度: 45と経度: -100、緯度: 50です。
&path=color:0xFF000088|weight:4|45,-110|50,-100
Azure Maps の後
静的マップ画像に対する線と多角形は、URL に path パラメーターを指定して追加します。 Google マップと同様、このパラメーターでスタイルと場所の一覧を指定します。 異なるスタイルの複数の円、線、多角形をレンダリングするには、path パラメーターを複数回指定します。
&path=pathStyles||pathLocation1|pathLocation2|...
経路の位置については、Azure Maps の場合、座標を "経度,緯度" 形式にする必要があります。 Google マップでは、"緯度,経度" 形式が使用されます。 Azure Maps 形式では、経度と緯度をコンマではなくスペースで区切ることにも注意してください。 Azure Maps では、エンコードされた経路または地点の住所はサポートされません。
経路のスタイルは、optionNameValue 形式で追加します。 複数のスタイルは、パイプ (|) 文字で区切ります (例: optionName1Value1|optionName2Value2)。 オプションの名前と値との間に区切りはありません。 Azure Maps で経路のスタイルを設定するには、次のスタイル オプション名を使用します。
fa- ポリゴンをレンダリングする際に使用する塗りつぶしの色の不透明度 (アルファ)。 0 から 1 までの数値を選択します。fc- ポリゴン領域をレンダリングする際に使用される塗りつぶし色。la- 線およびポリゴンの枠線をレンダリングする際に使用される線の色の不透明度 (アルファ)。 0 から 1 までの数値を選択します。lc- 線およびポリゴンの枠線をレンダリングするために使用される線の色。lw- 線の幅 (ピクセル単位)。ra- 円の半径をメートル単位で指定します。
座標間に、赤色の線の不透明度と太さ (ピクセル) を URL パラメーターで追加します。 次の例では、線の不透明度は 50% で、太さは 4 ピクセルです。 座標には次の値があります: 経度: -110、緯度: 45、および経度: -100、緯度: 50。
&path=lcFF0000|la.5|lw4||-110 45|-100 50
距離行列を計算する
Azure Maps には、距離行列 API が用意されています。 場所のセット間の移動時間と移動距離を距離行列を使用して計算するには、この API を使用します。 これは、Google マップの距離行列 API に相当します。
- Post Route Matrix: 一連の出発地と目的地の移動時間と移動距離を非同期で計算します。 要求あたり最大 700 個のセルがサポートされます。 これは出発地の数 × 目的地の数です。 この制限を念頭に置いて考えられるマトリックス ディメンションの例としては、700x1、50x10、10x10、28x25、10x70 などがあります。
注
距離行列 API に対する要求は、要求の本文で出発地と目的地の情報を指定した POST 要求を使用してのみ作成できます。 さらに、Azure Maps では、すべての出発地および目的地を座標にする必要があります。 住所は、最初にジオコーディングする必要があります。
次の表では、Google マップ API パラメーターと、それに相当する Azure Maps の API パラメーターを相互参照で示しています。
| Google マップ API パラメーター | 相当する Azure Maps API パラメーター |
|---|---|
arrival_time |
arriveAt |
avoid |
avoid |
departure_time |
departAt |
destinations |
destination - POST 要求の本文で GeoJSON として指定します。 |
key |
subscription-key - 詳細については、「Azure Maps による認証」を参照してください。 |
language |
language - 詳細については、「Azure Maps でのローカライズのサポート」を参照してください。 |
mode |
travelMode |
origins |
origins - POST 要求の本文で GeoJSON として指定します。 |
region |
N/A - これはジオコーディング関連の機能です。 Azure Maps のジオコーディング API を使用する場合は、countrySet パラメーターを使用します。 |
traffic_model |
N/A - 交通情報データを traffic パラメーターで使用する必要がある場合のみ指定できます。 |
transit_mode |
N/A - 輸送ベースの距離マトリックスは現在サポートされていません。 |
transit_routing_preference |
N/A - 輸送ベースの距離マトリックスは現在サポートされていません。 |
units |
N/A - Azure Maps ではメートル法のみが使用されます。 |
ヒント
Azure Maps のルート指定 API で使用できる高度なルート指定オプションはすべて、Azure Maps 距離行列 API でサポートされます。 高度なルート指定オプションには、トラック ルート指定、エンジン仕様などがあります。
詳しくは、ルーティングのベスト プラクティスに関する記事を参照してください。
タイム ゾーンを取得する
Azure Maps には、座標のタイム ゾーンを取得するための API が用意されています。 Azure Maps のタイム ゾーン API は、Google マップのタイム ゾーン API に相当します。
- Get Timezone By Coordinates: 座標を指定し、その座標のタイム ゾーンの詳細を取得します。
次の表では、Google マップ API パラメーターと、それに相当する Azure Maps の API パラメーターを相互参照で示しています。
| Google マップ API パラメーター | 相当する Azure Maps API パラメーター |
|---|---|
key |
subscription-key - 詳細については、「Azure Maps による認証」を参照してください。 |
language |
language - 詳細については、「Azure Maps でのローカライズのサポート」を参照してください。 |
location |
query |
timestamp |
timeStamp |
この API 以外にも、Azure Maps には、多くのタイム ゾーン API が用意されています。 これらの API は、タイム ゾーンの名前または ID に基づいて時刻を変換します。
- Get Timezone By ID: 指定された IANA タイム ゾーン ID の現在、過去、将来のタイム ゾーンに関する情報を返します。
- Get Timezone Enum IANA: IANA タイム ゾーン ID の完全なリストを返します。 IANA サービスの更新は、1 日以内にシステムに反映されます。
- Get Timezone Enum Windows: Windows タイム ゾーン ID の完全なリストを返します。
- Get Timezone IANA Version: Azure Maps で現在使用されている IANA のバージョン番号を返します。
- Get Timezone Windows To IANA: 有効な Windows タイム ゾーン ID が指定されると、対応する IANA ID を返します。 1 つの Windows ID に対して複数の IANA ID が返される場合があります。
クライアント ライブラリ
Azure Maps には、次のプログラミング言語用のクライアント ライブラリが用意されています。
- JavaScript、TypeScript、Node.js – Azure Maps サービス モジュール | npm パッケージ
これらのオープンソース クライアント ライブラリは、その他のプログラミング言語用です。
- .NET Standard 2.0 - GitHub プロジェクト | NuGet パッケージ
リソースをクリーンアップする
クリーンアップすべきリソースはありません。
次のステップ
Azure Maps REST サービスについて、さらに詳しく学習します。