다음을 통해 공유

Render - Get Map Static Image

서비스:
Maps
API 버전:
2024-04-01

이 렌더링 API는 사용자 정의 영역의 래스터화된 정적 지도 보기를 생성합니다. 원하는 사용자 환경에 대화형 맵 컨트롤이 필요하지 않거나 대역폭이 제한되는 경우 경량 웹 애플리케이션에 적합합니다. 이 API는 브라우저 외부, 백 엔드 서비스, 보고서 생성 또는 데스크톱 애플리케이션의 애플리케이션에 맵을 포함하는 데에도 유용합니다.

이 API에는 기본 데이터 시각화를 위한 매개 변수가 포함됩니다.

  • 여러 스타일의 레이블이 지정된 압정입니다.
  • 원, 경로 및 다각형 기하 도형 형식을 렌더링합니다.

자세한 내용 및 자세한 예제는 래스터 맵사용자 지정 데이터 렌더링 참조하세요.

bbox 매개 변수의 차원은 확대/축소 수준에 따라 제한됩니다. 이렇게 하면 결과 이미지에 적절한 수준의 세부 정보가 보장됩니다.

확대/축소 수준 최소 론 범위 최대 Lon 범위 최소 위도 범위 최대 위도 범위
0 56.25 360.0 30.1105585173 180.0
1 28.125 360.0 14.87468995 180.0
2 14.063 351.5625 7.4130741851 137.9576312246
3 7.03125 175.78125 3.7034501005 73.6354071932
4 3.515625 87.890625 1.8513375155 35.4776115315
5 1.7578125 43.9453125 0.925620264 17.4589959239
6 0.87890625 21.97265625 0.4628040687 8.6907788223
7 0.439453125 10.986328125 0.2314012764 4.3404320789
8 (여덟) 0.2197265625 5.4931640625 0.1157005434 2.1695927024
9 0.1098632812 2.7465820312 0.0578502599 1.0847183194
10 0.0549316406 1.3732910156 0.0289251285 0.5423494021
11 0.0274658203 0.6866455078 0.014462564 0.2711734813
12 0.0137329102 0.3433227539 0.007231282 0.1355865882
13 0.0068664551 0.171661377 0.003615641 0.067793275
14 0.0034332275 0.0858306885 0.0018078205 0.0338966351
15 0.0017166138 0.0429153442 0.0009039102 0.0169483173
16 0.0008583069 0.0214576721 0.0004519551 0.0084741586
17 0.0004291534 0.0107288361 0.0002259776 0.0042370793
18 0.0002145767 0.005364418 0.0001129888 0.0021185396
19 0.0001072884 0.002682209 5.64944E-05 0.0010592698
20 5.36442E-05 0.0013411045 2.82472E-05 0.0005296349

참고: 센터 또는 bbox 매개 변수를 API에 제공해야 합니다.

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01
선택적 매개 변수: 
GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
api-version
 query True

string

Azure Maps API의 버전 번호입니다. 현재 버전은 2024-04-01입니다.
bbox
 query

number[]

경계 상자는 지구 사각형 영역의 네 면을 나타내는 두 위도와 두 개의 경도로 정의됩니다. 형식: 'minLon, minLat, maxLon, maxLat'(double).

참고: bbox 또는 center는 필수 매개 변수입니다. 그들은 상호 배타적입니다. bbox는 높이 또는 너비와 함께 사용하면 안 됩니다.

위도 및 Lon에 허용되는 최대 및 최소 범위는 이 페이지 맨 위에 있는 테이블의 각 확대/축소 수준에 대해 정의됩니다.
center
 query

number[]

중심점의 좌표(double)입니다. 형식: 'lon,lat'. 경도 범위: 180까지 -180. 위도 범위: 90까지 -90.

참고: 가운데 또는 bbox는 필수 매개 변수입니다. 그들은 상호 배타적입니다.
height
 query

integer (int32)

minimum: 80
maximum: 1500

결과 이미지의 높이(픽셀)입니다. 범위는 80에서 1500까지입니다. 기본값은 512입니다. bbox와 함께 사용하면 안 됩니다.
language
 query

