Render - Get Map Image

서비스:

Maps

API 버전:

1.0

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

참고

Azure Maps Render v1 서비스 사용 중지

Azure Maps Render v1 서비스는 이제 더 이상 사용되지 않으며 2026년 9월 17일에 사용 중지될 예정입니다. 서비스 중지를 방지하기 위해 Render v1 API에 대한 모든 호출은 2026년 9월17일까지 Render v2 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는 필수 매개 변수입니다. 그들은 상호 배타적입니다. 높이 또는 너비와 함께 사용하면 안 됩니다. Lat 및 Lon에 허용되는 최대 범위는 이 페이지 맨 위에 있는 테이블의 각 확대/축소 수준에 대해 정의됩니다.
center	query		number[]	중심점의 좌표입니다. 형식: 'lon,lat'. 사용된 프로젝션 EPSG:3857. 경도 범위: -180~180 위도 범위: -85~85. 참고: 가운데 또는 bbox는 필수 매개 변수입니다. 그들은 상호 배타적입니다.
height	query		integer int32	결과 이미지의 높이(픽셀)입니다. 범위는 1에서 8192까지입니다. 기본값은 512입니다. bbox와 함께 사용하면 안 됩니다.
language	query		string	검색 결과를 반환해야 하는 언어입니다. 대/소문자를 구분하지 않는 지원되는 IETF 언어 태그 중 하나여야 합니다. 특정 필드에 대해 지정된 언어의 데이터를 사용할 수 없는 경우 기본 언어가 사용됩니다. 자세한 내용은 지원되는 언어를 참조하세요.
layer	query		StaticMapLayer	요청된 지도 계층입니다. 레이어가 레이블 또는 하이브리드로 설정된 경우 형식은 png여야 합니다.
path	query		string[]	경로 스타일 및 위치입니다. 선택적으로 이미지에 선, 다각형 또는 원을 추가하려면 이 매개 변수를 사용합니다. 경로 스타일은 선과 채우기의 모양을 설명합니다. (파이프 및 문장 부호와 같은 예약된 문자가 포함되므로 이 매개 변수의 URL 인코딩 값을 올바르게 지정해야 합니다.) 경로 매개 변수는 S1부터 Azure Maps 계정 SKU에서 지원됩니다. 경로 매개 변수의 여러 인스턴스를 사용하면 해당 스타일을 사용하여 여러 기하 도형을 지정할 수 있습니다. 요청당 매개 변수 수는 10개로 제한되며 위치 수는 경로당 100개로 제한됩니다. 기본 스타일을 사용하여 반지름이 100미터이고 중심점이 위도 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(고유 데이터 ID)를 반환합니다. 업로드된 GeoJSON 문서의 점 기하 도형을 경로 위치로 사용하려면 path 매개 변수의 locations 섹션에서 UDID를 지정합니다. 예를 들면 다음과 같습니다. path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713 Data Storage의 경로 위치를 path 매개 변수에 지정된 위치와 혼합할 수 없습니다. 스타일 한정자 요약 한정자 Description 범위 Lc 선 색 000000에서 FFFFFF로 fc 채우기 색 000000에서 FFFFFF로 la 선 알파(불투명도) 0~1 fa 알파 채우기(불투명도) 0~1 Lw 선 두께 0보다 큼 Ra 원 반경(미터) 0보다 큼
pins	query		string[]	압정 스타일 및 인스턴스. 필요에 따라 이미지에 압정을 추가하려면 이 매개 변수를 사용합니다. 압정 스타일은 압정의 모양을 설명하고 인스턴스는 각 핀에 대한 압정 및 선택적 레이블의 좌표를 지정합니다. (파이프 및 문장 부호와 같은 예약된 문자가 포함되므로 이 매개 변수의 URL 인코딩 값을 올바르게 지정해야 합니다.) Azure Maps 계정 S0 SKU는 pins 매개 변수의 단일 instance 지원합니다. 다른 SKU를 사용하면 핀 매개 변수의 여러 인스턴스가 여러 핀 스타일을 지정할 수 있습니다. 기본 제공 압정 스타일을 사용하여 위도 45°N 및 경도 122°W에서 압정을 렌더링하려면 querystring 매개 변수를 추가합니다. pins=default||-122 45 경도는 위도 앞에 옵니다. URL 인코딩 후 다음과 같이 표시됩니다. pins=default%7C%7C-122+45 여기에 있는 모든 예제는 명확성을 위해 URL 인코딩이 없는 pins 매개 변수를 보여 줍니다. 여러 위치에서 핀을 렌더링하려면 각 위치를 파이프 문자로 구분합니다. 예를 들어 다음과 같은 코드를 사용합니다. 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 서비스는 pins 매개 변수의 데이터를 참조하는 데 사용할 수 있는 UDID(고유 데이터 ID)를 반환합니다. 업로드된 GeoJSON 문서의 점 기하 도형을 핀 위치로 사용하려면 pins 매개 변수의 위치 섹션에서 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 스타일 한정자 요약 한정자 Description 범위 al 알파(불투명도) 0~1 an 고정 앵커 * co 고정 색 000000에서 FFFFFF로 la 레이블 앵커 * Lc 레이블 색상 000000에서 FFFFFF로 ls 레이블 크기 0보다 큼 ro 회전 -360~360 사우스 캐롤라이나 확장 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	결과 이미지의 너비(픽셀)입니다. 범위는 1에서 8192까지입니다. 기본값은 512입니다. bbox와 함께 사용하면 안 됩니다.
zoom	query		integer int32	맵의 원하는 확대/축소 수준입니다. 확대/축소 값은 0-20(포함) 범위에 있어야 합니다. 기본값은 12입니다. 자세한 내용은 확대/축소 수준 및 타일 그리드 를 참조하세요.

