Azure Maps(미리 보기)

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Standard	다음을 제외한 모든 Power Automate 지역:      - 21Vianet에서 운영하는 중국 클라우드
논리 앱	Standard	다음을 제외한 모든 Logic Apps 지역 :      - Azure 중국 지역      - 미국 국방부(DoD)
Power Apps	Standard	다음을 제외한 모든 Power Apps 지역:      - 21Vianet에서 운영하는 중국 클라우드
파워 오토메이트	Standard	다음을 제외한 모든 Power Automate 지역:      - 21Vianet에서 운영하는 중국 클라우드

Contact
이름	Microsoft
URL	https://www.microsoft.com/

커넥터 메타데이터
Publisher	Microsoft
웹 사이트	https://azure.microsoft.com/products/azure-maps
개인 정보 보호 정책	https://privacy.microsoft.com/privacystatement
카테고리	데이터; 생산력

Azure Maps 커넥터

형식: 코드 없는 | 계층: 표준 | 상태: 미리 보기

Azure Maps REST API를 통해 매핑, 라우팅, 지오코딩 및 역방향 지오코딩 기능을 제공합니다. 요청은 APIM 정책에 의해 전적으로 처리됩니다. 커넥터 웹앱이 없습니다.

Authentication

API 키 인증. 연결에는 Azure Maps 구독 키가 필요합니다.

매개 변수	Type	필수	Description
subscription_key	시큐어스트링 (보안 문자열)	예	Azure Maps 구독 키

키는 연결 토큰에서 추출되고 정책(CheckForToken / GetAuthHeaderValue)에 의해 쿼리 매개 변수로 subscription-key Azure Maps 전달됩니다.

클라우드 가용성

클라우드	Available
공개	예
페어팩스(GCC)	예
GCC High	예
DoD	예

활동

경로 가져오기 - GetRoute

두 가지 중간 지점 사이의 주행 또는 도보 경로를 계산합니다. 웨이포인트는 좌표 쌍(latitude,longitude)이어야 합니다. 주소는 지원되지 않습니다. 주소 별 위치 가져오기를 사용하여 먼저 지오코딩합니다.

엔드포인트(정책 이후):POST https://atlas.microsoft.com/route/directions?api-version=2025-01-01

이 정책은 GET 스타일 쿼리 매개 변수를 GeoJSON FeatureCollection POST 본문으로 변환하고, 좌표를 순서대로 longitude,latitude 대칭 이동하고, 피/최적화 값을 Azure Maps 동등한 값으로 매핑합니다.

매개 변수	필수	Type	Description
웨이포인트 1(wp.0)	예	string	시작점(예: )입니다 latitude,longitude . 47.610,-122.107
웨이포인트 2(wp.1)	예	string	끝점(예: )입니다 latitude,longitude . 47.612,-122.204
이동 모드(travelMode)	No	string	driving (기본값) 또는 walking
고속도로 방지	No	boolean	에 매핑 avoid=limitedAccessHighways
통행료 방지	No	boolean	에 매핑 avoid=tollRoads
페리 방지	No	boolean	에 매핑 avoid=ferries
국경을 넘지 않도록 합니다.	No	boolean	에 매핑 avoid=borderCrossings
Optimize	No	string	fastestWithoutTraffic, fastestWithTraffic 또는 shortest

응답: 이동 거리(미터), 지속 시간(초), 트래픽이 있는 기간(초) 및 경로 레그 세부 정보가 포함된 경로 요약입니다.

참고: 전송 라우팅은 지원되지 않습니다. Azure Maps 경로 방향만 지원하고 .drivingwalking

---

주소별 위치 가져오기 - GetLocationByAddress

구조화된 주소를 좌표 및 위치 세부 정보로 지오코딩합니다.

끝점:GET https://atlas.microsoft.com/geocode?api-version=2023-06-01

매개 변수	필수	Type	Description
주소 줄(addressLine)	No	string	거리 선(예: 15595 NE 36th St)
지역성(locality)	No	string	City(예: Redmond)
관리 구역(adminDistrict)	No	string	상태 약어(예: WA)
우편 번호(postalCode)	No	string	ZIP 또는 우편 번호(예: 98052)
국가 지역(countryRegion)	No	string	ISO 2자 국가 코드(예: US)
최대 결과(top)	No	정수 (integer)	1-20, 기본값 5

응답: GeoJSON FeatureCollection. 각 기능에는 다음이 있습니다.

• geometry.coordinates — [longitude, latitude]
• properties.confidence — High, Medium, 또는 Low
• properties.address— addressLine, locality, adminDistricts, postalCodecountryRegion (object with name and ISO),formattedAddress

참고: Azure Maps 지오코딩은 중국의 주소를 지원하지 않습니다.

---

지점별 위치 가져오기 - GetLocationByPoint

지오코드 위도/경도 좌표를 주소로 역방향으로 바뀝니다.

엔드포인트(정책 이후):GET https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates={longitude},{latitude}

정책은 별도의 latitude 매개 변수와 longitude 매개 변수를 쿼리 매개 변수에 coordinateslongitude,latitude 순서대로 결합합니다.

매개 변수	필수	Type	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 결합하고, Azure Maps style 값에 매핑 imagerySet 하고, 선택적 압정을 매개 변수로 pins 전달longitude,latitude합니다.

매개 변수	필수	Type	Description
가운데 위도(latitude)	예	double	예: 47.64054
가운데 경도(longitude)	예	double	예: -122.12934
지도 스타일(imagerySet)	예	string	아래 스타일 매핑 참조
확대/축소 수준(zoomLevel)	예	string	0-20, 기본값 10
너비(픽셀)	No	정수 (integer)	기본값 512
높이(픽셀)	No	정수 (integer)	기본값 512
이미지 형식	No	string	jpeg 또는 png (기본값 png) GIF는 지원되지 않습니다.
압정 위도	No	double	압정 위치 위도
압정 경도	No	double	압정 위치 경도
압정 레이블	No	string	짧은 레이블 텍스트

이미지 집합 매핑:

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로 인코딩됩니다. 이미지를 표시하거나 저장하려면 다음을 수행합니다.

• base64ToBinary() 식을 사용하여 OneDrive/SharePoint 저장하기 전에 변환합니다.
• 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) 및 계층(표준)
connector-config-metadata.json	소유권 메타데이터

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값	연결을 만들기 위한 매개 변수입니다.	모든 지역	공유 가능

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	Type	Description	필수
구독 키	시큐어스트링 (보안 문자열)	Azure Maps 구독 키	True

actions

경로 가져오기(미리 보기)	중간 지점을 사용하여 운전 또는 도보 경로를 계산합니다. 웨이포인트는 위도, 경도 좌표로 제공되어야 합니다.
정적 맵 가져오기(미리 보기)	점을 중심으로 정적 맵 이미지를 가져옵니다. GIF는 지원되지 않습니다. 은 JPEG 또는 PNG를 사용합니다.
주소별 위치 가져오기(미리 보기)	주소를 지오코딩하여 좌표 및 위치 세부 정보를 가져옵니다.
지점별 위치 가져오기(미리 보기)	위도 및 경도 좌표와 연결된 위치 정보를 가져옵니다.

경로 가져오기(미리 보기)

정적 맵 가져오기(미리 보기)

주소별 위치 가져오기(미리 보기)

지점별 위치 가져오기(미리 보기)

정의

GetRoute_Response

GetLocationByAddress_Response

GetMap_Response