다음을 통해 공유

Render - Get Map Static Image

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

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

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

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

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

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

확대/축소 수준 최소 Lon 범위 최대 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[]

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

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

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

number[]

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

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

integer

int32

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

string

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

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

string[]

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

Path 매개 변수는 S1부터 Azure Maps 계정 SKU에서 지원됩니다. path 매개 변수의 여러 인스턴스를 사용하면 스타일을 사용하여 여러 기하 도형을 지정할 수 있습니다. 요청당 매개 변수 수는 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

스타일 한정자 요약

한정자 Description 형식 범위
lc (lc) 선 색 string 000000에서 FFFFFF로
fc 채우기 색 string 000000에서 FFFFFF로
la 선 알파(불투명도) float 0~1
fa 알파 채우기(불투명도) float 0~1
lw 선 두께 int32 (0, 50]
ra 원 반경(미터) float 0보다 큼
pins
 query

string[]

압정 스타일 및 인스턴스. 필요에 따라 이미지에 압정을 추가하려면 이 매개 변수를 사용합니다. 압정 스타일은 압정의 모양을 설명하고 인스턴스는 각 핀에 대한 압정(double) 및 선택적 레이블의 좌표를 지정합니다. (파이프 및 문장 부호와 같은 예약된 문자가 포함되므로 이 매개 변수의 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 매개 변수를 보여 줍니다.

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

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

스타일 한정자 요약

한정자 Description 형식 범위
al 알파(불투명도) float 0~1
an 고정 앵커 <int32, int32> *
co 고정 색 string 000000에서 FFFFFF로
la 레이블 앵커 <int32, int32> *
lc (lc) 레이블 색상 문자열 000000에서 FFFFFF로
ls 레이블 크기 float 0보다 큼
ro 회전 float -360~360
사우스 캐롤라이나 확장 float 0보다 큼
  • X 및 Y 좌표는 핀 이미지 또는 주위의 여백 내에 있을 수 있습니다. 여백 크기는 핀 너비와 높이의 최소값입니다.
tilesetId
 query

TilesetId

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

TrafficTilesetId

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

LocalizedMapView

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

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

integer

int32

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

integer

int32

맵의 원하는 확대/축소 수준입니다. 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 보안을 사용하려면 지침은 다음 문서를 참조하세요.
Accept

MediaType

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

응답

Name 형식 Description
200 OK

object

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

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 리소스를 나타내야 합니다. 이는 지도 관리 API에서 가져올 수 있습니다.

Authorization URL 은 Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다. * Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면 에서 구성됩니다. * Azure Maps 웹 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로 설정됩니다. 자세한 내용은 TilesetId 렌더링을 참조하세요.
TrafficTilesetId

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

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

예멘(아랍어 보기)

MediaType

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

Name 형식 Description
image/jpeg

string

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

string

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

TilesetId

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

Name 형식 Description
microsoft.base.darkgrey

string

TilesetId는 어두운 회색 스타일의 모든 레이어를 포함합니다.
microsoft.base.road

string

TilesetId에는 렌더링 기본 스타일이 있는 모든 계층이 포함됩니다.
microsoft.imagery

string

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

TrafficTilesetId

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

Name 형식 Description
microsoft.traffic.relative.main

string

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

string

기본값이며 트래픽 흐름 오버레이가 없습니다.