Render - Get Map Tileset

타일 세트에 대한 메타데이터를 가져오는 데 사용합니다.
지도 타일 세트 가져오기 API를 사용하면 사용자가 타일 세트에 대한 메타데이터를 요청할 수 있습니다.

GET {endpoint}/map/tileset?api-version=2024-04-01&tilesetId={tilesetId}

URI 매개 변수

요청 헤더

응답

보안

AadToken

이들은 Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 접근 제어와 결합하면 Azure Maps REST API 접근을 제어하는 데 사용할 수 있습니다. Azure 역할 기반 접근 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 접근 권한을 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 내장된 역할이나 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 Azure Maps REST API에 대한 접근 권한을 부여받을 수 있습니다.\n\n시나리오를 구현하려면 authentication concepts를 참고하는 것을 권장합니다. 요약하자면, 이 보안 정의는 특정 API와 범위에 대한 접근 제어가 가능한 객체를 통해 애플리케이션을 모델링하는 솔루션을 제공합니다.\n\n#### 주석\n* 이 보안 정의 요구 애플리케이션이 요청하는 Azure Maps 리소스를 나타내기 위해 x-ms-client-id 헤더를 사용하는 것입니다. 이는 Maps 관리 API에서 얻을 수 있습니다.\n* \nAuthorization URL은 Azure 퍼블릭 클라우드 인스턴스에만 특화된 것입니다. 소버린 클라우드는 고유한 권한 부여 URL과 Microsoft Entra ID 구성을 가지고 있습니다. \n* \nAzure 역할 기반 접근 제어는 Azure 관리 평면에서 Azure 포털, PowerShell, CLI, Azure SDK 또는 REST API를 통해 구성됩니다.\n* Azure Maps Web SDK는 다양한 사용 사례에 맞는 애플리케이션 구성을 설정할 수 있게 해줍니다.\n* Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

subscription-key

이 키는 Azure 포털에서 Create a Azure Maps account 또는 PowerShell, CLI, Azure SDK, REST API를 사용할 때 제공되는 공유 키입니다.\n\n 이 키로 모든 애플리케이션이 모든 REST API에 접근할 수 있습니다. 즉, 이 키는 발급된 계좌의 마스터 키로 사용할 수 있습니다.\n\n 공개된 애플리케이션의 경우, confidential client applications 방식을 사용하여 REST API에 Azure Maps접근하여 키를 안전하게 저장할 수 있도록 하는 것을 권장합니다.

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

SAS Token

이 토큰은 Azure Maps 리소스의 List SAS 연산에서 Azure 포털, PowerShell, CLI, Azure SDK, REST API를 통해 Azure 관리 플레인을 통해 생성됩니다.\n\n 이 토큰을 사용하면 모든 애플리케이션이 Azure로 접근할 권한이 부여됩니다 역할 기반 접근 제어 및 특정 토큰의 만료일, 사용 속도, 사용 영역에 대한 세밀한 제어를 제공합니다. 즉, SAS 토큰은 공유 키보다 더 안전한 방식으로 애플리케이션이 접근 권한을 제어할 수 있도록 하는 데 사용될 수 있습니다.\n\n 공개적으로 노출된 애플리케이션의 경우, Map 계정 리소스 에서 허용된 출처 목록을 구체적으로 설정하여 렌더링 남용을 제한하고 SAS 토큰을 정기적으로 갱신할 것을 권장합니다.

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

예제

Successful Tileset Request

GET {endpoint}/map/tileset?api-version=2024-04-01&tilesetId=microsoft.base

{
  "attribution": "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>",
  "bounds": [
    -180,
    -90,
    180,
    90
  ],
  "maxzoom": 22,
  "minzoom": 0,
  "scheme": "xyz",
  "tilejson": "2.2.0",
  "tiles": [
    "https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}"
  ],
  "version": "1.0.0"
}

정의

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

모든 Azure Resource Manager API에서 실패한 작업에 대한 오류 세부 정보를 반환하는 공통 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

MapTileset

TileJSON 형식의 타일 세트에 대한 메타데이터입니다.

TilesetID

타일 세트는 미리 설정된 확대/축소 수준에서 사각형 타일의 균일한 그리드로 분할된 래스터 또는 벡터 데이터의 컬렉션입니다. 모든 타일 세트에는 요청을 할 때 사용할 tilesetId 있습니다. Azure Maps에서 제공하는 즉시 사용 가능한 타일셋은 아래에 나열되어 있습니다. 예를 들어 microsoft.base입니다.