요청 헤더

Name	필수	형식	Description
x-ms-client-id		string	Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps Microsoft Entra ID 보안을 사용하려면 다음 문서를 참조하세요.

응답

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 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 기본 제공 역할 또는 REST API를 Azure Maps 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.

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

참고

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

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

• Microsoft ID 플랫폼 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.

형식: 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에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정의 master 키로 사용할 수 있습니다.

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

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

SAS Token

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

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

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

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

예제

Successful Static Image Request

샘플 요청

HTTP

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

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

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

LocalizedMapView

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

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

Name	형식	Description
AE	string	아랍에미리트(아랍어 보기)
AR	string	아르헨티나(아르헨티나어 보기)
Auto	string	요청의 IP 주소를 기준으로 지도 데이터를 반환합니다.
BH	string	바레인(아랍어 보기)
IN	string	인도(인도어 보기)
IQ	string	이라크(아랍어 보기)
JO	string	요르단(아랍어 보기)
KW	string	쿠웨이트(아랍어 보기)
LB	string	레바논(아랍어 보기)
MA	string	모로코(모로코어 보기)
OM	string	오만(아랍어 보기)
PK	string	파키스탄(파키스탄어 보기)
PS	string	팔레스타인 자치 정부(아랍어 보기)
QA	string	카타르(아랍어 보기)
SA	string	사우디아라비아(아랍어 보기)
SY	string	시리아(아랍어 보기)
Unified	string	통합 보기(기타)
YE	string	예멘(아랍어 보기)

MapImageStyle

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

Name	형식	Description
dark	string	Azure Maps 기본 스타일의 어두운 회색 버전
main	string	Azure Maps 기본 스타일

RasterTileFormat

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

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

StaticMapLayer

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

Name	형식	Description
basic	string	다각형, 테두리, 도로 및 레이블을 포함한 모든 지도 기능을 포함하는 이미지를 반환합니다.
hybrid	string	테두리, 도로 및 레이블이 포함된 이미지를 반환하고 다른 타일(예: 위성 이미지)에 오버레이하여 하이브리드 타일을 생성할 수 있습니다.
labels	string	지도의 레이블 정보만의 이미지를 반환합니다.