Creator와 함께 Azure Maps 그리기 오류 시각화 도우미 사용

그리기 오류 시각화 도우미는 변환 프로세스 중에 감지된 그리기 패키지 경고 및 오류를 표시하는 독립 실행형 웹 애플리케이션입니다. 오류 시각화 도우미 웹 애플리케이션은 인터넷에 연결하지 않고 사용할 수 있는 정적 페이지로 구성됩니다. 오류 시각화 도우미를 사용하여 그리기 패키지 요구 사항에 따라 오류 및 경고를 해결할 수 있습니다. Azure Maps 변환 API는 오류가 감지된 경우에만 오류 시각화 도우미에 대한 링크가 있는 응답을 반환합니다.

필수 조건

이 자습서에서는 Postman 애플리케이션을 사용하지만, 다른 API 개발 환경을 선택해도 됩니다.

다운로드

  1. 데이터 레지스트리를 만드는 방법 문서에 설명된 단계에 따라 그리기 패키지를 Azure Storage 계정에 업로드한 다음, Azure Maps 계정에 등록합니다.

    Important

    고유 식별자(udid) 값이 필요하므로 기록해 둡니다. udid는 소스 코드 및 HTTP 요청에서 Azure Storage 계정에 업로드한 그리기 패키지를 참조하는 방법입니다.

  2. 이제 그리기 패키지가 업로드되었으므로 업로드된 패키지에 대해 udid를 사용하여 패키지를 지도 데이터로 변환합니다. 패키지를 변환하는 자세한 방법은 그리기 패키지 변환을 참조하세요.

    참고 항목

    변환 프로세스가 성공하면 오류 시각화 도우미 도구에 대한 링크가 수신되지 않습니다.

  3. Postman 애플리케이션의 응답 헤더 탭 아래에서 변환 API가 반환한 diagnosticPackageLocation 속성을 찾습니다. 다음 JSON과 유사한 응답이 표시됩니다.

    {
        "operationId": "77dc9262-d3b8-4e32-b65d-74d785b53504",
        "created": "2020-04-22T19:39:54.9518496+00:00",
        "status": "Failed",
        "properties": {
            "diagnosticPackageLocation": "https://us.atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=2.0"
        }
    }
    
  4. diagnosticPackageLocation URL에 대한 HTTP-GET 요청을 만들어 그리기 패키지 오류 시각화 도우미를 다운로드합니다.

설정

diagnosticPackageLocation 링크에서 다운로드한 압축 패키지에는 다음 두 파일이 포함됩니다.

  • VisualizationTool.zip: 그리기 오류 시각화 도우미의 소스 코드, 미디어 및 웹 페이지가 포함되어 있습니다.
  • ConversionWarningsAndErrors.json: 그리기 오류 시각화 도우미에서 사용하는 경고, 오류 및 기타 세부 정보의 서식이 지정된 목록을 포함합니다.

VisualizationTool.zip 폴더의 압축을 풉니다. 여기에는 다음 항목이 포함됩니다.

  • assets 폴더: 이미지 및 미디어 파일 포함
  • static 폴더: 소스 코드
  • index.html 파일: 웹 애플리케이션

아래 브라우저 중 하나의 해당 버전 번호를 사용하여 index.html 파일을 엽니다. 버전이 나열된 버전과 동일하게 호환되는 동작을 제공하는 경우 다른 버전을 사용할 수 있습니다.

  • Microsoft Edge 80
  • Safari 13
  • Chrome 80
  • Firefox 74

그리기 오류 시각화 도우미 도구 사용

그리기 오류 시각화 도우미 도구를 시작하면 업로드 페이지가 표시됩니다. 업로드 페이지에는 끌어서 놓기 상자가 포함됩니다. 끌어서 놓기 상자는 파일 탐색기 대화 상자를 시작하는 단추로도 작동합니다.

Drawing Error Visualizer App - Start Page

ConversionWarningsAndErrors.json 파일은 다운로드된 디렉터리의 루트에 배치되었습니다. ConversionWarningsAndErrors.json을 로드하려면 파일을 상자로 끌어 놓습니다. 또는 상자를 선택하고 File Explorer dialogue에서 파일을 찾아 업로드합니다.

Drawing Error Visualizer App - Drag and drop to load data

ConversionWarningsAndErrors.json에는 그리기 패키지 오류 및 경고 목록이 표시됩니다. 오류 또는 경고에 대한 자세한 내용을 보려면 세부 정보 링크를 선택합니다. 그러면 복잡한 섹션이 목록 아래에 표시됩니다. 이제 각 오류로 이동하여 오류를 해결하는 방법에 대한 자세한 정보를 확인할 수 있습니다.

Drawing Error Visualizer App - Errors and Warnings

다음 단계

자세한 정보는 다음을 참조하세요.