【 Cloud 】透過 Postman 建立 Azure Indoor Map

【 Cloud 】透過 Postman 建立 Azure Indoor Map
Photo by Animus Invictus / Unsplash

內容

  • 學習目標
  • 前置準備作業
  • 建立 Azure Maps 服務
  • Postman 前置準備
  • 透過 Postman 操作 Creator
  • 透過 Web 顯示 Azure Indoor Map

學習目標

  • 如何透過 Postman 建立 Azure Indoor Map

前置準備作業

  • 已建立 Azure 帳號並能正常登入。
  • 本地端電腦已安裝瀏覽器。

建立 Azure Maps 服務

Step 1. 在上方搜尋框輸入 map 關鍵字並點選 Azure Maps Accounts 的搜尋結果

---2021-11-24---1.05.44

Step 2. 點選 + Create

---2021-11-24---1.07.01

Step 3. 輸入相關資訊

  • Subscription 欄位選擇所要使用的訂閱。
  • Resource group 欄位輸入此 Map 所要歸屬於的群組。
  • Name 欄位輸入一個可識別的名稱。
  • Region 欄位請選擇 East US
  • Pricing tier 欄位請選擇此 Map 服務所要使用的等級,請選擇 Gen2 (Maps and Location Insights)
  • 請勾選 I confirm that I have read and agree to the License and Privacy Statement.
  • 當輸入完成後點選 Review + create

Step 4. 建立服務

  • 確認資訊正確則點選 Create

---2021-11-24---1.13.20

Step 5. 點選 Go to resource

---2021-11-24---1.14.27

Step 6. 建立 Creator

  • 點選左側 Creator > 再點選 + Create a Creator resource

---2021-11-24---1.17.12

  • 輸入相關資訊
    • Creator name 欄位請輸入可識別的名稱。
    • Storage Units 欄位請輸入所需要的使用單位。
    • 當輸入完成後點選 Review + create

---2021-11-24---1.19.21

  • 確認資訊正確則點選 Create

---2021-11-24---1.23.18

Step 7. 取得 Primary Key

  • 點選左側的 Authentication > 再點選 Primary Key 右邊的複製按鈕

---2021-11-24---1.25.40

Postman 前置準備

Step 1. 下載相關檔案

---2021-11-24---1.32.34-1

Step 2. 下載 Postman 並開啟 Postman

Step 3. 匯入 Collection

  • 點選上方的 Import

---2021-11-24---1.39.40-1

  • 點選 Upload Files

---2021-11-24---1.41.20-1

  • 選擇 Step 1 所解壓縮後的資料夾中的 Postman-for-Azure-Indoor-Map.postman_collection.json 檔案並點選 打開

---2021-11-24---1.43.30-1

  • 點選 Import

---2021-11-24---1.45.15-1

  • 匯入成功

---2021-11-24---1.46.54-1

透過 Postman 操作 Creator

Step 1. 上傳 DWG 與 manifest.json 的 ZIP 到 Azure Maps

  • 點選 Postman 左側選單中的 1. Upload a Drawing package

---2021-11-24---1.46.54--

  • 將 URL 中的 InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---2.14.10

---2021-11-24---1.25.40

  • 點選 Body > Select File

---2021-11-24---2.20.10

  • 選擇之前解壓縮資料夾中的 Sample - Contoso Drawing Package.zip 再點選右下角的 打開

---2021-11-24---2.28.12

  • 點選 Send

---2021-11-24---2.30.30

  • Request 送出後的結果

---2021-11-24---2.36.39

  • 取得 OperationIDStep 2 使用
    • 點選 Headers 頁籤裡 Location 中的 OperationID

---2021-11-24---2.41.16

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

  • 點選 Postman 左側選單中的 2. 檢查繪圖套件上傳狀態,再將 URL 中的 OperationID 改成 Step 1 取得 OperationID

---2021-11-24---2.48.24

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---2.49.59

---2021-11-24---1.25.40

  • 點選 Send

---2021-11-24---2.52.23

  • Request 送出後的結果並取得 UDIDStep 3 使用
    • 從 Response Body 中的 resourceLocation 取得 UDID

---2021-11-24---2.54.49

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

  • 點選 Postman 左側選單中的 3. 取出繪圖套件中繼資料,再將 URL 中的 UDID 改成 Step 2 取得 UDID

---2021-11-24---3.01.46

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---3.03.45

---2021-11-24---1.25.40

  • 點選 Send

---2021-11-24---3.06.30

  • Request 送出後的結果

---2021-11-24---3.09.09

Step 4. 轉換繪圖套件

  • 點選 Postman 左側選單中的 4. 轉換繪圖套件,再將 URL 中的 UDID 改成 Step 2 取得 UDID

---2021-11-24---3.11.22

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---3.12.53

---2021-11-24---1.25.40

  • 點選 Send

---2021-11-24---3.14.03

  • Request 送出後的結果並取得 OperationIDStep 5 使用
    • 從 Response Header 中的 Operation-Location 取得 OperationID

---2021-11-24---3.17.29

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

  • 點選 Postman 左側選單中的 5. 檢查繪圖套件轉換狀態,再將 URL 中的 OperationID 改成 Step 4 取得 OperationID

---2021-11-24---3.22.16

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---3.24.44

---2021-11-24---1.25.40

  • 點選 Send

---2021-11-24---3.25.31

  • Request 送出後的結果並取得 ConversionIDStep 6 使用
    • 從 Response Header 中的 Resource-Location 取得 ConversionID

