重要: VehiclePosition フィードを使ってリアルタイムのルート情報を提供するには、TripDescriptor を使ってルートを選択するをご覧ください。
VehiclePosition フィードを使用すると、特定のルートを進行する交通機関の車両のステータスについてリアルタイムのルート情報を提供できます。
車両の状況の最新情報を取得する
vehicle_position
メッセージで、特定のルートの車両の状況に関する最新情報を提供できます。
ルートに割り当てられている車両の場合: VehiclePositions フィードに、マッチした TripDescriptor、正確な position
情報、位置が測定された時点の timestamp
を設定します。
VehiclePosition メッセージを使用するには、以下を設定します。
- 読み取り時の
timestamp
を含む、車両の最新のposition
trip descriptor
vehicle descriptor
以降のすべての停留所では、予測アルゴリズムを使用して、現在地に基づいてバス到着予定時刻が予測されます。この情報は、アプリでユーザーに表示され、検索結果にも反映されます。
車両位置情報などの最新情報が利用できない場合は、最後に確認された位置などのデータが、その位置が測定された時点の timestamp
とともに提供されます。詳しくは、データの欠落がリアルタイム フィードに与える影響をご覧ください。
VehicleDescriptor は、ルートを進行する車両をトラッキングするために必要です。フィードごとに固有であり、ルートの間は安定している必要があります。車両をトラッキング可能にするには、車両記述子 id
を提供します。
コードの例:
vehicle_position {
trip {
route_id: "route1"
direction_id: "0"
start_time: "10:10:00"
start_date: "20160203"
}
vehicle {
id: "route1-v1"
}
position {
latitude: 4066265190
longitude: 3862204692
}
timestamp: 1458508943
}
}
固定の運行スケジュールの場合、実際の遅延が表示されます。
運転時隔ベースのスケジュールの場合、次のルートの到着時刻が遅延情報なしで表示されます。
vehicle_position
メッセージの位置とともに、occupation_status
フィールドを使用します。これは、UI に画像インジケーターとして表示されます。
コードの例:
vehicle {
trip {
trip_id: xxx
start_time: 12:34:56
...
occupancy_status: CRUSHED_STANDING_ROOM_ONLY
}
}
詳しくは、GTFS を使って乗車率データを提供するをご覧ください。
VehiclePosition フィードを使って更新すると、Google マップ上に車両のリアルタイムの位置情報が表示されます。