string

검색 결과를 반환해야 하는 언어입니다. 대/소문자를 구분하지 않는 지원되는 IETF 언어 태그 중 하나여야 합니다. 특정 필드에 대해 지정된 언어의 데이터를 사용할 수 없는 경우 기본 언어가 사용됩니다.

자세한 내용은 지원되는 언어 참조하세요.
path
 query

string[]

경로 스타일 및 위치(double)입니다. 선택적으로 이미지에 선, 다각형 또는 원을 추가하려면 이 매개 변수를 사용합니다. 경로 스타일은 선과 채우기의 모양을 설명합니다. (파이프 및 문장 부호와 같은 예약된 문자가 포함되므로 이 매개 변수의 값을 URL로 올바르게 인코딩해야 합니다.)

경로 매개 변수는 S1부터 Azure Maps 계정 SKU에서 지원됩니다. 경로 매개 변수의 여러 인스턴스는 해당 스타일을 사용하여 여러 기하 도형을 지정할 수 있습니다. 요청당 매개 변수 수는 10개로 제한되고 위치 수는 경로당 100개로 제한됩니다.

기본 스타일을 사용하여 반지름 100m, 위도 45°N의 중심점, 경도 122°W의 원을 렌더링하려면 querystring 매개 변수를 추가합니다.

path=ra100||-122 45

경도는 위도 앞에 옵니다. URL 인코딩 후 다음과 같이 표시됩니다.

path=ra100%7C%7C-122+45

여기에 있는 모든 예제는 명확성을 위해 URL 인코딩 없이 경로 매개 변수를 보여 줍니다.

선을 렌더링하려면 각 위치를 파이프 문자로 구분합니다. 예를 들어 다음을 사용합니다.

path=||-122 45|-119.5 43.2|-121.67 47.12

다각형은 첫 번째와 마지막 점이 같은 닫힌 경로로 지정됩니다. 예를 들어 다음을 사용합니다.

path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45

선 및 다각형 위치에 대한 경도 값은 자오선 방지를 통과하는 기하 도형을 렌더링할 수 있도록 -360 범위에서 360까지의 범위일 수 있습니다.

스타일 한정자

스타일 한정자를 추가하여 경로의 모양을 수정할 수 있습니다. 이러한 항목은 위치 앞에 추가됩니다. 스타일 한정자는 각각 두 글자 이름을 갖습니다. 이러한 약어 이름은 URL의 길이를 줄이는 데 사용됩니다.

윤곽선의 색을 변경하려면 'lc' 스타일 한정자를 사용하고 6자리 16진수인 HTML/CSS RGB 색 형식을 사용하여 색을 지정합니다(세 자리 형식은 지원되지 않음). 예를 들어 CSS에서 #FF1493 지정하는 딥 핑크 색을 사용하려면

path=lcFF1493||-122 45|-119.5 43.2

여러 스타일 한정자를 결합하여 더 복잡한 비주얼 스타일을 만들 수 있습니다.

lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6

스타일 한정자 요약

수식어 설명 유형 범위
lc 선 색 문자열 000000에서 FFFFFF로
fc 채우기 색 문자열 000000에서 FFFFFF로
라 선 알파(불투명도) 떠다니다 0~1
파 알파 채우기(불투명도) 떠다니다 0~1
lw 선 너비 int32 (0, 50]
ra(ra) 원 반경(미터) 떠다니다 0보다 큼
pins
 query

string[]

압정 스타일 및 인스턴스. 필요에 따라 이미지에 압정을 추가하려면 이 매개 변수를 사용합니다. 압정 스타일은 압정의 모양을 설명하고 인스턴스는 각 핀에 대한 압정(이중)과 선택적 레이블의 좌표를 지정합니다. (파이프 및 문장 부호와 같은 예약된 문자가 포함되므로 이 매개 변수의 값을 URL로 올바르게 인코딩해야 합니다.)

Azure Maps 계정 S0 SKU는 핀 매개 변수의 단일 인스턴스만 지원하며 위치 수는 핀당 5개로 제한됩니다. 다른 SKU는 핀 매개 변수의 인스턴스를 최대 25개까지 허용하여 여러 핀 스타일을 지정할 수 있으며 위치 수는 핀당 50개로 제한됩니다.

