Render - Get Map Tile
을 사용하여 벡터 또는 래스터 형식의 지도 타일을 요청합니다.
**
Get Map Tiles
API는 사용자가 벡터 또는 래스터 형식으로 맵 타일을 요청할 수 있는 HTTP GET
요청으로, 일반적으로 지도 컨트롤 또는 SDK에 통합됩니다. 요청될 수 있는 몇 가지 예제 타일은 Azure Maps 도로 타일, 실시간 Weather Radar 타일 또는 Azure Maps Creator를 사용하여 만든 지도 타일입니다. 기본적으로 Azure Maps 웹 맵 컨트롤(웹 SDK) 및 Android SDK에 벡터 타일을 사용합니다.
GET https://atlas.microsoft.com/map/tile?api-version=2022-08-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}
GET https://atlas.microsoft.com/map/tile?api-version=2022-08-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}&timeStamp={timeStamp}&tileSize={tileSize}&language={language}&view={view}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호. 현재 버전은 2022-08-01입니다. |
tileset
|
query | True |
타일 세트는 미리 설정된 확대/축소 수준에서 사각형 타일의 균일한 그리드로 분할된 래스터 또는 벡터 데이터의 컬렉션입니다. 모든 타일 세트에는 요청을 할 때 사용할 tilesetId 가 있습니다. Azure Maps Creator를 사용하여 만든 타일 세트에 대한 tilesetId는 타일 집합 만들기 API를 통해 생성됩니다. Azure Maps 제공하는 즉시 사용할 수 있는 타일 세트는 다음과 같습니다. 예를 들어 microsoft.base입니다. |
|
x
|
query | True |
integer int32 |
확대/축소 그리드에 있는 타일의 X 좌표입니다. 값은 [0, 2 자세한 내용은 확대/축소 수준 및 타일 그리드 를 참조하세요. |
y
|
query | True |
integer int32 |
확대/축소 그리드에서 타일의 Y 좌표입니다. 값은 [0, 2 자세한 내용은 확대/축소 수준 및 타일 그리드 를 참조하세요. |
zoom
|
query | True |
integer int32 |
원하는 타일의 확대/축소 수준입니다. 자세한 내용은 확대/축소 수준 및 타일 그리드 를 참조하세요. |
language
|
query |
string |
검색 결과를 반환해야 하는 언어입니다. 대/소문자를 구분하지 않는 지원되는 IETF 언어 태그 중 하나여야 합니다. 특정 필드에 대해 지정된 언어의 데이터를 사용할 수 없는 경우 기본 언어가 사용됩니다. 자세한 내용은 지원되는 언어를 참조하세요. |
|
tile
|
query |
반환된 맵 타일의 크기(픽셀)입니다. |
||
time
|
query |
string date-time |
요청된 타일의 원하는 날짜 및 시간입니다. 이 매개 변수는 ISO 8601에 정의된 표준 날짜-시간 형식(예: 2019-11-14T16:03:00-08:00)으로 지정해야 합니다. 이 매개 변수는 tilesetId 매개 변수가 아래 값 중 하나로 설정된 경우에만 지원됩니다.
|
|
view
|
query |
View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 이러한 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps View 매개 변수는 지도, 이미지 및 기타 데이터 및 Azure Maps 통해 액세스할 수 있는 권한이 있는 타사 콘텐츠가 제공되는 국가/지역의 매핑과 관련된 법률을 포함하여 해당 법률을 준수하는 데 사용해야 합니다. 예: view=IN. 자세한 내용은 지원되는 보기를 참조하고 사용 가능한 보기를 확인하세요. |
요청 헤더
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 |
성공적인 API 호출에서 반환된 타일입니다. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Headers Content-Type: string |
Other Status Codes |
예기치 않은 오류가 발생했습니다. 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 리소스를 나타내기 위해 헤더를 사용해야 합니다. 이는 지도 관리 API에서 가져올 수 있습니다.
Authorization URL
은 Azure 퍼블릭 클라우드 instance 관련됩니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다.
* Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다.
* Azure Maps Web SDK를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- Microsoft ID 플랫폼 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
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에 액세스할 수 있는 권한이 부여됩니다. 즉, 이러한 키는 현재 발급된 계정에 대한 master 키로 처리될 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 이 키를 안전하게 저장할 수 있는 Azure Maps REST API의 서버-서버 액세스를 사용하는 것이 좋습니다.
Type:
apiKey
In:
header
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.
이 토큰을 사용하면 모든 애플리케이션이 특정 토큰에 사용할 만료, 속도 및 지역에 대한 Azure 역할 기반 액세스 제어 및 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.
Type:
apiKey
In:
header
예제
Successful Tile Request
Sample Request
GET https://atlas.microsoft.com/map/tile?api-version=2022-08-01&tilesetId=microsoft.base&zoom=6&x=10&y=22
Sample Response
Content-Type: application/vnd.mapbox-vector-tile
"binary image string"
정의
Name | Description |
---|---|
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Localized |
View 매개 변수("사용자 지역" 매개 변수라고도 함)를 사용하면 지정학적으로 분쟁이 있는 지역의 특정 국가/지역에 대한 올바른 맵을 표시할 수 있습니다. 국가/지역에 따라 해당 지역에 대한 보기가 다르며 View 매개 변수를 사용하면 애플리케이션이 서비스할 국가/지역에 필요한 보기를 애플리케이션이 준수할 수 있습니다. 기본적으로 View 매개 변수는 요청에 정의하지 않은 경우에도 "Unified"로 설정됩니다. 사용자의 위치를 확인한 다음 해당 위치에 대해 View 매개 변수를 올바르게 설정하는 것은 사용자의 책임입니다. 또는 요청의 IP 주소를 기반으로 맵 데이터를 반환하는 'View=Auto'를 설정하는 옵션이 있습니다. Azure Maps View 매개 변수는 지도, 이미지 및 기타 데이터 및 Azure Maps 통해 액세스할 권한이 있는 타사 콘텐츠가 제공되는 국가/지역의 매핑과 관련된 법률을 포함하여 관련 법률을 준수하는 데 사용해야 합니다. 예: view=IN. 자세한 내용은 지원되는 보기를 참조하고 사용 가능한 보기를 확인하세요. |
Map |
반환된 맵 타일의 크기(픽셀)입니다. |
TilesetID |
타일 세트는 미리 설정된 확대/축소 수준에서 사각형 타일의 균일한 그리드로 분할된 래스터 또는 벡터 데이터의 컬렉션입니다. 모든 타일 세트에는 요청을 할 때 사용할 tilesetId 가 있습니다. Azure Maps Creator를 사용하여 만든 타일 세트에 대한 tilesetId는 Tileset Create API를 통해 생성됩니다. Azure Maps 제공된 즉시 사용할 수 있는 타일 세트는 아래에 나열되어 있습니다. 예를 들어 microsoft.base입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
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 |
예멘(아랍어 보기) |
MapTileSize
반환된 맵 타일의 크기(픽셀)입니다.
Name | 형식 | Description |
---|---|---|
256 |
string |
256x256픽셀 타일을 반환합니다. |
512 |
string |
512x512 픽셀 타일을 반환합니다. |
TilesetID
타일 세트는 미리 설정된 확대/축소 수준에서 사각형 타일의 균일한 그리드로 분할된 래스터 또는 벡터 데이터의 컬렉션입니다. 모든 타일 세트에는 요청을 할 때 사용할 tilesetId 가 있습니다. Azure Maps Creator를 사용하여 만든 타일 세트에 대한 tilesetId는 Tileset Create API를 통해 생성됩니다. Azure Maps 제공된 즉시 사용할 수 있는 타일 세트는 아래에 나열되어 있습니다. 예를 들어 microsoft.base입니다.
Name | 형식 | Description |
---|---|---|
microsoft.base |
string |
기본 맵은 도로, 자연 및 인공 기능을 벡터 타일의 해당 기능에 대한 레이블과 함께 표시하는 표준 맵입니다. 확대/축소 수준 0~22를 지원합니다. 형식: 벡터(pbf). |
microsoft.base.darkgrey |
string |
어두운 회색 스타일의 모든 레이어. 확대/축소 수준 0~22를 지원합니다. 형식: 래스터(png). |
microsoft.base.hybrid |
string |
도로, 경계 및 레이블 데이터를 벡터 타일에 표시합니다. 확대/축소 수준 0~22를 지원합니다. 형식: 벡터(pbf). |
microsoft.base.hybrid.darkgrey |
string |
어두운 회색 스타일의 도로, 경계 및 레이블 데이터입니다. 확대/축소 수준 0~22를 지원합니다. 형식: 래스터(png). |
microsoft.base.hybrid.road |
string |
기본 스타일의 도로, 경계 및 레이블 데이터입니다. 확대/축소 수준 0~22를 지원합니다. 형식: 래스터(png). |
microsoft.base.labels |
string |
도로, 자연 및 인공 기능에 대한 레이블을 벡터 타일에 표시합니다. 확대/축소 수준 0~22를 지원합니다. 형식: 벡터(pbf). |
microsoft.base.labels.darkgrey |
string |
진한 회색 스타일로 데이터에 레이블을 지정합니다. 확대/축소 수준 0~22를 지원합니다. 형식: 래스터(png). |
microsoft.base.labels.road |
string |
기본 스타일의 데이터에 레이블을 지정합니다. 확대/축소 수준 0~22를 지원합니다. 형식: 래스터(png). |
microsoft.base.road |
string |
기본 스타일을 사용하는 모든 레이어. 확대/축소 수준 0~22를 지원합니다. 형식: 래스터(png). |
microsoft.imagery |
string |
위성 및 항공 이미지의 조합입니다. S1 가격 책정 SKU에서만 사용할 수 있습니다. 확대/축소 수준 1~19를 지원합니다. 형식: 래스터(jpeg). |
microsoft.terra.main |
string |
음영 처리된 릴리프 및 테라 레이어. 확대/축소 수준 0~6을 지원합니다. 형식: 래스터(png). |
microsoft.traffic.absolute |
string |
벡터의 절대 트래픽 타일 |
microsoft.traffic.absolute.main |
string |
기본 스타일에서 래스터의 절대 트래픽 타일입니다. |
microsoft.traffic.delay |
string |
벡터의 트래픽 타일 |
microsoft.traffic.delay.main |
string |
기본 스타일의 래스터의 트래픽 타일 |
microsoft.traffic.incident |
string |
벡터의 인시던트 타일 |
microsoft.traffic.reduced.main |
string |
기본 스타일의 래스터에서 트래픽 타일 감소 |
microsoft.traffic.relative |
string |
벡터의 상대 트래픽 타일 |
microsoft.traffic.relative.dark |
string |
어두운 스타일의 래스터에 있는 상대 트래픽 타일입니다. |
microsoft.traffic.relative.main |
string |
기본 스타일의 래스터에 있는 상대 트래픽 타일입니다. |
microsoft.weather.infrared.main |
string |
날씨 적외선 타일. 최신 적외선 위성 이미지는 온도에 따라 구름을 보여줍니다. Azure Maps 날씨 서비스에 대한 적용 범위 정보를 참조하세요. 반환된 위성 데이터에 대한 자세한 내용은 날씨 개념을 참조하세요. 확대/축소 수준 0~15를 지원합니다. 형식: 래스터(png). |
microsoft.weather.radar.main |
string |
날씨 레이더 타일. 비, 눈, 얼음 및 혼합 조건의 영역을 포함한 최신 날씨 레이더 이미지. Azure Maps 날씨 서비스에 대한 적용 범위 정보를 참조하세요. 레이더 데이터에 대한 자세한 내용은 날씨 개념을 참조하세요. 확대/축소 수준 0~15를 지원합니다. 형식: 래스터(png). |