ThingWorx 扩展性 > 扩展 > Google 小组件
Google 小组件
使用由 ThingWorx 提供的 Google 小组件扩展包可在 ThingWorx 内的地图上选择和绘制地理位置。该扩展包由两个主要小组件组成:Google 位置选取器小组件和 Google 地图小组件。Google 地图是由谷歌提供的网络地图服务应用程序和技术。位置选取器可在混搭中用于在 Google 地图上设置位置。
要使用 Google 地图,必须获得许可证。有关详细信息,请参阅 Google Maps 使用限制和计费
Google widgets extension 3.0.4 以及更高版本附带了安全增强功能。
要使用 Google 小组件扩展包,请下载 GoogleWidgets_ExtensionPackage.zip 并将其导入到 ThingWorx 中。该包将以下内容导入到 ThingWorx 中:
Google Location Picker 小组件
Google Map 小组件
DefaultMapRegionSelectedStyle 样式定义 (默认映射区域选定样式。)
有关 Google 位置选取器小组件及其属性的信息,请参阅 Google 位置选取器
有关 Google 地图小组件及其属性的详细信息,请参阅 Google 地图
使用 Google Widgets 3.0.2 及更高版本
* 
Google Widgets 3.0.2 及更高版本仅与 ThingWorx Platform 8.2.8+ 和 8.3.3+ 版本兼容。
要在 ThingWorx 中使用 Google 小组件,必须获取您自己的 Google Maps API 密钥或客户端 ID (适用于 Google Maps API for Work 许可证) 并使其生效。要获取 API 密钥或客户端 ID,请参阅 Google Maps API 文档客户端 ID 信息
要了解通过 Google 对 API 密钥进行的更新,请参阅 从 v2 升级到 v3 部分。如果您使用旧 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 widgets 3.0.1 和更早版本
* 
建议将 Google Widgets 扩展包升级到最新版本。
要在 ThingWorx 中使用 Google 小组件,必须获取您自己的 Google Maps API 密钥或客户端 ID (适用于 Google Maps API for Work 许可证) 并使其生效。要获取 API 密钥或客户端 ID,请参阅 Google Maps API 文档客户端 ID 信息
要了解通过 Google 对 API 密钥进行的更新,请参阅 从 v2 升级到 v3 部分。如果您使用旧 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。