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 からの改ページ応答を処理し、すべてのフィーチャを処理します。
- フィードの接続パラメーターを構成したら、スキーマとキー フィールド パラメーターを定義します。
- Samsara エンドポイント ドロップダウン リストのフィードを使用している場合、[URL パラメーター] でタイプを指定できます (gps、engineStates など)。
パラメーター
フィードには、次のパラメーターがあります:
| パラメーター | 説明 | データ タイプ |
|---|---|---|
| Samsara エンドポイント | Samsara API URL を指定します。 サポートされている Samsara エンドポイントには次のようなものがあります:
| Samsara API URL |
| URL (条件) | カスタム Samsara API URL。 フィードが取り込み用データを取得しているため、これは Samsara API の GET リクエスト エンドポイントである必要があります。 URL と、指定された URL パラメーターにより、Samsara API によって返されるデータが制御されます。 このパラメーターは、[Samsara エンドポイント] パラメーターが [その他] オプションに設定されている場合に使用できます。 | String |
| API キー | Samsara API キー。 次の書式で API キーを指定します: samsara_api_<yourAPIKey>。 | String |
| 最新のデータのみを読み込む (条件) | 初回データ読み込み後は、最新のデータのみを読み込みます。 このパラメーターがオンになっている場合、フィードは 1 回目の実行ではすべてのデータを取り込み、以降の実行では最新の更新内容のみを取り込みます。 このパラメーターは、次の 2 つの Samsara エンドポイントでのみサポートされています:
| Boolean |
| URL パラメーター (オプション) | 指定した Samsara URL に送信される HTTP リクエストの 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 秒ごとにポーリングできます。
- ユーザー認証情報が無効な場合、フィードは 3 回まで接続を再試行します。 無効な認証情報エラーは、ログに表示されます。 フィードは、構成された頻度スケジュールに基づいて、遅延後に自動的に再起動しようとします。