다음을 통해 공유


Tileset - Validate Configuration

를 사용하여 타일 세트 구성의 유효성을 검사합니다.

구성 요청 유효성 검사 제출

Validate Configuration API는 제공datasetId된 를 기반으로 지정된 타일 세트 구성의 유효성을 검사하는 데 사용되는 HTTP POST 요청입니다.

POST https://{geography}.atlas.microsoft.com/tilesets:validateConfiguration?api-version=2023-03-01-preview&datasetId={datasetId}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
geography
path True

string

이 매개 변수는 Azure Maps Creator 리소스가 있는 위치를 지정합니다. 유효한 값은 우리와 eu입니다.

api-version
query True

string

Azure Maps API의 버전 번호.

datasetId
query True

string

타일 세트가 API를 만들어 타일을 생성하는 기능을 검색하는 데 사용하는 고유 datasetId 입니다. 는 datasetId 성공적인 데이터 세트 만들기 API 호출에서 가져와야 합니다.

요청 헤더

Name 필수 형식 Description
x-ms-client-id

string

Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정의 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps Microsoft Entra ID 보안을 사용하려면 다음 문서를 참조하세요.

요청 본문

Name 필수 형식 Description
layers True

<string,  LayerObject>

레이어의 이름 및 해당 구성 옵션입니다. 구성 계층 개체에는 타일 계층의 이름과 해당 구성을 연결한 키-값 쌍이 포함되어 있습니다. 각 키-값 쌍에 대해 키는 계층의 이름이고 값은 계층에 대한 구성 및 옵션을 포함하는 LayerObject입니다. 각 계층에는 이름이 있어야 합니다. 최종 타일 집합의 데이터 계층에 대한 고유 식별자입니다. 모든 타일 집합에서 각 레이어 이름은 고유해야 합니다. 레이어 이름은 밑줄(_) 및 영숫자 문자만 있는 문자열이어야 합니다. 각 레이어 이름에 해당하는 LayerObject는 해당 벡터 타일 계층을 만드는 방법을 설명합니다. 기능 데이터를 검색할 기능 클래스, 확대/축소 수준을 통한 데이터의 정밀도, 기능을 변환하고 타일로 렌더링하는 방법을 지정합니다.

version True

integer

타일 세트 구성에서 사용하는 Azure Maps Tiling 서비스 구성 참조의 버전입니다. 현재 버전 1만 허용됩니다. 현재 버전 또는 이전 버전의 다른 버전을 사용하면 오류가 발생합니다.

응답

Name 형식 Description
200 OK

TilesetConfigurationValidationResult

타일 세트 구성 요청이 성공적으로 완료되었는지 확인합니다. 응답 본문에는 유효성 검사 결과가 포함됩니다.

Other Status Codes

ErrorResponse

예기치 않은 오류가 발생했습니다.

보안

AADToken

Azure Active Directory OAuth2 흐름입니다. 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 및 Azure Active Directory 구성이 있습니다. * Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다. * Azure Maps Web SDK를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.

  • 현재 Azure Active Directory v1.0 또는 v2.0 은 회사, 학교 및 게스트를 지원하지만 개인 계정은 지원하지 않습니다.

형식: 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 토큰을 갱신하도록 맵 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.

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

예제

Validates the correctness of a tileset configuration

샘플 요청

POST https://us.atlas.microsoft.com/tilesets:validateConfiguration?api-version=2023-03-01-preview&datasetId=[datasetId]

{
  "version": 1,
  "layers": {
    "Indoor test": {
      "minZoom": 10,
      "maxZoom": 18,
      "features": {
        "featureClasses": [
          "unit"
        ],
        "filter": [
          "any",
          [
            "!=",
            [
              "get",
              "featureType"
            ],
            "conference"
          ],
          [
            "!=",
            [
              "get",
              "featureType"
            ],
            "restroom"
          ]
        ]
      }
    }
  }
}

샘플 응답

{
  "valid": false,
  "warnings": [],
  "errors": [
    {
      "code": "CustomLayerNameNotSupported",
      "message": "Custom layerName 'Indoor test' is not supported yet.",
      "target": "Indoor test"
    }
  ]
}

정의

Name Description
ErrorAdditionalInfo

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

ErrorCode

유효성 검사 오류 코드입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

Feature

타일 세트 구성에 대한 기능 구성입니다.

LayerObject

