Azure Maps (プレビュー)

このコネクタは、次の製品とリージョンで使用できます。

サービス	クラス	Regions
コピロット スタジオ	Standard	次を除くすべてのPower Automateリージョン:      - 21Vianet が運営する China Cloud
ロジック アプリ	Standard	次を除くすべての Logic Apps リージョン :      - 中国リージョンAzure      - 米国国防総省 (DoD)
Power Apps	Standard	次を除くすべてのPower Appsリージョン:      - 21Vianet が運営する China Cloud
Power Automate（パワーオートメート）	Standard	次を除くすべてのPower Automateリージョン:      - 21Vianet が運営する China Cloud

連絡先
名前	マイクロソフト
URL	https://www.microsoft.com/

コネクタ メタデータ
Publisher	マイクロソフト
Web サイト	https://azure.microsoft.com/products/azure-maps
プライバシー ポリシー	https://privacy.microsoft.com/privacystatement
カテゴリ	データ;生産性

Azure Maps コネクタ

型： コードレス | 層： 標準 | ステータス： プレビュー

Azure Maps REST API を使用して、マッピング、ルーティング、ジオコーディング、逆ジオコーディングの機能を提供します。 要求は APIM ポリシーによって完全に処理されます。コネクタ Web アプリはありません。

Authentication

API キー認証。 接続には、Azure Mapsサブスクリプション キーが必要です。

パラメーター	タイプ	必須	Description
subscription_key	securestring	はい	Azure Maps サブスクリプション キー

キーは接続トークンから抽出され、ポリシー (CheckForToken / GetAuthHeaderValue) によって subscription-key クエリ パラメーターとしてAzure Mapsに渡されます。

クラウドの可用性

雲	Available
Public	はい
Fairfax (GCC)	はい
GCC High	はい
DoD	はい

アクション

ルートの取得 — GetRoute

2 つのウェイポイント間の運転または歩行ルートを計算します。 ウェイポイントは座標ペア (latitude,longitude) である必要があります。 住所はサポートされていません。最初に住所 で場所を取得を使用してジオコーディングします。

エンドポイント (ポリシーの後):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

このポリシーでは、GET スタイルのクエリ パラメーターを GEOJSON FeatureCollection POST 本文に変換し、座標をlongitude,latitude順序に反転し、回避/最適化値を同等の値Azure Mapsマップします。

パラメーター	必須	タイプ	Description
Waypoint 1 (wp.0)	はい	文字列	latitude,longitudeとしての開始点 (例: 47.610,-122.107)
Waypoint 2 (wp.1)	はい	文字列	latitude,longitudeとしての終了点 (例: 47.612,-122.204)
移動モード (travelMode)	いいえ	文字列	driving (既定値) または walking
高速道路を避ける	いいえ	boolean	マップ avoid=limitedAccessHighways
通行料を避ける	いいえ	boolean	マップ avoid=tollRoads
フェリーを避ける	いいえ	boolean	マップ avoid=ferries
国境を越えないようにする	いいえ	boolean	マップ avoid=borderCrossings
Optimize	いいえ	文字列	fastestWithoutTraffic、 fastestWithTraffic、または shortest

応答： 移動距離 (メートル)、期間 (秒)、トラフィックを含む期間 (秒)、ルート 区間の詳細を含むルートの概要。

メモ： トランジット ルーティングはサポートされていません。 Azure Mapsルート案内では、drivingとwalkingのみがサポートされます。

---

住所で場所を取得する — GetLocationByAddress

構造化された住所を座標と場所の詳細にジオコーディングします。

エンドポイント：GET https://atlas.microsoft.com/geocode?api-version=2023-06-01

パラメーター	必須	タイプ	Description
住所行 (addressLine)	いいえ	文字列	ストリートライン (例: 15595 NE 36th St)
ローカリティ (locality)	いいえ	文字列	市区町村 (例: Redmond)
管理地区 (adminDistrict)	いいえ	文字列	州の省略形 (例: WA)
郵便番号 (postalCode)	いいえ	文字列	郵便番号 (例: 98052)
国リージョン (countryRegion)	いいえ	文字列	ISO 2 文字の国コード (例: US)
最大結果 (top)	いいえ	整数	1 ~ 20、既定値は 5

応答： GeoJSON FeatureCollection。 各機能には次の機能があります。

• geometry.coordinates — [longitude, latitude]
• properties.confidence — High、 Medium、または Low
• properties.address — addressLine、 locality、 adminDistricts、 postalCode、 countryRegion ( name と ISOを持つオブジェクト) formattedAddress

