【 Cloud 】透過 Postman 建立 Azure Indoor Map

內容

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

學習目標

• 如何透過 Postman 建立 Azure Indoor Map

前置準備作業

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

建立 Azure Maps 服務

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

Step 2. 點選 + Create

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。

Step 5. 點選 Go to resource

Step 6. 建立 Creator

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

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

• 確認資訊正確則點選 Create

Step 7. 取得 Primary Key

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

Postman 前置準備

Step 1. 下載相關檔案

• ① 透過瀏覽器開啟 https://github.com/ArcherHuang/Azure-Indoor-Map-Tools
• ② 點選 Code > Download ZIP
• ③ 將下載的 ZIP 進行解壓縮

Step 2. 下載 Postman 並開啟 Postman

• 下載網址 https://www.postman.com/

Step 3. 匯入 Collection

• 點選上方的 Import

• 點選 Upload Files

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

• 點選 Import

• 匯入成功

透過 Postman 操作 Creator

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

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

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

• 點選 Body > Select File

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

• 點選 Send

• Request 送出後的結果

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

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

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

• 點選 Send

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

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

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

• 點選 Send

• Request 送出後的結果

Step 4. 轉換繪圖套件

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

• 點選 Send

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

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

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

• 點選 Send

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

Step 6. 建立資料集

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

• 點選 Send

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

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

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

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

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

Step 8. 建立圖格集

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

• 點選 Send

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

Step 9. 檢查 tileset 建立狀態

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

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

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

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

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

• 點選 Send

• Request 送出後的結果

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

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

• 點選 Send

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

Step 12. 建立功能狀態集

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

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

• 點選 Send

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

Step 13. 更新功能狀態

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

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

• 將 InputKey 改成 Azure Maps 取得 Primary Key

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

• 點選 Send

• Request 送出後的結果

透過 Web 顯示 Azure Indoor Map

Step 1. 經由瀏覽器開啟 Map

• 網址為 https://archerhuang.github.io/Azure-Indoor-Map-Tools/Indoor-Map/

Step 2. 輸入相關資訊

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

Step 3. 顯示 Map 結果

• 結果顯示

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

GitHub

• ArcherHuang @ GitHub

List of blogs

• https://oranwind.org/author/archer/
• https://learningsky.io/author/archer/