기본 제공 압정 스타일을 사용하여 위도 45°N 및 경도 122°W에서 압정을 렌더링하려면 querystring 매개 변수를 추가합니다.

pins=default||-122 45

경도는 위도 앞에 옵니다. URL 인코딩 후 다음과 같이 표시됩니다.

pins=default%7C%7C-122+45

여기에 있는 모든 예제는 명확성을 위해 URL 인코딩 없이 핀 매개 변수를 보여 줍니다.

여러 위치에서 핀을 렌더링하려면 각 위치를 파이프 문자로 구분합니다. 예를 들어 다음을 사용합니다.

pins=default||-122 45|-119.5 43.2|-121.67 47.12

S0 Azure Maps 계정 SKU는 압정 5개만 허용합니다. 다른 계정 SKU에는 이 제한이 없습니다.

스타일 한정자

스타일 한정자를 추가하여 핀의 모양을 수정할 수 있습니다. 스타일 뒤와 위치 및 레이블 앞에 추가됩니다. 스타일 한정자는 각각 두 글자 이름을 갖습니다. 이러한 약어 이름은 URL의 길이를 줄이는 데 사용됩니다.

압정의 색을 변경하려면 'co' 스타일 한정자를 사용하고 6자리 16진수인 HTML/CSS RGB 색 형식을 사용하여 색을 지정합니다(세 자리 형식은 지원되지 않음). 예를 들어 CSS에서 #FF1493 지정하는 딥 핑크 색을 사용하려면

pins=default|coFF1493||-122 45

압정 레이블

핀에 레이블을 추가하려면 레이블을 좌표 바로 앞에 작은따옴표로 넣습니다. 레이블에 | 또는 || 같은 특수 문자를 사용하지 않습니다. 예를 들어 값이 '1', '2' 및 '3'인 핀 3개에 레이블을 지정하려면

pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

압정 이미지를 표시하지 않는 'none'이라는 기본 제공 압정 스타일이 있습니다. 고정 이미지 없이 레이블을 표시하려는 경우 이를 사용할 수 있습니다. 예를 들면 다음과 같습니다.

pins=none||'A'-122 45|'B'-119.5 43.2

압정 레이블의 색을 변경하려면 'lc' 레이블 색 스타일 한정자를 사용합니다. 예를 들어 검은색 레이블이 있는 분홍색 압정을 사용하려면

pins=default|coFF1493|lc000000||-122 45

레이블의 크기를 변경하려면 'ls' 레이블 크기 스타일 한정자를 사용합니다. 레이블 크기는 레이블 텍스트의 대략적인 높이를 픽셀 단위로 나타냅니다. 예를 들어 레이블 크기를 12로 늘리려면

pins=default|ls12||'A'-122 45|'B'-119 43

레이블은 압정 '레이블 앵커'를 중심으로 합니다. 앵커 위치는 기본 제공 압정에 대해 미리 정의되며 사용자 지정 압정의 맨 위에 있습니다(아래 참조). 레이블 앵커를 재정의하려면 'la' 스타일 한정자를 사용하고 앵커에 대한 X 및 Y 픽셀 좌표를 제공합니다. 이러한 좌표는 압정 이미지의 왼쪽 위 모서리를 기준으로 합니다. 양수 X 값은 앵커를 오른쪽으로 이동하고 양수 Y 값은 앵커를 아래로 이동합니다. 예를 들어 레이블 앵커를 오른쪽 10픽셀, 압정 이미지의 왼쪽 위 모서리 위에 4픽셀을 배치하려면

pins=default|la10 -4||'A'-122 45|'B'-119 43

사용자 지정 압정

사용자 지정 압정 이미지를 사용하려면 'custom'이라는 단어를 핀 스타일 이름으로 사용한 다음 위치 및 레이블 정보 다음에 URL을 지정합니다. 사용자 지정된 레이블 이미지에 허용되는 최대 크기는 65,536픽셀입니다. 두 개의 파이프 문자를 사용하여 위치를 지정하고 URL을 시작했음을 나타냅니다. 예를 들면 다음과 같습니다.

