Google 小组件

PTC 已不再支持 ThingWorx 的 Google 小组件扩展，PTC 下载门户也不再提供此扩展的下载服务。PTC 合作伙伴 Free ThingWorx Widgets | IQNOX 将为此扩展提供支持并于未来发布维护版本。有关详细信息，请参阅 PTC 支持文章。

使用由 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. 搜索并定位 GetGoogleMapConnectionString 和 SetGoogleMapConnectionString。

可以选择 GetGoogleMapConnectionString，然后单击“执行”以验证连接字符串。

4. 选择 SetGoogleMapConnectionString 并在该字段中输入包含 API 密钥的 URL。

5. 单击“保存输入集”，然后单击“执行”。

6. 将扩展导入 ThingWorx，然后开始在您的混搭中使用 Google 小组件。

使用 Google widgets 3.0.1 和更早版本

建议将 Google Widgets 扩展包升级到最新版本。

有关管理 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&v=3.21"</script>

3. 压缩扩展并将其导入 ThingWorx。

这对您有帮助吗?