RenderGetMapStaticImageQueryParamProperties interface

패키지:

@azure-rest/maps-render

속성

bbox	경계 상자는 지구 사각형 영역의 네 면을 나타내는 두 위도와 두 개의 경도로 정의됩니다. 형식: 'minLon, minLat, maxLon, maxLat'(double). 참고: bbox 또는 center는 필수 매개 변수입니다. 그들은 상호 배타적입니다. bbox는 높이 또는 너비와 함께 사용하면 안 됩니다. 위도 및 Lon에 허용되는 최대 및 최소 범위는 이 페이지 맨 위에 있는 테이블의 각 확대/축소 수준에 대해 정의됩니다.
center	중심점의 좌표(double)입니다. 형식: 'lon,lat'. 경도 범위: 180까지 -180. 위도 범위: 90까지 -90. 참고: 가운데 또는 bbox는 필수 매개 변수입니다. 그들은 상호 배타적입니다.
height	결과 이미지의 높이(픽셀)입니다. 범위는 80에서 1500까지입니다. 기본값은 512입니다. bbox와 함께 사용하면 안 됩니다.
language	검색 결과를 반환해야 하는 언어입니다. 대/소문자를 구분하지 않는 지원되는 IETF 언어 태그 중 하나여야 합니다. 특정 필드에 대해 지정된 언어의 데이터를 사용할 수 없는 경우 기본 언어가 사용됩니다. 자세한 내용은 지원되는 언어 참조하세요.
path	경로 스타일 및 위치(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 스타일 한정자 요약 수식어 묘사 Type 레인지 lc 선 색 string 000000에서 FFFFFF로 fc(fc) 채우기 색 string 000000에서 FFFFFF로 라 선 알파(불투명도) float 0~1 파 알파 채우기(불투명도) float 0~1 lw 선 너비 int32 (0, 50] ra(ra) 원 반경(미터) float 0보다 큼
pins	압정 스타일 및 인스턴스. 필요에 따라 이미지에 압정을 추가하려면 이 매개 변수를 사용합니다. 압정 스타일은 압정의 모양을 설명하고 인스턴스는 각 핀에 대한 압정(이중)과 선택적 레이블의 좌표를 지정합니다. (파이프 및 문장 부호와 같은 예약된 문자가 포함되므로 이 매개 변수의 값을 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 스타일 한정자 요약 수식어 묘사 Type 레인지 알 알파(불투명도) float 0~1 은 고정 고정 <정수32, 정수32> * 공동 색 고정 string 000000에서 FFFFFF로 라 레이블 앵커 <정수32, 정수32> * lc 레이블 색 string 000000에서 FFFFFF로 ls 레이블 크기 float 0보다 큼 ro (1) 회전 float -360 ~360 사우스 캐롤라이나 저울 float 0보다 큼 X 및 Y 좌표는 핀 이미지 또는 주위의 여백 내에 있을 수 있습니다. 여백 크기는 핀 너비와 높이의 최소값입니다.
tilesetId	반환할 지도 스타일입니다. 가능한 값은 microsoft.base.road, microsoft.base.darkgrey 및 microsoft.imagery입니다. 기본값은 microsoft.base.road로 설정됩니다. 자세한 내용은 Render TilesetId참조하세요.
trafficLayer	이미지 결과에 오버레이된 트래픽 흐름이 없음을 나타내는 선택적 값입니다. 가능한 값은 microsoft.traffic.relative.main 및 none입니다. 기본값은 반환되는 트래픽 흐름을 나타내지 않음을 나타냅니다. 트래픽 관련 tilesetId가 제공되면 해당 트래픽 계층이 있는 지도 이미지를 반환합니다. 자세한 내용은 Render TilesetId참조하세요.
view	View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 이러한 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에서 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps의 View 매개 변수는 Azure Maps를 통해 액세스할 수 있는 권한이 있는 지도, 이미지 및 기타 데이터 및 타사 콘텐츠를 사용할 수 있는 국가/지역의 매핑과 관련된 법률을 포함하여 관련 법률을 준수하는 데 사용해야 합니다. 예: view=IN. 자세한 내용은 지원되는 뷰 참조하고 사용 가능한 보기를 확인하세요.
width	결과 이미지의 너비(픽셀)입니다. 범위는 80에서 2000까지입니다. 기본값은 512입니다. bbox와 함께 사용하면 안 됩니다.
zoom	맵의 원하는 확대/축소 수준입니다. tilesetId가 microsoft.base.road 또는 microsoft.base.darkgrey인 경우 확대/축소 값 범위는 0-20(포함)입니다. tilesetId가 microsoft.imagery인 경우 확대/축소 값 범위는 0-19(포함)입니다. 기본값은 12입니다. 자세한 내용은 확대/축소 수준 및 타일 그리드참조하세요.

속성 세부 정보

bbox

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

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

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

bbox?: number[]

속성 값

number[]

center

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

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

center?: number[]

속성 값

number[]

height

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

height?: number

속성 값

number

language

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

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

language?: string

속성 값

string

path

경로 스타일 및 위치(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

스타일 한정자 요약

수식어	묘사	Type	레인지
lc	선 색	string	000000에서 FFFFFF로
fc(fc)	채우기 색	string	000000에서 FFFFFF로
라	선 알파(불투명도)	float	0~1
파	알파 채우기(불투명도)	float	0~1
lw	선 너비	int32	(0, 50]
ra(ra)	원 반경(미터)	float	0보다 큼

path?: string

속성 값

string

pins

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

스타일 한정자 요약

수식어	묘사	Type	레인지
알	알파(불투명도)	float	0~1
은	고정 고정	<정수32, 정수32>	*
공동	색 고정	string	000000에서 FFFFFF로
라	레이블 앵커	<정수32, 정수32>	*
lc	레이블 색	string	000000에서 FFFFFF로
ls	레이블 크기	float	0보다 큼
ro (1)	회전	float	-360 ~360
사우스 캐롤라이나	저울	float	0보다 큼

• X 및 Y 좌표는 핀 이미지 또는 주위의 여백 내에 있을 수 있습니다. 여백 크기는 핀 너비와 높이의 최소값입니다.

pins?: string

속성 값

string

tilesetId

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

tilesetId?: "microsoft.base" | "microsoft.base.labels" | "microsoft.base.hybrid" | "microsoft.terra.main" | "microsoft.base.road" | "microsoft.base.darkgrey" | "microsoft.base.labels.road" | "microsoft.base.labels.darkgrey" | "microsoft.base.hybrid.road" | "microsoft.base.hybrid.darkgrey" | "microsoft.imagery" | "microsoft.weather.radar.main" | "microsoft.weather.infrared.main" | "microsoft.traffic.absolute" | "microsoft.traffic.absolute.main" | "microsoft.traffic.relative" | "microsoft.traffic.relative.main" | "microsoft.traffic.relative.dark" | "microsoft.traffic.delay" | "microsoft.traffic.delay.main" | "microsoft.traffic.reduced.main" | "microsoft.traffic.incident"

속성 값

"microsoft.base" | "microsoft.base.labels" | "microsoft.base.hybrid" | "microsoft.terra.main" | "microsoft.base.road" | "microsoft.base.darkgrey" | "microsoft.base.labels.road" | "microsoft.base.labels.darkgrey" | "microsoft.base.hybrid.road" | "microsoft.base.hybrid.darkgrey" | "microsoft.imagery" | "microsoft.weather.radar.main" | "microsoft.weather.infrared.main" | "microsoft.traffic.absolute" | "microsoft.traffic.absolute.main" | "microsoft.traffic.relative" | "microsoft.traffic.relative.main" | "microsoft.traffic.relative.dark" | "microsoft.traffic.delay" | "microsoft.traffic.delay.main" | "microsoft.traffic.reduced.main" | "microsoft.traffic.incident"

trafficLayer

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

trafficLayer?: "microsoft.traffic.relative.main" | "none"

속성 값

"microsoft.traffic.relative.main" | "none"

view

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

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

view?: "AE" | "AR" | "BH" | "IN" | "IQ" | "JO" | "KW" | "LB" | "MA" | "OM" | "PK" | "PS" | "QA" | "SA" | "SY" | "YE" | "Auto" | "Unified"

속성 값

"AE" | "AR" | "BH" | "IN" | "IQ" | "JO" | "KW" | "LB" | "MA" | "OM" | "PK" | "PS" | "QA" | "SA" | "SY" | "YE" | "Auto" | "Unified"

width

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

width?: number

속성 값

number

zoom

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

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

zoom?: number

속성 값

number