注: Azure Mapsジオコーディングでは、中国の住所はサポートされていません。

---

ポイントで場所を取得する — GetLocationByPoint

住所に対して緯度/経度座標を逆ジオコーディングします。

エンドポイント (ポリシーの後):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

ポリシーは、個別のlatitudeパラメーターとlongitude パラメーターをlongitude,latitude順序でcoordinatesクエリ パラメーターに結合します。

パラメーター	必須	タイプ	Description
ポイント緯度 (latitude)	はい	double	例: 47.64054
ポイント経度 (longitude)	はい	double	例: -122.12934

応答:アドレスで場所を取得する (GetLocationByAddress_Response) と同じスキーマ。

---

静的マップを取得する — GetMap

ポイントを中心とする静的マップ イメージを取得します。

エンドポイント (ポリシーの後):GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

このポリシーは、緯度/経度をcenter パラメーター (longitude,latitude) に結合し、imagerySetをAzure Maps style値にマップし、オプションのプッシュピンをpins パラメーターとして渡します。

パラメーター	必須	タイプ	Description
中心緯度 (latitude)	はい	double	例: 47.64054
中心経度 (longitude)	はい	double	例: -122.12934
マップ スタイル (imagerySet)	はい	文字列	以下のスタイル マッピングを参照してください
ズーム レベル (zoomLevel)	はい	文字列	0 ~ 20(既定値) 10
幅 (ピクセル単位)	いいえ	整数	既定値 512
高さ (ピクセル単位)	いいえ	整数	既定値 512
イメージ形式	いいえ	文字列	jpeg または png (既定の png)。 GIF はサポートされていません。
プッシュピンの緯度	いいえ	double	プッシュピンの場所の緯度
Pushpin 経度	いいえ	double	プッシュピンの場所の経度
Pushpin ラベル	いいえ	文字列	短いラベル テキスト

イメージ セットのマッピング:

imagerySet 入力	Azure Maps style
Road	main
Aerial	satellite
AerialWithLabels	satellite_road_labels
CanvasDark	dark
CanvasLight	road_shaded_relief
CanvasGray	grayscale_light

応答: バイナリ イメージ (image/jpeg または image/png)。 Power Automateフローでは、応答本文は base64 でエンコードされます。 イメージを表示または保存するには:

• OneDrive/SharePointに保存する前に、変換するbase64ToBinary()式を使用します。
• HTML テーブルを使用するか、<img src="data:image/png;base64,{body/$content}"> タグを含む電子メール アクションを送信してインラインでレンダリングします。

ポリシーに関する注意事項

• subscription-key はポリシーによって挿入されます。呼び出し元から渡されることはありません。
• x-ms-apim-tokensヘッダーとorigin ヘッダーは受信時に削除されます。
• Content-Type: application/json は、イメージ以外のすべての要求で強制されます。イメージの応答は、送信時に適切な image/* コンテンツ タイプを復元します。
• GetRoute は、単純なクエリ パラメーター要求を GeoJSON 本文を持つ POST に変換します。呼び出し元は本体自体を構築する必要はありません。

Files

ファイル	Purpose
apiDefinition.swagger.json	OpenAPI 定義
デプロイ/policies.xml	APIM ポリシー
デプロイ/PolicySourceCode.cs	ポリシー C# ロジック
connector-config-internal.json	認証と環境の構成
connector-config-cli.json	機能 (actions)
connector-config-certification.json	API 名 (azuremaps) とレベル (Standard)
connector-config-metadata.json	所有権メタデータ

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト	接続を作成するためのパラメーター。	すべてのリージョン	共有可能

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs

名前	タイプ	Description	必須
サブスクリプション キー	securestring	Azure Maps サブスクリプション キー	True

アクション

ポイント別に場所を取得する (プレビュー)	緯度と経度の座標に関連付けられている位置情報を取得します。
ルートの取得 (プレビュー)	ウェイポイントを使用して、運転ルートまたは歩行ルートを計算します。 ウェイポイントは、緯度、経度座標として指定する必要があります。
住所で場所を取得する (プレビュー)	住所をジオコーディングして、その座標と場所の詳細を取得します。
静的マップを取得する (プレビュー)	ポイントを中心とする静的マップ イメージを取得します。 GIF はサポートされていません。JPEG または PNG を使用します。

ポイント別に場所を取得する (プレビュー)

ルートの取得 (プレビュー)

住所で場所を取得する (プレビュー)

静的マップを取得する (プレビュー)

定義

GetRoute_Response

GetLocationByAddress_Response

GetMap_Response