pins=custom||-122 45||http://contoso.com/pushpins/red.png

URL 인코딩 후 다음과 같이 표시됩니다.

pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png

기본적으로 사용자 지정 압정 이미지는 핀 좌표 가운데에 그려집니다. 강조 표시하려는 위치를 가리기 때문에 일반적으로 이상적이지 않습니다. 핀 이미지의 앵커 위치를 재정의하려면 'an' 스타일 한정자를 사용합니다. 'la' 레이블 앵커 스타일 한정자와 동일한 형식을 사용합니다. 예를 들어 사용자 지정 핀 이미지에 이미지의 왼쪽 위 모서리에 있는 핀의 팁이 있는 경우 다음을 사용하여 앵커를 해당 지점으로 설정할 수 있습니다.

pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png

참고: 'co' 색 한정자를 사용자 지정 압정 이미지와 함께 사용하는 경우 지정된 색은 이미지에 있는 픽셀의 RGB 채널을 대체하지만 알파(불투명도) 채널은 변경되지 않습니다. 이 작업은 일반적으로 단색 사용자 지정 이미지로만 수행됩니다.

배율, 회전 및 불투명도

'sc' 배율 스타일 한정자를 사용하여 압정 및 해당 레이블을 더 크거나 작게 만들 수 있습니다. 0보다 큰 값입니다. 값 1은 표준 눈금입니다. 값이 1보다 크면 핀이 커지고 값이 1보다 작으면 핀이 작아지게 됩니다. 예를 들어 압정 50% 평소보다 크게 그리려면

pins=default|sc1.5||-122 45

'ro' 회전 스타일 한정자를 사용하여 압정 및 해당 레이블을 회전할 수 있습니다. 시계 방향 회전의 수입니다. 음수를 사용하여 시계 반대 방향으로 회전합니다. 예를 들어 압정을 시계 방향으로 90도 회전하고 크기를 두 배로 늘리려면

pins=default|ro90|sc2||-122 45

'al' 알파 스타일 한정자를 지정하여 압정 및 해당 레이블을 부분적으로 투명하게 만들 수 있습니다. 압정의 불투명도를 나타내는 0에서 1 사이의 숫자입니다. 0은 완전히 투명하고 표시되지 않으며 1은 완전히 불투명하게 만듭니다(기본값). 예를 들어 압정 및 해당 레이블을 67개% 불투명하게 만들려면

pins=default|al.67||-122 45

스타일 한정자 요약

수식어 설명 유형 범위
알 알파(불투명도) 떠다니다 0~1
은 고정 고정 <정수32, 정수32> *
코 색 고정 문자열 000000에서 FFFFFF로
라 레이블 앵커 <정수32, 정수32> *
lc 레이블 색 문자열 000000에서 FFFFFF로
디렉토리 내용 표시 명령어 레이블 크기 떠다니다 0보다 큼
ro 회전 떠다니다 -360 ~360
sc 규모 떠다니다 0보다 큼
  • X 및 Y 좌표는 핀 이미지 또는 주위의 여백 내에 있을 수 있습니다. 여백 크기는 핀 너비와 높이의 최소값입니다.
tilesetId
 query

TilesetId

반환할 지도 스타일입니다. 가능한 값은 microsoft.base.road, microsoft.base.darkgrey 및 microsoft.imagery입니다. 기본값은 microsoft.base.road로 설정됩니다. 자세한 내용은 Render TilesetId참조하세요.
trafficLayer
 query

TrafficTilesetId

이미지 결과에 오버레이된 트래픽 흐름이 없음을 나타내는 선택적 값입니다. 가능한 값은 microsoft.traffic.relative.main 및 none입니다. 기본값은 반환되는 트래픽 흐름을 나타내지 않음을 나타냅니다. 트래픽 관련 tilesetId가 제공되면 해당 트래픽 계층이 있는 지도 이미지를 반환합니다. 자세한 내용은 Render TilesetId참조하세요.
view
 query

LocalizedMapView

