AIoT & Cloud & Edge & Machine Learning

【 Tool 】Azure Indoor Map Tools - 透過 Swagger 與 Creator REST API 建立 Indoor Map

Archer

• 10 min read
【 Tool 】Azure Indoor Map Tools - 透過 Swagger 與 Creator REST API 建立 Indoor Map
Photo by Hisham Zayadnh / Unsplash

內容

  • 學習目標
  • 前置準備作業
  • 透過 Swagger 與 Azure Map Creator 建立 Indoor Map
  • 透過 Web 顯示 Azure Indoor Map

學習目標

  • 如何透過 Swagger 與 Creator REST API 建立 Azure Indoor Map

前置準備作業

  • 已建立 Azure 帳號並能正常登入與使用。
  • 已於 Azure 建立 Azure Maps Account，其 Location 為 East US。
  • 已於電腦端安裝瀏覽器，本範例使用 Google Chrome。

透過 Swagger 與 Azure Map Creator 建立 Indoor Map

Step 1. 透過瀏覽器開啟 Swagger

Step 2. 設定 Azure Map 的 Primary Key

  • 點選右上角的 Authorize

---2021-12-22---10.27.59

  • 輸入相關資訊
    • 在 Value 的欄位輸入 Azure Map 的 Primary Key
    • 輸入完成點選 Authorize
    • Authorize 完成後再點選 Close

---2021-12-22---10.33.07

---2021-12-22---10.29.24

---2021-12-22---10.39.00

Step 3. 上傳 dwg + manifest.json 的 zip 檔案

  • 點選 1. 上傳 dwg + manifest.json 的 zip 檔案 步驟下方的 v

---2021-12-22---10.42.20

  • 點選 Try it out

---2021-12-22---10.44.09

---2021-12-22---10.46.42

  • 點選 Execute

---2021-12-22---10.48.56

---2021-12-22---10.50.58

Step 4. 檢查繪圖套件上傳狀態

  • 點選 2. 檢查繪圖套件上傳狀態 步驟下方的 v

---2021-12-22---10.56.55

  • 點選 Try it out

---2021-12-22---11.05.30

  • 輸入相關資訊
    • operation-id 欄位請輸入 Step 3 所取得的 operation-id

---2021-12-22---11.03.45

  • 點選 Execute

---2021-12-22---11.03.00

---2021-12-22---11.08.21

Step 5. 取出繪圖套件中繼資料

  • 點選 3. 取出繪圖套件中繼資料 ( 選擇性 ) 步驟下方的 v

---2021-12-22---11.10.25

  • 點選 Try it out

---2021-12-22---11.11.26

  • 輸入相關資訊
    • udid 欄位請輸入 Step 4 所取得的 udid

---2021-12-22---11.13.55-1

  • 點選 Execute

---2021-12-22---11.15.22

  • 執行完成

---2021-12-22---11.16.28

Step 6. 轉換繪圖套件

  • 點選 4. 轉換繪圖套件 步驟下方的 v

---2021-12-22---11.17.12

  • 點選 Try it out

---2021-12-22---11.18.20

  • 輸入相關資訊
    • udid 欄位請輸入 Step 4 所取得的 udid

---2021-12-22---11.19.31

  • 點選 Execute

---2021-12-22---11.20.38

---2021-12-22---11.21.55

Step 7. 檢查繪圖套件轉換狀態

  • 點選 5. 檢查繪圖套件轉換狀態 步驟下方的 v

---2021-12-22---11.24.06

  • 點選 Try it out

---2021-12-22---11.25.08

  • 輸入相關資訊
    • operation-id 欄位請輸入 Step 6 所取得的 operation-id

---2021-12-22---11.26.44

  • 點選 Execute

---2021-12-22---11.27.32

  • 執行完成
    • 當 Response body 中 status 的值為 Succeeded 代表檢查繪圖套件轉換狀態成功 ( 如果 status 為 Running 時請稍候片刻再重新執行 Step 7 )，請取出 Response Headers 中 resource-location 欄位中 https://us.atlas.microsoft.com/conversions/conversion-id?api-version=2.0 的 conversion-id，本範例的 conversion-id 為 8c36560b-0592-5d50-9e70-8abaeca5906a。

---2021-12-22---11.29.18

Step 8. 建立資料集

  • 點選 6. 建立資料集 步驟下方的 v

---2021-12-22---11.30.53

  • 點選 Try it out

---2021-12-22---11.31.44

  • 輸入相關資訊
    • conversionId 欄位請輸入 Step 7 所取得的 conversion-id

---2021-12-22---11.33.08

  • 點選 Execute

---2021-12-22---11.33.56

---2021-12-22---11.35.36

Step 9. 檢查資料集建立狀態

  • 點選 7. 檢查資料集建立狀態 ( 會執行一段時間 ) 步驟下方的 v

---2021-12-22---12.55.04

  • 點選 Try it out

---2021-12-22---12.56.02

  • 輸入相關資訊
    • operation-id 欄位請輸入 Step 8 所取得的 operation-id

---2021-12-22---12.57.14

  • 點選 Execute

