다음을 통해 공유

Render - Get Map Image

서비스:
Maps
API 버전:
1.0

0에서 20 사이의 확대/축소 수준을 사용하여 지도 섹션이 포함된 사용자 정의 사각형 이미지를 렌더링하는 데 사용합니다.

비고

Azure Maps Render v1 서비스 사용 중지

Azure Maps Render v1 서비스는 이제 더 이상 사용되지 않으며 9/17/26에 사용 중지됩니다. 서비스 중단을 방지하려면 9/17/26까지 최신 버전의 Render API를 사용하도록 Render v1 API에 대한 모든 호출을 업데이트해야 합니다.

지도 이미지에 지원되는 해상도 범위는 1x1에서 8192x8192까지입니다. 맵 타일 서비스를 통해 정적 이미지 서비스를 사용할 시기를 결정하는 경우 렌더링된 맵과 상호 작용하는 방법을 고려할 수 있습니다. 지도 내용이 상대적으로 흔들리지 않는 경우 정적 맵을 선택하는 것이 좋습니다. 지도 콘텐츠의 많은 확대/축소, 이동 및 변경을 지원하려는 경우 지도 타일 서비스가 더 나은 선택입니다.

서비스는 또한 이미지 컴퍼지션 기능을 제공하여 다음과 같은 추가 데이터로 정적 이미지를 다시 가져옵니다. Gen1 S0, S1 및 Gen2 기능을 사용하는 압정 및 기하 도형 오버레이

Gen1 S0에서는 다음을 수행할 수 있습니다.

  • 요청에 지정된 최대 5개의 압정 렌더링
  • 요청에서 참조되는 핀에 대한 사용자 지정 이미지 하나 제공
  • 압정에 레이블 추가

Gen1 S1 및 Gen2에서는 다음을 수행할 수 있습니다.

  • Azure Maps Data Service를 통해 압정 렌더링
  • 여러 압정 스타일 지정
  • 원, 다각형 및 다각형 기하 도형 형식을 렌더링합니다.
  • Azure Maps Data Service를 통해 업로드된 지원되는 GeoJSON 기하 도형 형식의 렌더링

자세한 예제는 래스터 맵에서 사용자 지정 데이터 렌더링 방법 가이드를 참조하세요.

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

bbox 매개 변수를 사용할 때 지원되는 Lat 및 Lon 범위는 다음과 같습니다.

확대/축소 수준 최대 Lon 범위 최대 위도 범위
0 360.0 170.0
1 360.0 170.0
2 360.0 170.0
3 360.0 170.0
4 360.0 170.0
5 180.0 85.0
6 90.0 42.5
7 45.0 21.25
8 22.5 10.625
9 11.25 5.3125
10 5.625 2.62625
11 2.8125 1.328125
12 1.40625 0.6640625
13 0.703125 0.33203125
14 0.3515625 0.166015625
15 0.17578125 0.0830078125
16 0.087890625 0.0415039063
17 0.0439453125 0.0207519531
18 0.0219726563 0.0103759766
19 0.0109863281 0.0051879883
20 0.0054931641 0.0025939941 
GET https://atlas.microsoft.com/map/static/png?api-version=1.0
선택적 매개 변수: 
GET https://atlas.microsoft.com/map/static/png?api-version=1.0&layer={layer}&style={style}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
format
 path True

RasterTileFormat

원하는 응답 형식입니다. 가능한 값: png.
api-version
 query True

string

Azure Maps API의 버전 번호입니다.
bbox
 query

number[]

경계 상자. 사용된 프로젝션 - EPSG:3857. 형식: 'minLon, minLat, maxLon, maxLat'.

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

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

number[]

중심점의 좌표입니다. 형식: 'lon,lat'. 사용된 프로젝션

  • EPSG:3857. 경도 범위: 180까지 -180. 위도 범위: 85까지 -85.

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

integer (int32)

minimum: 1
maximum: 8192

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

string

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

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

StaticMapLayer

요청된 지도 계층입니다. 계층이 레이블 또는 하이브리드로 설정된 경우 형식은 png여야 합니다.
path
 query

string[]