View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 이러한 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에서 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps의 View 매개 변수는 Azure Maps를 통해 액세스할 수 있는 권한이 있는 지도, 이미지 및 기타 데이터 및 타사 콘텐츠를 사용할 수 있는 국가/지역의 매핑과 관련된 법률을 포함하여 관련 법률을 준수하는 데 사용해야 합니다. 예: view=IN.

자세한 내용은 지원되는 뷰 참조하고 사용 가능한 보기를 확인하세요.
width
 query

integer (int32)

minimum: 80
maximum: 2000

결과 이미지의 너비(픽셀)입니다. 범위는 80에서 2000까지입니다. 기본값은 512입니다. bbox와 함께 사용하면 안 됩니다.
zoom
 query

integer (int32)

minimum: 0
maximum: 20

맵의 원하는 확대/축소 수준입니다. tilesetId가 microsoft.base.road 또는 microsoft.base.darkgrey인 경우 확대/축소 값 범위는 0-20(포함)입니다. tilesetId가 microsoft.imagery인 경우 확대/축소 값 범위는 0-19(포함)입니다. 기본값은 12입니다.

자세한 내용은 확대/축소 수준 및 타일 그리드참조하세요.

요청 헤더

Name 필수 형식 Description
x-ms-client-id

string

Microsoft Entra ID 보안 모델과 함께 사용할 계정을 나타냅니다. Azure Maps 계정에 대한 이 고유 ID는 Azure Maps 관리 평면 계정 API에서 가져올 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안을 사용하는 방법에 대한 자세한 내용은 Azure Maps에서 인증 관리를 참조하세요.
Accept

MediaType

수락 헤더 필드를 사용하여 응답 미디어 유형에 대한 기본 설정을 지정할 수 있습니다. 허용되는 미디어 유형에는 image/jpeg 및 image/png가 포함됩니다. Accept 헤더가 지정되지 않은 경우 image/png로 이미지를 반환합니다.

응답

Name 형식 Description
200 OK

object

이 이미지는 성공적인 Get Map Static Image 호출에서 반환됩니다.

Media Types: "image/jpeg", "image/png"

헤더

Content-Type: string
Other Status Codes

ErrorResponse

예기치 않은 오류가 발생했습니다.

Media Types: "image/jpeg", "image/png"

보안

AADToken

다음은 Microsoft Entra OAuth 2.0 흐름에 . Azure 역할 기반 액세스 컨트롤과 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 Azure Maps REST API에 대한 하나 이상의 권한으로 구성된 기본 제공 역할 또는 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.

시나리오를 구현하려면인증 개념을 확인하는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.

비고

  • 이 보안 정의 x-ms-client-id 헤더를 사용하여 애플리케이션이 액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API가져올 수 있습니다.

Authorization URL Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다. * Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다. * Azure Maps Web SDK 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스를 만들 때 프로비전되는 공유 키입니다.

이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있는 권한이 부여됩니다. 즉, 이러한 키는 현재 발급된 계정의 마스터 키로 처리될 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 이 키를 안전하게 저장할 수 있는 Azure Maps REST API의 서버-서버 액세스를 사용하는 것이 좋습니다.

형식: apiKey
In(다음 안에): header

SAS Token

공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.

이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어를 사용하여 액세스하고 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어 권한을 부여받습니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.

형식: apiKey
In(다음 안에): header

예제

Successful Static Image Request

샘플 요청

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

샘플 응답

상태 코드:
200 
Content-Type: image/png
"{file}"

정의

Name Description
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
LocalizedMapView

View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 이러한 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에서 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps의 View 매개 변수는 Azure Maps를 통해 액세스할 수 있는 권한이 있는 지도, 이미지 및 기타 데이터 및 타사 콘텐츠를 사용할 수 있는 국가/지역의 매핑과 관련된 법률을 포함하여 관련 법률을 준수하는 데 사용해야 합니다. 예: view=IN.

자세한 내용은 지원되는 뷰 참조하고 사용 가능한 보기를 확인하세요.
MediaType

