Google ウィジェット
ThingWorx で提供されている Google ウィジェット拡張機能パッケージは、ThingWorx 内で地理的な場所を選択し、マップ上にプロットするときに使用します。この拡張パッケージは、Google ロケーションピッカーウィジェットと Google マップウィジェットの 2 つの主なウィジェットから構成されています。Google マップは、Google が提供するウェブマッピングサービスアプリケーションおよびテクノロジーです。ロケーションピッカーをマッシュアップで使用することで、Google マップ上で場所を設定できます。
Google マップを使用するには、ライセンスを取得する必要があります。詳細については、
Google マップの使用制限と購入を確認します。
Google ウィジェット拡張機能 3.0.4 以降のバージョンでは、セキュリティ機能が強化されています。
Google ウィジェット拡張機能パッケージを使用するには、GoogleWidgets_ExtensionPackage.zip をダウンロードして ThingWorx にインポートします。パッケージにより、次のものが ThingWorx にインポートされます。
• Google Location Picker ウィジェット
• Google Map ウィジェット
• DefaultMapRegionSelectedStyle スタイル定義 (デフォルトのマップ領域の選択スタイル)
Google ロケーションピッカーウィジェットとそのプロパティについては、
Google ロケーションピッカーを参照してください。
Google マップウィジェットとそのプロパティについては、
Google マップを参照してください。
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 ライセンスの場合) を取得し、実装する必要があります。API キーまたはクライアント ID を取得するには、
Google Maps API ドキュメンテーションまたは
クライアント ID 情報を参照してください。
Google による API キーのアップデートについては、
v2 から v3 へのアップグレードのセクションを参照してください。以前の URL https://maps.google.com/maps/api/js?sensor=false&key=YOUR_API_KEY または v2 の API キーを使用している場合、"FOR DEVELOPMENT PURPOSE ONLY" というエラーメッセージが表示されます。その後で、API キーを再生成する必要があります。
API キーまたはクライアント ID を取得した後、以下の手順に従います。
1. Google ウィジェット拡張機能をフォルダにダウンロードします。
2. ThingWorx Composer で、「サブシステム」 > 「PlatformSubsystem」 > 「サービス」に移動します。
3. GetGoogleMapConnectionString と SetGoogleMapConnectionString をサーチして見つけます。
| | 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 ライセンスの場合) を取得し、実装する必要があります。API キーまたはクライアント ID を取得するには、
Google Maps API ドキュメンテーションまたは
クライアント ID 情報を参照してください。
Google による API キーのアップデートについては、
v2 から v3 へのアップグレードのセクションを参照してください。以前の URL https://maps.google.com/maps/api/js?sensor=false&key=YOUR_API_KEY または v2 の API キーを使用している場合、"FOR DEVELOPMENT PURPOSE ONLY" というエラーメッセージが表示されます。その後で、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 にインポートします。