경로 스타일 및 위치입니다. 선택적으로 이미지에 선, 다각형 또는 원을 추가하려면 이 매개 변수를 사용합니다. 경로 스타일은 선과 채우기의 모양을 설명합니다. (파이프 및 문장 부호와 같은 예약된 문자가 포함되므로 이 매개 변수의 값을 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

Azure Maps Data Storage에서 경로 위치 가져오기

S0 이외의 모든 Azure Maps 계정 SKU의 경우 Azure Maps Data Storage에서 경로 위치 정보를 가져올 수 있습니다. 경로 위치를 포함하는 GeoJSON 문서를 업로드한 후 Data Storage 서비스는 경로 매개 변수의 데이터를 참조하는 데 사용할 수 있는 UDID(Unique Data ID)를 반환합니다.

업로드된 GeoJSON 문서의 점 기하 도형을 경로 위치로 사용하려면 경로 매개 변수의 위치 섹션에서 UDID를 지정합니다. 예를 들면 다음과 같습니다.

path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

Data Storage의 경로 위치를 경로 매개 변수에 지정된 위치와 혼합할 수 없습니다.

스타일 한정자 요약

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

string[]

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

Azure Maps 계정 S0 SKU는 pins 매개 변수의 단일 인스턴스만 지원합니다. 다른 SKU를 사용하면 핀 매개 변수의 여러 인스턴스가 여러 핀 스타일을 지정할 수 있습니다.

기본 제공 압정 스타일을 사용하여 위도 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을 지정합니다. 두 개의 파이프 문자를 사용하여 위치를 지정하고 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 채널을 대체하지만 알파(불투명도) 채널은 변경되지 않습니다. 이 작업은 일반적으로 단색 사용자 지정 이미지로만 수행됩니다.

Azure Maps Data Storage에서 압정 가져오기

S0 이외의 모든 Azure Maps 계정 SKU의 경우 Azure Maps Data Storage에서 압정 위치 정보를 가져올 수 있습니다. 핀 위치가 포함된 GeoJSON 문서를 업로드한 후 Data Storage 서비스는 pin 매개 변수의 데이터를 참조하는 데 사용할 수 있는 UDID(Unique Data ID)를 반환합니다.

업로드된 GeoJSON 문서의 점 기하 도형을 핀 위치로 사용하려면 pin 매개 변수의 위치 섹션에서 UDID를 지정합니다. 예를 들면 다음과 같습니다.

pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713

점 및 다중점 기하 도형, 기하 도형 컬렉션의 점 및 다중점, 기능의 점 기하 도형만 사용됩니다. 줄 바꿈 및 다각형 기하 도형은 무시됩니다. 기능에서 포인트가 제공되고 기능에 "label"이라는 문자열 속성이 있는 경우 해당 속성의 값이 핀의 레이블로 사용됩니다.

데이터 스토리지의 핀 위치와 pin 매개 변수에 지정된 핀 위치를 혼합할 수 있습니다. 파이프로 구분된 핀 위치는 경도 및 위도 또는 UDID일 수 있습니다. 예를 들면 다음과 같습니다.

pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43

배율, 회전 및 불투명도

'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
은 고정 고정 *
코 색 고정 000000에서 FFFFFF로
라 레이블 앵커 *
lc 레이블 색 000000에서 FFFFFF로
ls 레이블 크기 0보다 큼
ro 회전 -360 ~360
sc 규모 0보다 큼
  • X 및 Y 좌표는 핀 이미지 또는 주위의 여백 내에 있을 수 있습니다. 여백 크기는 핀 너비와 높이의 최소값입니다.
style
 query

MapImageStyle

반환할 지도 스타일입니다. 가능한 값은 주 값과 어둡습니다.
view
 query

LocalizedMapView

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

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

integer (int32)

minimum: 1
maximum: 8192

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

integer (int32)

minimum: 0
maximum: 20

맵의 원하는 확대/축소 수준입니다. 확대/축소 값은 0~20(포함) 범위에 있어야 합니다. 기본값은 12입니다.

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

요청 헤더

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

string

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

응답

Name 형식 Description
200 OK

object

이 이미지는 성공적인 맵 정적 이미지 가져오기 호출에서 반환됩니다.

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

헤더

Content-Type: string
Other Status Codes

ErrorResponse

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

Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

보안

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에서 Azure Maps 계정 만들거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.

이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정에서 마스터 키로 사용할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 키를 안전하게 저장할 수 있도록 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 Azure Maps REST API에 액세스하는 것이 좋습니다.

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

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/png?api-version=1.0&layer=basic&style=main&zoom=2&bbox=1.355233,42.982261,24.980233,56.526017

샘플 응답

상태 코드:
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.

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

반환할 지도 스타일입니다. 가능한 값은 주 값과 어둡습니다.
RasterTileFormat

원하는 응답 형식입니다. 가능한 값: png.
StaticMapLayer

요청된 지도 계층입니다. 계층이 레이블 또는 하이브리드로 설정된 경우 형식은 png여야 합니다.

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

통합 보기(기타)

MapImageStyle

열거형

반환할 지도 스타일입니다. 가능한 값은 주 값과 어둡습니다.

값 Description
main

Azure Maps 기본 스타일
dark

Azure Maps 기본 스타일의 진한 회색 버전

RasterTileFormat

열거형

원하는 응답 형식입니다. 가능한 값: png.

값 Description
png

png 형식의 이미지입니다. 확대/축소 수준 0~18을 지원합니다.

StaticMapLayer

열거형

요청된 지도 계층입니다. 계층이 레이블 또는 하이브리드로 설정된 경우 형식은 png여야 합니다.

값 Description
basic

다각형, 테두리, 도로 및 레이블을 비롯한 모든 지도 기능을 포함하는 이미지를 반환합니다.
hybrid

테두리, 도로 및 레이블이 포함된 이미지를 반환하고 다른 타일(예: 위성 이미지)에 오버레이하여 하이브리드 타일을 생성할 수 있습니다.
labels

지도의 레이블 정보만 이미지를 반환합니다.