수락 헤더 필드를 사용하여 응답 미디어 유형에 대한 기본 설정을 지정할 수 있습니다. 허용되는 미디어 유형에는 image/jpeg 및 image/png가 포함됩니다. Accept 헤더가 지정되지 않은 경우 image/png로 이미지를 반환합니다.
TilesetId

반환할 지도 스타일입니다. 가능한 값은 microsoft.base.road, microsoft.base.darkgrey 및 microsoft.imagery입니다. 기본값은 microsoft.base.road로 설정됩니다. 자세한 내용은 Render TilesetId참조하세요.
TrafficTilesetId

이미지 결과에 오버레이된 트래픽 흐름이 없음을 나타내는 선택적 값입니다. 가능한 값은 microsoft.traffic.relative.main 및 none입니다. 기본값은 반환되는 트래픽 흐름을 나타내지 않음을 나타냅니다. 트래픽 관련 tilesetId가 제공되면 해당 트래픽 계층이 있는 지도 이미지를 반환합니다. 자세한 내용은 Render TilesetId참조하세요.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

Object

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

LocalizedMapView

열거형

View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 이러한 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에서 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps의 View 매개 변수는 Azure Maps를 통해 액세스할 수 있는 권한이 있는 지도, 이미지 및 기타 데이터 및 타사 콘텐츠를 사용할 수 있는 국가/지역의 매핑과 관련된 법률을 포함하여 관련 법률을 준수하는 데 사용해야 합니다. 예: view=IN.

자세한 내용은 지원되는 뷰 참조하고 사용 가능한 보기를 확인하세요.

값 Description
AE

아랍에미리트(아랍어 보기)
AR

아르헨티나(아르헨티나어 보기)
BH

바레인(아랍어 보기)
IN

인도(인도어 보기)
IQ

이라크(아랍어 보기)
JO

요르단(아랍어 보기)
KW

쿠웨이트(아랍어 보기)
LB

레바논(아랍어 보기)
MA

모로코(모로코어 보기)
OM

오만(아랍어 보기)
PK

파키스탄(파키스탄어 보기)
PS

팔레스타인 자치 정부(아랍어 보기)
QA

카타르(아랍어 보기)
SA

사우디아라비아(아랍어 보기)
SY

시리아(아랍어 보기)
US

미국
YE

예멘(아랍어 보기)
Auto

요청의 IP 주소를 기반으로 맵 데이터를 반환합니다.
Unified

통합 보기(기타)

MediaType

열거형

수락 헤더 필드를 사용하여 응답 미디어 유형에 대한 기본 설정을 지정할 수 있습니다. 허용되는 미디어 유형에는 image/jpeg 및 image/png가 포함됩니다. Accept 헤더가 지정되지 않은 경우 image/png로 이미지를 반환합니다.

값 Description
image/png

png 형식으로 이미지를 반환합니다.
image/jpeg

jpeg 형식으로 이미지를 반환합니다.

TilesetId

열거형

반환할 지도 스타일입니다. 가능한 값은 microsoft.base.road, microsoft.base.darkgrey 및 microsoft.imagery입니다. 기본값은 microsoft.base.road로 설정됩니다. 자세한 내용은 Render TilesetId참조하세요.

값 Description
microsoft.base.road

TilesetId에는 렌더링 기본 스타일이 있는 모든 레이어가 포함됩니다.
microsoft.base.darkgrey

TilesetId에는 짙은 회색 스타일의 모든 레이어가 포함되어 있습니다.
microsoft.imagery

TilesetId에는 위성 및 항공 이미지의 조합이 포함되어 있습니다.

TrafficTilesetId

열거형

이미지 결과에 오버레이된 트래픽 흐름이 없음을 나타내는 선택적 값입니다. 가능한 값은 microsoft.traffic.relative.main 및 none입니다. 기본값은 반환되는 트래픽 흐름을 나타내지 않음을 나타냅니다. 트래픽 관련 tilesetId가 제공되면 해당 트래픽 계층이 있는 지도 이미지를 반환합니다. 자세한 내용은 Render TilesetId참조하세요.

값 Description
microsoft.traffic.relative.main

지원되는 트래픽 관련 tilesetId.
none

기본값, 트래픽 흐름 오버레이 없음.