什麼是 Location（Google Maps）外掛？
Location（Google Maps） 外掛提供地理定位（Geolocation）與反向地理定位（Reverse Geolocation）功能，可協助取得位置資訊並填入表單資料。
您可以將取得的位置資訊寫入單行文字或多行文字欄位，例如緯度、經度、郵遞區號、完整地址等資訊。此外，若有權限，也可手動調整所取得的位置。
這個外掛可以做什麼？
Location（Google Maps） 外掛適用於多種應用情境。
例如，當員工進行遠端打卡時，可透過此外掛取得目前位置，用於遠端出勤管理，協助企業更有效率且準確地記錄員工出勤資訊。
同樣地，在活動或課程的出勤管理中，教育機構及活動主辦單位也能利用此功能追蹤研討會、工作坊或會議等活動的出席情況。參與者可直接遠端簽到，讓活動管理更加便利。
此外，此外掛也非常適合用於庫存管理。企業可追蹤商品在倉庫內或不同據點之間的流向與位置，提高庫存管理的精確度與效率。
效果預覽
以遠端辦公為例，您可以使用此外掛掌握遠端員工的位置，確認其是否於核准的工作地點上班。當員工點擊 Clock In（打卡） 按鈕時，系統會自動取得目前位置，並顯示地圖。依據您的設定，員工可在允許的範圍內調整自己的位置。
完成調整後，只需關閉視窗，修改後的位置便會自動儲存至表單中。
版本說明
定位（Google Maps）外掛為付費外掛。每次定位（包括偵錯測試）將花費您大約 0.054 美元。
注意：定位服務由 Google Maps Platform 提供，點選此處取得 Google 支援的詳細指導，以查看和下載發票或對賬單的費用詳情。
如何透過外掛連接 Google 與 Jodoo？
步驟 1：安裝外掛
請依照以下步驟安裝外掛：
點擊此處前往應用市場。
搜尋 Location（Google Maps） 外掛。
開啟 Location（Google Maps） 外掛。在彈出視窗中，按一下 Install 完成安裝。
注意：如需詳細操作說明，請參閱外掛市場 。
步驟 2：啟用外掛
步驟 3：取得請求參數
Google Maps API Key
Location（Google Maps） 外掛使用 Google Maps Platform 提供的位置服務。在使用此外掛前，請先輸入 Google Maps API Key，以便與 Google Maps Platform 建立連線。請依照以下步驟建立並驗證 API Key：
1. 前往 Google API Console，並登入您的 Google 帳戶。在 APIs & Services 頁面中，啟用Maps JavaScript API，Places API 和Geocoding API。啟用成功後，按鈕狀態會由 Enable 變更為 Manage，表示該 API 已成功啟用。
2.在 Keys & Credentials 頁面，建立或開啟專案（Project）。
3.按一下 CREATE CREDENTIALS 建立 API Key，並妥善複製保存。
4.回到 Jodoo，貼上並驗證剛剛建立的 API Key。
Adjust Location Within Radius (in meters)
您可以設定允許調整定位的位置範圍，以降低填寫表單時的定位誤差。預設值為 0，表示成員無法調整定位。若留空，表示不限制可調整的範圍。若輸入無效值（例如小於 0），系統將自動視為 0。
Adjust Location Within Radius (in meters) 提供兩種設定方式：
Custom：手動輸入半徑（公尺）。
Field Value：選取一個 Number 欄位作為半徑值。
外掛會回傳哪些參數？
您可以將取得的位置資訊儲存至 Single Line 或 Multi Line 欄位。
Location（Google Maps） 外掛可回傳以下位置資訊：
參數 | 說明 |
Latitude | 回傳定位位置的緯度。緯度以數字表示，精確至小數點後六位。緯度值範圍為 -90 至 90，超過小數點後六位的精度將被忽略。 |
Longitude | 回傳定位位置的經度。經度以數字表示，精確至小數點後六位。經度值範圍為 -180 至 180，超過小數點後六位的精度將被忽略。 |
Current Location | 回傳此位置的人類可讀地址字串。格式化地址通常由一個或多個地址組成部分構成。例如，地址 111 8th Avenue, New York, NY 包含以下組成部分：111（街號）、8th Avenue（道路）、New York（城市）和 NY（美國州名）。 |
Country/Region | 回傳國家或地區層級的政治實體，通常為 Geocoder 回傳的最高層級類型。 |
Postal Code | 回傳該國家或地區用於郵件寄送的郵遞區號。 |
State/Province | 回傳國家層級以下的第一級行政區。 |
City | 回傳城市或城鎮層級的行政區。 |
Block | 回傳地區層級以下的第一級行政區。 |
Street | 回傳精確的街道地址。 |
Street Number | 回傳精確的門牌號碼。 |
啟用外掛後，如何使用？
啟用後，您可以透過自動化或前端事件在表單中使用此外掛。以下以遠端打卡為例進行說明。
1.建立一個 Employee Clock In 表單，並加入以下欄位：
欄位名稱 | 欄位類型 | 欄位屬性 |
Employee Clock In | Divider | / |
Name | Member | 將初始值設定為 Current User。在欄位權限中取消勾選 Edit。 |
Department | Department | 將初始值設定為 Department of Current User。在欄位權限中取消勾選 Edit。 |
Clocked in at | Date&Time | 將類型設定為 YYYY-MM-DD HH:MM。將初始值設定為 Current Time。在欄位權限中取消勾選 Edit。 |
Location | Single Line | 在欄位權限中取消勾選 Edit。 |
Clock in | Button | 詳細設定請參閱下一節「設定 Clock in 欄位」。 |
2. 請依照以下步驟設定 Clock in 按鈕欄位：
A. 拖曳新增一個 Button 欄位。
B. 前往 Field Properties > Button Text，將按鈕文字改為 Clock in。
C. 開啟 Settings for Triggered Action，並按一下 Add Action。
D. 將 Front-End Event 的 Event Name 設定為 Clock in location。
E. 依照以下內容設定 Triggered Action：
Select the plugin：選擇 Location（Google Maps） 外掛。
輸入 Google Maps API Key。如需取得 API Key，請參閱前文的 Google Maps API Key 說明。
將 Adjust Location Within Radius (in meters) 設定為 Custom，並輸入自訂數值，例如 50。
按一下 Add，設定規則為將 Current Location 儲存至 Location 欄位。
完成設定後，按一下 Save。
常見問題
Q：位置資訊會以哪種語言顯示？
A：若在電腦或手機上的 PWA 使用此外掛，位置資訊會依照瀏覽器語言顯示。若在手機上的 Jodoo App 使用此外掛，位置資訊會依照裝置語言顯示。
Q：是否需要授權定位權限？
A：需要。使用此外掛前，必須先啟用瀏覽器、App 和裝置的定位權限。這可確保外掛能存取您裝置的位置資訊。
Q：為什麼有時候無法成功定位？
A：若在電腦上使用此外掛，定位成功率與準確度可能會受到裝置和瀏覽器影響。以下情況可能導致無法定位：
裝置不支援 GPS。
未授予本外掛（Jodoo）定位權限。
網頁瀏覽器的位置服務成功率相對較低，且成功率與準確度會因使用的瀏覽器而異。
瀏覽器 | 成功率 | 準確度 |
Safari | 高 | 高 |
Edge | 中 | 低 |
Chrome | 低 | 高 |
若要降低定位誤差，請設定 Adjust Location Within Radius (in meters)。此功能允許成員在需要時手動修正自己的位置。