定位（Google Maps）外掛
簡介
「定位（Google Maps）」外掛提供地理編碼和反向地理編碼服務。可以檢索位置並將相關資訊自動填入表單。
它允許你透過「單行文字」或「多行文字」欄位取得位置相關資訊，例如緯度、經度、郵遞區號、詳細地址等。 你還可以在允許範圍內調整檢索到的位置。 例如，如果員工遠距辦公，需要考勤時，可以應用該外掛取得其位置以進行遠端打卡，公司可以籍此高效、準確地管理員工的考勤記錄。
應用場景
「定位（Google Maps）」外掛適用於不同場景下的多功能定位。該外掛可以根據你的需求調整，輕鬆定位。
- 在遠距辦公時，公司可以輕鬆地監督遠距工作的員工。定位員工的工作地點，以確保他們在批准的地點工作。 輕鬆提高生產力和工作效率。
- 在統計活動和課程的出勤情況時，教育機構和活動主辦方可以輕鬆追蹤研討會、講習班和會議的出勤情況。 與會者可以方便地遠端簽到。該外掛簡化了活動後勤工作。
- 該外掛也非常適合用於改善庫存管理。 企業可以監控倉庫內或不同地點之間的物品移動和位置，確保準確性和效率。
預期效果
在遠距工作時，可以使用此外掛來監督遠距員工並驗證他們是否在批准的地點工作。 當員工點擊「打卡」按鈕時，外掛將自動定位，並彈出一張地圖，允許員工根據您的設定在批准的半徑內調整其位置。 之後，員工只需關閉窗口即可，員工定位將自動被記錄到表單中。
版本說明
「定位（Google Maps）」外掛為付費外掛。每次定位（包括偵錯測試）將花費您大約 0.054 美元。
注意：
定位服務由 Google Maps Platform 提供。 點擊此處取得 Google 支援的詳細指導，以查看和下載發票或對賬單的費用詳情。
外掛參數
請求參數
Google Maps API Key
定位服務由 Google Maps Platform 提供。在使用外掛連接 Google Maps Platform 之前，您需要輸入 Google Maps API 金鑰。
請按照以下步驟建立並驗證金鑰：
1. 點擊此處並登入您的 Google 帳戶。
2. 在「API 和服務」頁面上，開啟「Maps JavaScript API」、「Places API」和「Geocoding API」。
3. 在「金鑰和憑證」頁面上，點擊以選取/建立專案。
4. 點擊「建立憑證」以生成 「API 金鑰」並複製。
5. 在 Jodoo 上校驗複製的金鑰。
注意:
1. 新增的 API 密鑰會顯示在 「API 金鑰」下。
2. 有關管理 Google API 的更多指導，請參閱使用 API 密鑰。
Adjust Location Within Radius (in meters)
填寫表單時，您可以透過調整位置減小定位誤差。 預設情況下，調整範圍為 0，這意味著成員無法調整定位。 如果將該欄位留空，則調整位置將不受限制。 如果您輸入非預期值，例如小於零的數字，系統將預設範圍為 0。
「Adjust Location Within Radius (in meters)」有兩個設定選項：
- 如果你選擇「自訂」, 你可以手動輸入數值；
- 如果你選擇「欄位值」, 選擇一個「數字」欄位。
回傳參數
你可以將範圍的定位資訊存在「單行文字」或「多行文字」欄位中。
該外掛將回傳以下位置資訊
參數 | 描述 |
Latitude | 回傳定位的緯度資訊。 精確到小數點後六位。 緯度可以採用 -90 到 90 之間的任何值。超出六位小數的精度將被忽略。 |
Longitude | 回傳定位的經度資訊。 精確到小數點後六位。 經度可以採用 -180 到 180 之間的任何值。超出六位小數的精度將被忽略。 |
Current Location | 回傳定位點的易讀地址。 這個地址通常等於郵寄地址。理論上，格式化地址是由一或多個「地址元件」組成。舉例來說，「111 8th Avenue, New York, NY」這個地址包含以下元件：「111」(門牌號碼)、「8th Avenue」(路名)、「New York」(城市) 和「NY」(美國州名)。 |
Country/Region | 回傳國家政治實體，且通常是地理編碼器所傳回的最高順位類型。 |
Postal Code | 回傳國家/地區郵政地址所使用的郵遞區號。 |
State/Province | 回傳縣市底下的第一順位行政實體。 |
City | 回傳自治城市或鄉鎮的政治實體。 |
Block | 回傳表示縣市底下的第一順位行政實體。 |
Street | 回傳精確的街道地址。 |
Street Number | 回傳精確的街道號碼。 |
操作步驟
安裝外掛
請按照以下步驟安裝外掛：
- 點擊此處造訪「外掛市場」；
- 搜尋位置「定位（Google Maps）」外掛；
- 打開「定位（Google Maps）」外掛，然後在彈出的窗口中點擊「安裝」按鈕進行安裝。
注意:
更多資訊，參考外掛市場中「安裝外掛」一節。 see the section "Installing Plugin(s)" in Plugin Market.
啟用外掛
在外掛管理頁面點擊
外掛應用
以遠端打卡為例，新建「員工打卡」表單並新增以下欄位：
欄位名稱 | 欄位類型 | 欄位屬性 |
員工打卡 | 分割線 | / |
姓名 | 成員單選 |
|
部門 | 部門單選 |
|
打卡時間 | 日期時間 |
|
地點 | 單行文字 | 在「欄位權限」下關閉「可編輯」。 |
打卡 | 按鈕 | 詳情參考下一節「打卡欄位設定」。 |
打卡欄位設定
1. 拖曳新增一個「按鈕」 欄位；
2. 打開「欄位屬性 > 按鈕文字」，將按鈕文字設定為「打卡」；
3. 打開「執行動作 > 設定」，點擊「新增執行動作」 Add Action.
4. 將「前端事件」的「事件名稱」設定為「打卡定位」。
5. 為「執行動作」進行以下設定：
- 選擇外掛：選擇「定位（Google Maps）」外掛；
- 輸入 Google Maps API Key；
- 將「 Adjust Location Within Radius (in meters) 」設定為「自訂」，並輸入一個數值，例如「50」；
- 點擊「新增」，將「Current Location」填入「地點」欄位。點擊「儲存」。
注意事項
- 在電腦上或行動裝置的 PWA 中，外掛會以瀏覽器的語言顯示位置資訊。
- 在行動裝置的 Jodoo 應用程式中，外掛會以設備的語言顯示位置資訊。
- 在使用該外掛之前，需要在瀏覽器，應用及設備設定中啟用位置權限。 確保外掛可以造訪您設備的位置。
- 當你在電腦上使用該外掛時，位置追蹤的成功率和準確性可能會受到你的設備和瀏覽器的影響。 以下場景中定位可能失效：
- 你的設備不支援 GPS；
- 你沒有為我們的外掛（Jodoo）啟用位置權限。
- 瀏覽器中的定位成功率相對較低。 不同瀏覽器的定位的成功率和準確性可能會有所不同。
瀏覽器 | 成功率 | Accuracy |
Safari | 高 | 高 |
Edge | 中 | 低 |
Chrome | 低 | 高 |
為了盡可能減小定位誤差，請透過「Adjust Location Within Radius (in meters)」配置允許成員在需要時手動更正其位置。