ArcGIS Velocity の Samsara フィード タイプは、関連するパラメーターを使用して指定された Samsara API URL に、HTTPS リクエストを送信します。
例
フィードの使用例を次に示します:
- URL https://api.samsara.com/fleet/vehicles/stats?types=gps を含む Samsara API を 5 秒ごとにクエリーし、車両の現在地および関連する統計を取得します。
- URL https://api.samsara.com/fleet/equipment/locations を含む Samsara API を 1 分ごとにクエリーし、機器の現在地を取得します。
- JSON 応答でデータと改ページ オブジェクトを返す、Samsara API (v2) からの任意の GET リクエスト エンドポイント。
使用上の注意
フィードを操作する際には、以下の点に注意してください:
- Samsara フィードは、構成ウィザードの [フィードのポーリング間隔] ステップで指定されている頻度で、指定した Samsara API URL をポーリングしてデータを読み込みます。
注意:
フィードは、Samsara API がフィーチャを返せる頻度よりも頻繁に実行されるように構成しないでください。
- ポーリング間隔が設定されている場合、ポーリングは、フィードの開始時刻とは関係なく、規則的な時間間隔で発生します。 たとえば、5 分おきにデータをポーリングするようにフィードが設定されている場合に、フィードが 8:03 AM に開始すると、初回のデータ リクエストは 8:05 AM に発生し、次は 8:10 AM に発生し、以降も同じ間隔で発生します。
- Velocity サブスクリプション ライセンス レベルには、フィードによって取り込むことができるデータ量に以下の制限があります。 フィードがライセンス レベルの取り込み制限を超えた場合、ログにメッセージが書き込まれ、制限に達したことをユーザーに通知する電子メールが送信されます。 データの取り込みが制限を超えた状態が 1 時間以上継続すると、フィードは停止されます。 必要に応じて、Esri の担当者、または Esri テクニカル サポートと連携して、ワークフローをサポートする Velocity ライセンス レベルを検討してください。 ライセンス レベルは以下のとおりです。
- Standard - 25 KB/秒 (約 100 イベント/秒) でデータを取り込んで処理します。
- Advanced - 250 KB/秒 (約 1,000 イベント/秒) でデータを取り込んで処理します。
- Dedicated - 2,500 KB/秒 (約 10,000 イベント/秒) でデータを取り込んで処理します。
- [URL パラメーター] パラメーターは、フィードのグローバル変数をサポートしています。 デフォルトでは、フィードのグローバル変数は、エポック時間 (UTC の 1970 年 1 月 1 日からのミリ秒) に変換されます。 必要に応じて、フィードのグローバル変数をエポック秒 (1970 年 1 月 1 日からの秒) および文字列の日時形式に変換できます。 フィードの解析変数と、それらが表す時間の概要を以下に示します。 開始後または再開後に初めてフィードが実行される際、$feed.FeedLastScheduledStartTime は、$feed.FeedScheduledStartTime から [フィードのポーリング間隔] ステップの値を引いた値になります。 これにより、フィードは、調整された開始時間から現在の時間までのデータを受信できるようになり、大量の履歴データの取り込みを防ぐことができます。
- $feed.FeedStartTime - フィードが開始された時間
- $feed.FeedScheduledStartTime - フィードの次の繰り返しがスケジュールされている時間。
- $feed.FeedLastScheduledStartTime - フィードの最後の繰り返しがスケジュールされていた時間。
- Samsara フィードは、返された data オブジェクトの Samsara API からの JSON 応答を自動的に処理し、JSON をフラット化します。
- 配列をフラット化したり、特定の配列へのフラット化の適用を除外したりできます。 配列のフラット化の適用除外が複数ある場合は、カンマで区切ります。
- Velocity は自動的に Samsara API からの改ページ応答を処理し、すべてのフィーチャを処理します。
- フィードの接続パラメーターを構成したら、スキーマとキー フィールド パラメーターを定義します。
パラメーター
フィードには、次のパラメーターがあります:
| パラメーター | 説明 | データ タイプ |
|---|---|---|
| URL | Samsara API URL。 フィードが取り込み用データを取得しているため、これは Samsara API の GET リクエスト エンドポイントである必要があります。 URL と、指定された URL パラメーターにより、Samsara API によって返されるデータが制御されます。 Samsara API エンドポイント URL は、「Samsara API の概要」で確認できます。 | String |
| API キー | Samsara API キー。 次の書式で API キーを指定します: samsara_api_<yourAPIKey>。 | String |
| URL パラメーター | 指定した Samsara URL に送信される HTTP リクエストの URL に含める、オプションの URL パラメーター。 パラメーターは [URL] パラメーターでも設定できますが、ここで入力された URL パラメーターは [URL] パラメーターに指定された一致するパラメーターをオーバーライドします。 ここで定義されるパラメーターは、常に URL エンコードされます。 このパラメーターは、フィードのグローバル変数をサポートしています。 | キーと値のペア |
| URL パラメーター (オプション) | フィードのグローバル変数をカスタムの日時形式に変換します。 | String |
| その他のログ (オプション) | [その他のログ] パラメーターをオンにして、Velocity が Samsara URL に発行した未処理の HTTP リクエストとレスポンスのログ記録が可能かどうかを指定します。 注意:このパラメーターは、トラブルシューティングの目的でオンにし、トラブルシューティングが完了したらオフにします。 オンにした後は、フィードを開始すると、デバッグ レベルのログがフィード ログ ページで使用できるようになります。 必要に応じて、トラブルシューティングについて Esri テクニカル サポートにお問い合わせください。 | Boolean |
検討事項および制限事項
フィードを使用する際には、以下の点を検討してください:
- このフィード タイプを使用するには、Samsara サブスクリプションおよび API キーが必要です。
- 現在の世代の Samsara API では、タイム スタンプには RFC 3339 形式が使用されています。 構成するには、[開始時間] パラメーターを、この文字列日時を含むフィールドに設定し、yyyy-MM-dd'T'HH:mm:ss'Z' の文字列日時書式を入力します。
- Samsara API は 5 秒ごとにポーリングできます。