---2021-11-24---3.28.49

Step 6. 建立資料集

  • 點選 Postman 左側選單中的 6. 建立資料集,再將 URL 中的 ConversionID 改成 Step 5 取得 ConversionID

---2021-11-24---3.31.32

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---3.32.50

---2021-11-24---1.25.40

  • 點選 Send

---2021-11-24---3.33.44

  • Request 送出後的結果並取得 OperationIDStep 7 使用
    • 從 Response Header 中的 Operation-Location 取得 OperationID

---2021-11-24---3.35.57

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

  • 點選 Postman 左側選單中的 7. 檢查資料集建立狀態,再將 URL 中的 OperationID 改成 Step 6 取得 OperationID

---2021-11-24---3.38.19

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---3.40.23

---2021-11-24---1.25.40

  • 點選 Send
    • 執行會花不少時間

---2021-11-24---3.41.19

  • Request 送出後的結果並取得 DatasetIDStep 8 使用
    • 從 Response Header 中的 Resource-Location 取得 DatasetID

---2021-11-24---3.43.521

Step 8. 建立圖格集

  • 點選 Postman 左側選單中的 8. 建立圖格集,再將 URL 中的 DatasetID 改成 Step 7 取得 DatasetID

---2021-11-24---3.46.311

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---3.47.551

---2021-11-24---1.25.40

  • 點選 Send

---2021-11-24---3.51.31

  • Request 送出後的結果並取得 OperationIDStep 9 使用
    • 從 Response Header 中的 Operation-Location 取得 OperationID

---2021-11-24---3.54.40

Step 9. 檢查 tileset 建立狀態

  • 點選 Postman 左側選單中的 9. 檢查 tileset 建立狀態,再將 URL 中的 OperationID 改成 Step 8 取得 OperationID

---2021-11-24---3.56.28

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---3.57.49

---2021-11-24---1.25.40

  • 點選 Send
    • 執行會花不少時間

---2021-11-24---3.58.38

  • Request 送出後的結果並取得 TilesetId
    • 從 Response Header 中的 Resource-Location 取得 TilesetId

---2021-11-25---7.57.17

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

  • 點選 Postman 左側選單中的 10. 查詢資料集中的所有集合,再將 URL 中的 DatasetID 改成 Step 7 取得 DatasetID

---2021-11-24---4.02.04

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---4.03.36

---2021-11-24---1.25.40

  • 點選 Send

---2021-11-24---4.04.21

  • Request 送出後的結果

---2021-11-24---4.05.42

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

  • 點選 Postman 左側選單中的 11. 查詢資料集中的單位集合,再將 URL 中的 DatasetID 改成 Step 7 取得 DatasetID

---2021-11-24---4.06.19

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---4.08.02

---2021-11-24---1.25.40

  • 點選 Send

---2021-11-24---4.08.47

  • Request 送出後的結果
    • Response 中的 id 代表各區塊的編號,例如: 第 86 行的值為 UNIT25,此編號在 Step 13 需要用到。

---2021-11-24---6.11.26

Step 12. 建立功能狀態集

  • 點選 Postman 左側選單中的 12. 建立功能狀態集,再將 URL 中的 DatasetID 改成 Step 7 取得 DatasetID

---2021-11-24---6.14.00

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---6.15.23

---2021-11-24---1.25.40

  • 設定 Request Body
    • 點選 Body 並於紅色框處輸入下方設定

---2021-11-24---6.18.34

  • 點選 Send

---2021-11-24---6.19.57

  • Request 送出後的結果並取得 StatesetIDStep 13 使用
    • 從 Response Body 中取得 StatesetID

---2021-11-24---6.22.01

Step 13. 更新功能狀態

  • 點選 Postman 左側選單中的 13. 更新功能狀態,再將 URL 中的 StatesetID 改成 Step 11 取得 StatesetID

---2021-11-24---6.24.57

  • 設定 FeatureID
    • 將 URL 中的 FeatureID 改成 Step 11 取得 id

---2021-11-24---6.27.45

  • InputKey 改成 Azure Maps 取得 Primary Key

---2021-11-24---6.28.54

---2021-11-24---1.25.40

  • 設定 Request Body
    • 點選 Body 並於紅色框處輸入下方設定
    • 每次進行設定時, eventTimestamp 的值需比前次所設定的時間再更新才會設定成功

---2021-11-24---6.30.42

  • 點選 Send

---2021-11-24---6.32.35

  • Request 送出後的結果

---2021-11-24---6.34.43

透過 Web 顯示 Azure Indoor Map

Step 1. 經由瀏覽器開啟 Map

Step 2. 輸入相關資訊

  • Key 欄位請輸入 Azure Maps 取得 Primary Key
  • Tileset ID 欄位請輸入 透過 Postman 操作 Creator 段落中 Step 9 所取得的 TilesetID
  • Stateset ID 欄位請輸入 透過 Postman 操作 Creator 段落中 Step 12 所取得的 StatesetID
  • 以上資訊輸入完成後點選 顯示 Map 按鈕

---2021-11-25---9.28.23

Step 3. 顯示 Map 結果

  • 結果顯示

---2021-11-25---9.34.21

  • Zoom In 地圖
    • 紅色區域為 透過 Postman 操作 Creator 段落中 Step 13idUNIT25 進行 alarm 的 Style 設定

---2021-11-25---9.34.41

GitHub

List of blogs