GTFS リアルタイム データを提供する際に、連続するフィード更新の間に欠落があると、ユーザーが Google マップで該当する結果を表示したときに、望ましくない影響が表れる可能性があります。
GTFS リアルタイム データを提供するときは、次の点に注意してください。
- エンティティ（アラート、ルートの更新情報、車両位置情報）は、ユーザーとの関連性がなくなった場合にのみ GTFS リアルタイム フィードから削除してください。
- フィードのタイムスタンプには、フィードが最後に更新された時刻を反映する必要があります。
- エンティティのタイムスタンプ（ルート更新情報と車両位置情報）には、そのエンティティのデータが最後に更新された時刻を反映する必要があります。
フィードが上記のガイドラインに準拠していれば、次のような問題は発生しません。ただし、上記のガイドラインが守られていない場合は、次の動作に注意してください。
後続のフィード更新でメッセージが破棄される
この場合、現在のフィードにルート、停車地、経路のアラート、ルート更新情報、ルートの車両位置情報を示すメッセージが含まれていますが、次のバンドルで該当エンティティが破棄されます。フィードタイプと状況ごとに、次の動作に注意してください。
重要:
- Google では、GTFS リアルタイム フィードへの個々の更新を、すべての関連情報の完全なスナップショットとみなします。その後フィードを更新すると、以前のフィードのすべての情報が完全に上書きされます。以前のフィードにあるメッセージがフィードの最新の更新に存在しない場合、そのメッセージがその後のフィードの更新で復元されない限り、その特定のエンティティのリアルタイム データは表示されません。
- この動作は、パートナー ダッシュボードの手動アラート セクション（各更新が付加される）を使用する場合とは多少異なります。
アラート
情報アラートが破棄される
影響: 大
フィードの更新と更新の間にアラート エンティティが破棄されると、それまであったアラートが Google マップのユーザーに対して表示されなくなります。
effect の値が NO_SERVICE のアラートが破棄される
影響: 大
effect が NO_SERVICE のアラートでは、Google マップでエンドユーザーに別に表示される「運行中断」セクションで影響を受けるルートの優先順位が下がります。
前述の更新後も、フィードの更新と更新の間にこのようなアラート メッセージが破棄された場合、前述の動作のほかにも、以前に優先順位を下げられていたルートが、それまでのキャンセルのアラートに関する情報なしに、通常の検索結果として表示されます。
ルート更新情報
ScheduleRelationship の値が CANCELLED のルート更新情報が破棄される
影響: 大
キャンセルされたルートは、Google マップのルート検索結果から削除されます。ただし、ScheduleRelationship が cancelled のメッセージがフィードの更新と更新の間に破棄されると、以前にキャンセルされたルートが、キャンセルされなかったかのように、リアルタイム情報なしでユーザーに再度表示されます。
これにより、利用者が、到着しない車両の到着を待つことになる可能性があります。
ScheduleRelationship の値が ADDED の Trip Update エンティティが破棄される
影響: 大
ルートの ScheduleRelationship を ADDED に設定すると、既存の静的データに加えて、追加のサービスがルート検索結果に表示されるようになります。そのようなルート更新情報が破棄された場合、このルートはユーザーに表示されなくなります。
その結果、この追加のサービスはユーザーに認識されません。
ScheduleRelationship 値が SCHEDULED の Trip Update エンティティが破棄される
影響: 中
それ以前の更新では、このルートで UI 要素を使用して、到着時刻と出発時刻がリアルタイムで更新されることをユーザーに示していました。この場合、これらの UI 要素は非表示になり、結果はリアルタイムの情報なしで表示されます。
これにより、ユーザーがバス停に到着するのが早すぎたり、遅すぎて乗車できなくなる可能性があります。
停車地をスキップする StopTimeUpdate を持つ Trip Update エンティティ
影響: 大
停車地がスキップされることを示していた StopTimeUpdate が破棄された場合、この停車地付近のユーザーが、この駅または停留所から乗車するように案内される可能性があります。
これにより、ユーザーが、停車しない車両の到着を待つことになる可能性があります。
車両位置情報
車両位置情報 SCHEDULED エンティティが破棄される
影響: 大
以前のバンドル更新では、UI によって地図上のバスの物理的な位置が反映されており、到着予測と出発予測もエンドユーザーに表示されていました。
特定のルートの SCHEDULED の車両位置情報が破棄されると、車両の位置情報と到着時間および出発時刻の予測の両方が Google マップに表示されなくなります。
結果として、静的データから到着時間のみが表示されるため、実際の状況が反映されない場合があります。
車両位置情報 ADDED エンティティが破棄された
影響: 大
以前のバンドルの更新では、新しいルートが、ベースとなる静的な GTFS フィードに含まれていないルート検索結果に、車両の位置情報ならびに到着時刻と出発時刻の予測とともに反映されていました。
特定のルートの ADDED 車両位置情報が破棄されると、静的な GTFS に存在しないルートも検索結果に表示されなくなります。
これにより、追加されたサービスがユーザーに認識されなくなります。
連続するバンドルで最新でないデータが繰り返される
重要:
- フィード全体の更新が現在時刻から 15 分以内に更新されない場合、リアルタイム検証レポートに TIMESTAMP_PAST の警告が表示されます。ただし、フィードは引き続き処理されます。
- フィードが最新でない状態が続くと、このセクションに記載されている動作の一部が発生することがあります。発生する動作はフィードの種類によって異なります。
アラート
FeedHeader メッセージのタイムスタンプ フィールドが最新ではない
影響: 小
最新でないアラートデータに effect がありません。この古いアラートが存在しない更新が提供されない限り、このアラートは処理され続けます。ルート更新情報や車両位置情報などのアラートは頻繁に更新する必要がないため、アラート フィードを最大で 1 週間更新しなくても問題ありません。ただし、Google マップのユーザーに最新のアラートをお届けできるよう、少なくとも 10 分ごとにアラート フィードを更新することをおすすめします。
アラート フィードが 1 週間以上更新されていない場合は、乗換案内チームからフィードの更新をリクエストされることがあります。この期間を過ぎてもフィードが更新されない場合、アラート フィードが無効になる可能性があります。
ルート更新情報
FeedHeader メッセージのタイムスタンプ フィールドが最新ではない
影響: 大
フィードのタイムスタンプが更新されずに 1 時間が経過すると、フィードは最新でないとみなされ、フィード全体が破棄されます。リアルタイム データがエンドユーザーに反映されることはありません。詳しくは、連続するバンドルで更新が破棄される: ルート更新情報をご覧ください。
ルート更新情報のタイムスタンプ フィールドが、フィードが取得された時点よりも常にずっと古くなっている
影響: 大
フィード取得が複数回行われると、特定のルート更新情報のタイムスタンプはフィード取得時刻と大きく異なります。これは Google がフィードを取得する時刻であり、フィードのタイムスタンプではありません。時間差が改善されない限り、このルートのルート更新情報は破棄されます。
この結果の UI では、ルート更新情報がフィードにまったく存在しないものとみなされます。詳しくは、連続するバンドルで更新が破棄される: ルート更新情報をご覧ください。
車両位置情報
FeedHeader メッセージのタイムスタンプ フィールドが最新ではない
影響: 大
フィードは破棄されます。詳しくは、連続するバンドルで更新が破棄される: 車両位置情報をご覧ください。
個々の VehiclePosition メッセージの Timestamp フィールドが最新ではない
影響: 大
タイムスタンプ フィールドに含まれるタイムスタンプから 15 分が経過すると、VehiclePosition メッセージは最新でないとみなされます。これにより、VehiclePosition 情報が破棄されます。詳しくは、連続するバンドルで更新が破棄される: 車両位置情報をご覧ください。
このルートのエンティティが後で復元された場合でも、以前のエンティティによる位置データは、到着時刻と出発時刻の計算に使用されます。
連続するバンドルが最新でないデータのタイムスタンプを更新する
この場合、フィードでは古い情報が繰り返されますが、フィード自体またはフィード内のエンティティのタイムスタンプが更新されます。
FeedHeader タイムスタンプ フィールドが更新されているが、フィードに最新でないデータが含まれている
影響: 中
個々のエンティティ情報が変更されていない場合、すぐに影響はありません。フィードは通常どおり解釈されます。ただし、時間の経過とともにデータがさらに古くなるため、個々のエンティティが破棄される可能性が高くなります。
VehiclePosition エンティティのタイムスタンプ フィールドを更新したが、位置データが最新でない
影響: 大
この場合、エンティティが古い位置データを含んでいるにもかかわらず、車両の位置情報の timestamp フィールドが更新されました。 timestamp が更新されているため、指定されたタイムスタンプで車両が移動していないことを示す新しい更新とみなされます。
ほとんどの場合、これは車両の位置に基づいて計算される到着時刻と出発時刻の予測に悪影響を及ぼします。車両が動いておらず、遅れて運行している可能性があるとみなされるためです。これは、このルートの今後の予測にもマイナスの影響を及ぼします。将来のルートに対する予測にもマイナスの影響を及ぼす可能性があります。
車両が実際に移動していない場合は問題ありません。実際は移動している場合、エンドユーザーには不正確なデータが表示され、到着時刻の予測の精度に悪影響を及ぼします。
新しいバンドルがアップロードされていない
影響: 中
この場合、バンドルがアップロード（取得ではなくプッシュ）されていますが、新しいバンドルが長時間アップロードされていません。
フィードによっては、関連するエンティティがすべて古いとみなされるまで、最後にアップロードしたフィード メッセージが引き続き処理されます。
- アラートが古いとみなされることはなく、関連するフィード エンティティが存在しない新しいフィードがアップロードされるか、フィード自体が無効になるまで引き続き表示されます。
- ルート最新情報は 1 時間経つと古いとみなされ、その間は古い情報がユーザーに表示される可能性があります。
- 車両位置情報は 15 分経つと古いとみなされます。