注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
地理時系列は、サンフランシスコからニューヨーク市へ飛行する飛行機のように、時間の経過に伴うエンティティの位置の変化をモデル化するために使用します。データにタイムスタンプ、位置、または一意に識別できる系列 IDが含まれていない場合、地理時系列はユースケースに適していない可能性があります。
地理時系列の同期の各行は、Pipeline Builder で同期を作成するときに定義される同じスキーマに従います。スキーマには、最低限、次の_必須_フィールドが含まれます。
| 列 | データ型 | 説明 |
|---|---|---|
| 系列 ID | String | [必須] 地理時系列参照（GTSR）によって参照される一連の観測の識別子です。長さは1文字以上100文字以下である必要があります。 |
| タイムスタンプ | Timestamp | [必須] センサーから観測が発行された時刻です。イベントタイムスタンプとも呼ばれます。 |
| 位置 | GeoPoint | [必須] 観測の緯度と経度の座標です。 |
| 高度 | Double | [任意] 地表からの観測の高さ（メートル単位）です。レンダリングに必要な場合、高度は楕円体高（HAE、メートル単位）とみなされます。 |
飛行機が報告する方位や速度など、追加のデータが観測とともに記録されることもよくあります。地理時系列では、これらの追加のデータポイントを、必須の地理時系列の列とともに記録できます。
地理時系列の同期では、移動するエンティティの観測をグループ化するための系列 IDを選択する必要があります。入力データには、観測間で変わらない、そのエンティティの識別子を含める必要があります。そのような識別子がない場合は、たとえば便名、出発地、宛先、日付を連結して、データから識別子を作成できます。系列 ID に日付を含めることで、複数日にわたるフライトが1つの系列に関連付けられるのではなく、各日のフライトが別々の系列として扱われます。
系列 ID は、その系列に関連する最新の地点、トラック、およびその他のプロパティを取得するために使用されます。系列 ID が競合すると、地図のレンダリング品質が低下したり、データが不正確になったりします。
速度や方位など、地理時系列スキーマのプロパティは、デフォルトですべて「ライブ」です。つまり、観測ごとに変化することが想定されています。通常、飛行機のコールサインや旗のような、変化しない「静的」プロパティは、地理時系列自体のプロパティではなく、地理時系列オブジェクトタイプに配置する必要があります。まれに、検索ワークフローを実現するために、静的プロパティを非正規化して観測に含めることが有用な場合があります。これに対応するには、地理時系列のプロパティを「ライブ」ではなく「静的」に指定します。これにより、トラックの圧縮やダウンサンプリングの際に、そのプロパティを「ライブ」プロパティより低い頻度でサンプリングできることが、Foundry の地理時系列データベースに伝わります。このような「静的」プロパティも、観測間で変化しない場合であっても、入力されるすべての観測で指定する必要があります。