---2021-12-22---12.58.11

  • 執行完成
    • 當 Response body 中 status 的值為 Succeeded 代表檢查資料集建立狀態成功 ( 如果 status 為 Running 時請稍候片刻再重新執行 Step 9 )，請取出 Response Headers 中 resource-location 欄位中 https://us.atlas.microsoft.com/datasets/dataset-id?api-version=2.0 的 dataset-id，本範例的 dataset-id 為 712109d4-8035-53ad-f59e-86198399c6b8。

---2021-12-22---1.00.24

Step 10. 建立圖格集

  • 點選 8. 建立圖格集 步驟下方的 v

---2021-12-22---1.02.15

  • 點選 Try it out

---2021-12-22---1.04.14

  • 輸入相關資訊
    • datasetID 欄位請輸入 Step 9 所取得的 dataset-id

---2021-12-22---1.06.32

  • 點選 Execute

---2021-12-22---1.07.19

---2021-12-22---1.09.20

Step 11. 檢查 tileset 建立狀態

  • 點選 9. 檢查 tileset 建立狀態 ( 會執行一段時間 ) 步驟下方的 v

---2021-12-22---1.10.51

  • 點選 Try it out

---2021-12-22---1.12.01

  • 輸入相關資訊
    • operation-id 欄位請輸入 Step 10 所取得的 operation-id

---2021-12-22---1.13.00

  • 點選 Execute

---2021-12-22---1.13.55

  • 執行完成
    • 當 Response body 中 status 的值為 Succeeded 代表執行完成且檢查 tileset 建立狀態成功 ( 如果 status 為 Running 時請稍候片刻再重新執行步驟 9 )，請取出 Response Headers 中 resource-location 欄位中 https://us.atlas.microsoft.com/tilesets/tileset-id?api-version=2.0 的 tileset-id，本範例的 tileset-id 為 908ba4a5-d6cf-4fb5-d1be-f229aeb1f7cf。

---2021-12-22---1.15.19

Step 12. 查詢資料集中的所有集合

  • 點選 10. 查詢資料集中的所有集合 步驟下方的 v

---2021-12-22---1.17.41

  • 點選 Try it out

---2021-12-22---1.18.26

  • 輸入相關資訊
    • dataset-id 欄位請輸入 Step 9 所取得的 dataset-id

---2021-12-22---1.20.24-1

  • 點選 Execute

---2021-12-22---1.22.01

  • 執行完成

---2021-12-22---1.24.30

Step 13. 查詢資料集中的單位集合

  • 點選 11. 查詢資料集中的單位集合 步驟下方的 v

---2021-12-22---1.25.30

  • 點選 Try it out

---2021-12-22---1.26.19

  • 輸入相關資訊
    • dataset-id 欄位請輸入 Step 9 所取得的 dataset-id

---2021-12-22---1.27.24

  • 點選 Execute

---2021-12-22---1.28.15

  • 執行完成
    • 取得 Response body 中的 id，本範例為 UNIT26。
      • ㊟ 此 id 代表 Feature ID，且此 id 在 Response body 中會有多個，可隨意取一個 id。

---2021-12-22---1.31.08

Step 14. 建立功能狀態集

  • 點選 12. 建立功能狀態集 步驟下方的 v

---2021-12-22---1.36.25

  • 點選 Try it out

---2021-12-22---1.37.25

  • 輸入相關資訊
    • dataset-id 欄位請輸入 Step 9 所取得的 dataset-id
    • Request body 欄位請輸入下方資訊

---2021-12-22---1.41.17

  • 點選 Execute

---2021-12-22---1.43.43

  • 執行完成
    • 記錄 Response body 中 statesetId 的值。

---2021-12-22---1.49.21

Step 15. 更新功能狀態

  • 點選 13. 更新功能狀態 步驟下方的 v

---2021-12-22---1.51.20

  • 點選 Try it out

---2021-12-22---1.52.18

  • 輸入相關資訊
    • stateset-id 欄位請輸入 Step 14 所取得的 statesetId
    • feature-id 欄位請輸入 Step 13 所取得的 Feature ID
    • Request body 欄位請輸入下方資訊

---2021-12-22---1.56.50

  • 點選 Execute

---2021-12-22---1.55.48

  • 執行完成

---2021-12-22---1.59.22

透過 Web 顯示 Azure Indoor Map

Step 1. 經由瀏覽器開啟 Map

Step 2. 輸入相關資訊

  • Key 欄位請輸入 Azure Maps 取得 Primary Key
  • Tileset ID 欄位請輸入所取得的 TilesetID
  • Stateset ID 欄位請輸入所取得的 StatesetID
  • 以上資訊輸入完成後點選 顯示 Map 按鈕

---2021-12-16---9.38.01

Step 3. 顯示 Map 結果

  • 結果顯示

---2021-12-16---9.39.17

  • 請 Zoom In 地圖
    • 藍色區域為 UNIT26 進行的 Style 設定

---2021-12-22---2.06.14

Azure Indoor Map Tools

GitHub

List of blogs

Sign up for more like this.

Enter your email
Subscribe