타일 세트 구성에 대한 계층 개체입니다.

TilesetConfiguration

타일 집합 구성 최상위 필드입니다. 타일 세트 구성은 다음 최상위 필드를 포함해야 하는 JSON 개체입니다.

TilesetConfigurationValidationResult

타일 세트 구성 유효성 검사 결과입니다.

ValidationError

타일 세트 구성 유효성 검사 오류입니다.

ValidationWarning

타일 세트 구성 유효성 검사 오류입니다.

ErrorAdditionalInfo

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

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorCode

유효성 검사 오류 코드입니다.

Name 형식 Description
CustomLayerNameNotSupported

string

사용자 지정 계층 이름은 현재 지원되지 않습니다.

CustomOntologyNotSupported

string

사용자 지정 온톨로지는 현재 지원되지 않습니다. 'Facility-2.0'은 지원되는 온톨로지입니다.

DuplicateFeatureClassFound

string

기능 클래스 이름은 고유해야 합니다.

DuplicateLayerNameFound

string

레이어 이름은 고유해야 합니다.

UndefinedFeatureClasses

string

기능 클래스는 온톨로지 정의에 정의되어야 하며 기능 클래스 이름은 대/소문자를 구분합니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

Feature

타일 세트 구성에 대한 기능 구성입니다.

Name 형식 Description
featureClasses

string[]

계층을 빌드하는 데 사용할 기능 클래스 목록입니다. 유효한 기능 클래스는 해당 온톨로지 정의에서 찾을 수 있습니다. 예를 들어 시설 온톨로지

filter

object

패턴과 일치하지 않는 기능을 제거합니다. MapLibre 필터 식을 참조하세요.

LayerObject

타일 세트 구성에 대한 계층 개체입니다.

Name 형식 Description
features

Feature

기능 클래스 및 필터를 지정합니다.

maxZoom

integer

계층을 빌드할 가장 높은 확대/축소 수준입니다.

minZoom

integer

빌드할 계층의 가장 낮은 확대/축소 수준입니다.

TilesetConfiguration

타일 집합 구성 최상위 필드입니다. 타일 세트 구성은 다음 최상위 필드를 포함해야 하는 JSON 개체입니다.

Name 형식 Description
layers

<string,  LayerObject>

레이어의 이름 및 해당 구성 옵션입니다. 구성 계층 개체에는 타일 계층의 이름과 해당 구성을 연결한 키-값 쌍이 포함되어 있습니다. 각 키-값 쌍에 대해 키는 계층의 이름이고 값은 계층에 대한 구성 및 옵션을 포함하는 LayerObject입니다. 각 계층에는 이름이 있어야 합니다. 최종 타일 집합의 데이터 계층에 대한 고유 식별자입니다. 모든 타일 집합에서 각 레이어 이름은 고유해야 합니다. 레이어 이름은 밑줄(_) 및 영숫자 문자만 있는 문자열이어야 합니다. 각 레이어 이름에 해당하는 LayerObject는 해당 벡터 타일 계층을 만드는 방법을 설명합니다. 기능 데이터를 검색할 기능 클래스, 확대/축소 수준을 통한 데이터의 정밀도, 기능을 변환하고 타일로 렌더링하는 방법을 지정합니다.

version

integer

타일 세트 구성에서 사용하는 Azure Maps Tiling 서비스 구성 참조의 버전입니다. 현재 버전 1만 허용됩니다. 현재 버전 또는 이전 버전의 다른 버전을 사용하면 오류가 발생합니다.

TilesetConfigurationValidationResult

타일 세트 구성 유효성 검사 결과입니다.

Name 형식 Description
errors

ValidationError[]

유효성 검사 오류 목록입니다.

valid

boolean

유효성 검사 결과입니다.

warnings

ValidationWarning[]

유효성 검사 경고 목록입니다.

ValidationError

타일 세트 구성 유효성 검사 오류입니다.

Name 형식 Description
code

ErrorCode

유효성 검사 오류 코드입니다.

message

string

유효성 검사 오류 메시지입니다.

target

string

유효성 검사 오류의 대상 요소입니다.

ValidationWarning

타일 세트 구성 유효성 검사 오류입니다.

Name 형식 Description
code

string

유효성 검사 경고 코드입니다.

message

string

유효성 검사 경고 메시지입니다.

target

string

유효성 검사 경고의 대상 요소입니다.