Dataset - Get

적용 대상: 가격 책정 계층을 참조하세요.

Creator를 사용하면 Azure Maps API 및 SDK를 사용하여 프라이빗 실내 지도 데이터를 기반으로 애플리케이션을 개발할 수 있습니다. 문서에서는 Azure Maps Creator에 적용되는 개념과 도구를 소개합니다.

이 API를 사용하면 호출자가 이전에 성공적으로 만든 데이터 세트를 가져올 수 있습니다.

세부 정보 가져오기 요청 제출

이전에 만든 데이터 세트에 대한 세부 정보를 얻으려면 경로에서 요청을 datasetId 실행 GET 합니다.

세부 정보 응답 가져오기

세부 정보 가져오기 API는 데이터 세트에 대한 세부 정보를 형식으로 json 반환합니다. 응답에는 다음 필드가 포함됩니다(null이 아니거나 비어 있지 않은 경우).

created - 데이터 세트가 만들어진 타임스탬프입니다. datasetId - 데이터 세트의 ID입니다. description - 데이터 세트에 대한 설명입니다. datasetSources - 만들기 요청이 실행되었을 때 사용된 원본 데이터입니다. ontology - 입력 데이터에 대한 변환 서비스에서 사용된 원본 온톨로지 입니다.

만들기 datasetSources 요청이 실행되었을 때 사용된 원본 데이터에 대해 설명하고 다음 요소를 포함합니다(null 또는 비어 있지 않은 경우).

conversionIds - (제공되지 않은 경우 null)의 conversionId 목록입니다. appendDatasetId - datasetId 추가 작업에 사용된 항목입니다(사용되지 않은 경우 null). featureCounts - 데이터 세트의 각 기능 유형에 대한 개수입니다.

다음은 데이터 세트 리소스, datasetId, datasetSourcesdescriptionontology 데이터 세트 리소스를 반환하는 timestamp샘플 응답입니다.

{
   "timestamp": "2020-01-01T22:50:48.123Z",
   "datasetId": "f6495f62-94f8-0ec2-c252-45626f82fcb2",
   "description": "Some description or comment for the dataset.",
   "datasetSources": {
     "conversionIds": [
       "15d21452-c9bb-27b6-5e79-743ca5c3205d"
     ],
   },
   "ontology": "facility-2.0",
   "featureCounts": {
     "directoryInfo": 2,
     "category": 10,
     "facility": 1,
     "level": 3,
     "unit": 183,
     "zone": 3,
     "verticalPenetration": 6,
     "opening": 48,
     "areaElement": 108
   }
 }
GET https://{geography}.atlas.microsoft.com/datasets/{datasetId}?api-version=2.0

URI 매개 변수

Name In Required Type Description
datasetId
path True
  • string

쿼리할 데이터 세트의 식별자입니다.

geography
path True
  • string

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

api-version
query True
  • string

Azure Maps API의 버전 번호.

요청 헤더

Name Required Type Description
x-ms-client-id
  • string

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

응답

Name Type Description
200 OK

데이터 세트 가져오기 요청이 성공적으로 완료되었습니다.

Other Status Codes

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

보안

AADToken

Azure Active Directory OAuth2 흐름입니다. Azure 역할 기반 액세스 제어와 쌍을 이루는 경우 AZURE MAPS REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 기본 제공 역할 또는 REST API를 Azure Maps 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.

시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.

참고

  • 이 보안 정의에서는 애플리케이션이 액세스를 요청하는 Azure Maps 리소스를 나타내기 위해 헤더를 사용해야 x-ms-client-id 합니다. 이는 Maps 관리 API에서 가져올 수 있습니다.

Azure Authorization URL 퍼블릭 클라우드 인스턴스에만 해당됩니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Azure Active Directory 구성이 있습니다. * Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다. * Azure Maps 웹 SDK를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 허용합니다.

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

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 Azure Maps 계정을 만들거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.

이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정에서 마스터 키로 사용할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 키를 안전하게 저장할 수 있도록 Azure Maps REST API에 액세스하는 것이 좋습니다.

Type: apiKey
In: query

SAS Token

공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.

이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어 및 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 안전한 방식으로 액세스를 제어할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 지도 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.

Type: apiKey
In: header

예제

Get details for a previously created dataset

Sample Request

GET https://us.atlas.microsoft.com/datasets/[datasetId]?api-version=2.0

Sample Response

Location: https://us.atlas.microsoft.com/dataset/{datasetId}?api-version=1.0
Access-Control-Expose-Headers: Resource-Location
{
  "created": "2021-05-21T01:02:03.456Z",
  "datasetId": "[datasetId]",
  "description": "Some description or comment about the dataset",
  "datasetSources": {
    "conversionIds": [
      "15d21452-c9bb-27b6-5e79-743ca5c3205d",
      "c39de51c-b4f5-4733-aeeb-d8cb6f8b2f1d"
    ],
    "appendDatasetId": "6a49a490-1d9c-4f05-bf1e-51998fbc4733"
  },
  "featureCounts": {
    "directoryInfo": 2,
    "category": 10,
    "facility": 1,
    "level": 3,
    "unit": 183,
    "zone": 3,
    "verticalPenetration": 6,
    "opening": 48,
    "areaElement": 108
  },
  "ontology": "facility-2.0"
}

정의

Dataset

데이터 세트에 대한 세부 정보입니다.

DatasetSources

데이터 세트에 대한 만들기 요청의 세부 정보에 대한 정보입니다.

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

Dataset

데이터 세트에 대한 세부 정보입니다.

Name Type Description
created
  • string

데이터 세트에 대해 만든 타임스탬프입니다.

datasetId
  • string

데이터 세트의 ID입니다.

datasetSources

데이터 세트에 대한 만들기 요청의 세부 정보에 대한 정보입니다.

description
  • string

데이터 세트에 대한 설명입니다.

featureCounts
  • object

이 기능은 데이터 세트에 대한 개수입니다.

ontology
  • string

이 데이터 세트의 온톨로지 버전입니다.

DatasetSources

데이터 세트에 대한 만들기 요청의 세부 정보에 대한 정보입니다.

Name Type Description
appendDatasetId
  • string

현재 데이터 세트를 만들기 위해 추가된 데이터 세트입니다.

conversionIds
  • string[]

데이터 세트를 만드는 데 사용된 목록 conversionId 입니다.

ErrorAdditionalInfo

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

Name Type Description
info
  • object

추가 정보입니다.

type
  • string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name Type Description
additionalInfo

오류 추가 정보입니다.

code
  • string

오류 코드입니다.

details

오류 세부 정보입니다.

message
  • string

오류 메시지입니다.

target
  • string

오류 대상입니다.

ErrorResponse

오류 응답

Name Type Description
error

오류 개체입니다.