Upload
収集したデータをパイオニア管理のクラウドサーバへ配信します。
配信条件
ユーザーアプリケーションでは、activateの引数にて、以下の配信条件のみが設定可能です。
- 配信先URL
- 配信周期
- 配信データ種別 ( 参照:Table.4.3.1 )
配信データ種別→ 配信する収集データ↓ | SENSOR _INFO | NAVI _INFO | ROUTE _ACTION _LOG | VEHICLE _INFO | LOCATION _INFO | GNSS _INFO | HW _SENSOR _INFO | ACTIVITY _INFO |
---|---|---|---|---|---|---|---|---|
naviInfo | 配信する | |||||||
routeActionLog | 配信する | |||||||
vehicleInfo | 配信する | |||||||
Fused Location | 配信する | 配信する | ||||||
Gnss | 配信する | 配信する | ||||||
Sensor (加速度・ジャイロ) | 配信する | 配信する | ||||||
Activity | 配信する | 配信する |
配信データ量
配信するデータと配信サイズの目安を以下に示します。
データ名 | 配信サイズの目安 (Byte/分) | 通信量算出の想定 (配信周期60秒) | 備考 |
---|---|---|---|
GNSS | 12907 | データ発生1秒ごと | Androidのみ |
FusedLocation | 9113 | データ発生1秒ごと | |
Sensor(加速度・ジャイロ) | 10589 | データ発生1秒ごと | |
Activity | 7080 | データ発生1秒ごと | |
NaviInfo | 34072 | データ受領1秒ごと | |
RouteActionLog | 61 | データ受領 10回/日 | ナビルート操作により増減 |
VehicleInfo | 4 | データ受領 2回/日 |
目安 | 通信量 |
---|---|
1分間当たり | 約18.2KByte |
1か月当たり | 約32MByte |
※ 1か月の想定:1日80分間利用。1か月の走行日数22日間。
配信動作
配信周期の設定範囲は、1秒間~10分間です。( デフォルトは60秒間 )
SDK内部の配信動作は以下の設定 ( Table.4.3.4 ) に基づき動作します。
配信時のリトライに関する項目 | 説明、値 |
---|---|
Httpコネクトタイムアウト | 10秒 |
Readタイムアウト | 10秒 |
Writeタイムアウト | 10秒 |
配信成功基準 | レスポンスのステータスコードが200番台である |
配信失敗時リトライ回数 | 2回 |
リトライ超過時の動作 | [iOS] 次回のタイミングで配信する。(ただし、各データの蓄積可能時間内に限る) [Android] データ破棄。 |
※本リトライ処理は、端末動作のためのものであり、クラウドの動作不具合を考慮したものではありません。
配信データの配信先
配信データは、パイオニア管理のクラウドサーバへ配信します。
具体的にはAmazon AWSクラウドで、Amazon S3の任意のフォルダです。以下の例を参照してください。
-
保存先のパス(S3 URI)
s3://pia-stg-situationawareness-lbs-archive/tmp/archive/company_id=PEC/version=0_0_0/year=yyyy/month=mm/day=dd/
※yyyy/mm/dd はそれぞれ 年/月/日
-
保存形式
parquet
-
データ形式
JSON
配信データの一時保存
配信に失敗した際にデータを保証するため、収集したデータを一時的に蓄積しています。
SDK内のデータ蓄積にはRingBuffer構造を用いています。
各データごとの、バッファ個数、サンプリング時間、蓄積可能時間は下記 ( Table.4.3.5 ) を参照してください。
データ | RingBuffer個数 | サンプリング周期 | 蓄積可能時間 |
---|---|---|---|
GNSS (Androidのみ) | 1200 | 1[s] | 1200[s] |
Fused Location | 1200 | 1[s] | 1200[s] |
Sensor (Accelerometer,Gyroscope) | 1200 | 1[s] | 1200[s] |
Activity | 1200 | 1[s]※ | 1200[s] |
NaviInfo | 100 | アプリから受領 | --- |
RouteActionLog | 100 | アプリから受領 | --- |
VehicleInfo | 1 | アプリから受領 | --- |
※ Androidの場合は、Activityが変化した時にのみデータを収集します。このためサンプリング周期は1[s]とはなりません。