ThingWorx 擴充性 > 延伸功能 > Google 小器具
Google 小器具
* 
PTC 對 ThingWorx 的 Google「小器具」延伸功能的支援已結束,且延伸功能不再可從 PTC 的下載入口網站下載。PTC 合作夥伴 免費 ThingWorx 小器具 | IQNOX 將為此延伸功能提供支援與未來維護版。如需詳細資訊,請參閱 PTC 的支援文章
使用 ThingWorx 提供的 Google 小器具延伸功能封裝可在 ThingWorx 中的地圖上選取及繪製地理位置。延伸功能封裝由兩個主要小器具組成:「Google 位置選擇器」小器具與「Google 地圖」小器具。Google Maps 是由 Google 提供的一種網路地圖服務應用程式與技術。位置選擇器可在混搭中使用,以在 Google 地圖上設定位置。
欲使用 Google Maps,您必須取得授權。如需詳細資訊,請參閱 Google Maps 使用限制與計費
Google 小器具延伸功能 3.0.4 及更新版本隨附安全性強化功能。
欲使用 Google 小器具延伸功能封裝,請下載 GoogleWidgets_ExtensionPackage.zip 並將其匯入 ThingWorx。該封裝會將下列項目匯入 ThingWorx:
Google Location Picker 小器具
Google Map 小器具
DefaultMapRegionSelectedStyle 樣式定義 (預設地圖區域所選樣式。)
如需有關 Google Location Picker 小器具及其內容的資訊,請參閱 Google Location Picker
如需有關 Google Map 小器具及其內容的資訊,請參閱 Google Map
使用 Google 小器具 3.0.2 及更新版本
* 
Google 小器具 3.0.2 及更新版本僅與 ThingWorx Platform 8.2.8+ 及 8.3.3+ 版本相容。
欲在 ThingWorx 中使用 Google 小器具,您必須取得並實行自己的 Google Maps API 金鑰或用戶端 ID (適用於 Google Maps API for Work 授權)。請參閱 Google Maps API 文件集用戶端 ID 資訊,取得 API 金鑰或用戶端 ID。
請參閱從 v2 升級至 v3 部份,瞭解 Google 所進行的 API 金鑰的更新。如果您使用舊 URL https://maps.google.com/maps/api/js?sensor=false&key=YOUR_API_KEY 或 API 金鑰 v2,會顯示錯誤 "FOR DEVELOPMENT PURPOSE ONLY" 訊息。然後您必須再生 API 金鑰。
如需有關管理 API 的詳細資訊,請參閱管理 API
在您取得 API 金鑰或用戶端 ID 之後,請遵循下列步驟操作:
1. 將 Google 小器具延伸功能下載到資料夾中。
2. 在 ThingWorx Composer 中,導覽至「子系統」> PlatformSubsystem >「服務」
3. 搜尋並找出 GetGoogleMapConnectionStringSetGoogleMapConnectionString
* 
您可以選取 GetGoogleMapConnectionString,然後按一下「執行」來核對連線字串。
4. 選取 SetGoogleMapConnectionString 並在欄位中輸入包括您的 API 金鑰的 URL。
5. 按一下「儲存輸入集合」,然後按一下「執行」
6. 將延伸功能匯入至 ThingWorx,並開始在您的混搭中使用「Google 地圖」小器具。
使用 Google 小器具 3.0.1 及之前版本
* 
建議您升級至 Google 小器具延伸功能封裝的最新版本。
欲在 ThingWorx 中使用 Google 小器具,您必須取得並實行自己的 Google Maps API 金鑰或用戶端 ID (適用於 Google Maps API for Work 授權)。請參閱 Google Maps API 文件集用戶端 ID 資訊,取得 API 金鑰或用戶端 ID。
請參閱從 v2 升級至 v3 部份,瞭解 Google 所進行的 API 金鑰的更新。如果您使用舊 URL https://maps.google.com/maps/api/js?sensor=false&key=YOUR_API_KEY 或 API 金鑰 v2,會顯示錯誤 "FOR DEVELOPMENT PURPOSE ONLY" 訊息。然後您必須再生 API 金鑰。
如需有關管理 API 的詳細資訊,請參閱管理 API
在您取得 API 金鑰或用戶端 ID 之後,請遵循下列步驟操作:
1. 將 Google 小器具延伸功能解壓縮到資料夾中。
2. 在 metadata.xml 檔案的 googlemap 小器具項目中,更新 Google API URL,以納入您的 API 金鑰或用戶端 ID。更新後,URL 的顯示內容應類似於下列其中一種:
https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
Google Maps API for Work 授權:<script src="https://maps.googleapis.com/maps/api/js?client=YOUR_CLIENT_ID&amp;v=3.21"</script>
3. 壓縮延伸功能,並將其匯入至 ThingWorx。
這是否有幫助?