公共交通機関の運行スケジュールに関する情報を正確に保つには、静的フィードを最新の状態に保つ必要があります。
継続的な運行期間を維持する
フィードの有効期限が近づくとメールが届きますので、運行期間が延長された新しいフィードをアップロードすることをおすすめします。このようなメールを確実に受信できるよう、乗換案内パートナー ダッシュボードにアクセスし、通知を設定してください。
自動延長機能を使用すると、期限切れの静的フィードの終了日が自動で延長されます。これにより、有効期限が近い運行を継続することができます。
フィードの有効期間
静的フィードを最新の状態に保つために、次の方法をおすすめします。
必ずフィードの日付を指定する
フィードの開始日と終了日は、feed_info.txt の feed_start_date と feed_end_date に基づきます。運行期間の意図しない空白または延長を避けるため、feed_start_date と feed_end_date の両方が feed_info.txt ファイルで明示的に指定されていることを確認してください。
feed_end_date が明示的に入力されていないものの、有効期限に近い場合は、フィードの個々の運行日に基づいて終了日が推定されます。feed_start_date と feed_end_date の間の日数が 28 日以上になるようにする
運行期間は、Google 乗換案内でデータを利用できるようになった日と feed_start_date のどちらか遅いほうから 4 週間以上にする必要があります。
calendar.txt を定期運行に使用する
重要: 定期運行には通年運行が含まれますが、これに限定されません。定期運行は長期間にわたって実施できます。定期運行を定義するには、calendar.txt ファイルを使用します。通常のスケジュールの例外を定義する場合は、calendar_dates.txt のみを使用します。ただし、長期間の運行を定義する場合は calendar_dates.txt を使用しないでください。
feed_end_date までにフィードが更新されない場合は、継続的な運行を保つために、終了日を過ぎてもフィードが自動的に延長される可能性があります。詳しくは、自動延長機能の項目をご覧ください。
自動延長はあくまでも手動による更新が行われなかった場合の手段ですので、これによりスケジュールが最新ではなくなる場合があります。運行スケジュールを最新の状態に保つには、余裕を持って feed_end_date の前にフィードを更新してください。
運行期間の空白を回避する
calendar_txt の運行情報が、feed_start_date より後に開始、または feed_end_date より前に終了するように設定されていると、運行期間に空白が生じる可能性があります。
calendar.txt の運行期間の開始日が feed_start_date より後の場合、臨時運行または季節限定の運行を意図的に遅く開始したものとして扱われます。calendar.txt の運行期間の終了日が feed_end_date の 1 週間以上前である場合、臨時運行または季節限定の運行の意図的な終了として扱われます。
calendar.txt の運行期間の終了日とフィードの終了日の差が 1 週間未満の場合、運行を継続するか停止するかは Google 独自の基準によって決まります。
季節限定の運行または臨時運行を意図的に終了するには、フィードの終了日と calendar.txt の終了日の差が 1 週間以上になるように調整します。運行終了日まで日数に余裕がある場合は、運行期間を延長してフィードを更新することもできます。
feed_end_date は、calendar.txt ファイルで定義されている有効な運行の終了日より前の日付に設定してください。ただし、この間に利用可能な運行がない場合は除きます。feed_start_date を calendar.txt ファイルで定義されている有効な運行情報の開始日より前の日付に設定する場合も、同じ制限が適用されます。そのように設定した場合、その 2 つの日付に挟まれた期間に空白が生じます。また、空白期間の長さや以前のバージョンでの運行期間の有無に基づいて、フィードが拒否される場合があります。
フィードの有効期限を延長する
重要:
- フィードの有効期限が切れると、Google ではほとんどの運行スケジュールに変更がないと想定し、運行を自動的に延長することがあります。フィードの有効期限の 1 週間以上前に終了した運行は延長されません。
- 期限切れの経路が Google マップの検索結果に表示されない場合は、静的フィードを更新して、新しいバージョンをアップロードしてみてください。自動延長が原因で、通常とは異なる経路検索結果が表示された場合は、Google 乗換案内サポートチームまでお問い合わせください。
自動延長を管理する
自動延長の動作を管理するには、feed_info.txt ファイルで feed_start_date と feed_end_date を定義します。
特定のケース（季節限定の運行など）では、推定された終了日の大多数がフィードの有効期限を正確に反映しない場合があります。このような運行は、最も遅い終了日より前に終了するため、自動延長は行われません。季節限定の運行があり、自動延長をしたくない場合は、feed_end_date を service_end_date より 1 週間以上先にすることをおすすめします。
例
以下に示すのは、冬期限定の経路が 5 つ、通年運行の経路が 1 つ設定されているフィードの例です。
routes.txt:
route_id,route_short_name,route_long_name,route_desc,route_type,route_color
1,,Winter Route,,3,
2,,Winter Route,,3,
3,,Winter Route,,3,
4,,Winter Route,,3,
5,,Winter Route,,3,
a,,Regular Route,,3,
calendar.txt:
service_id,monday,tuesday,wednesday,thursday,friday,saturday,sunday,start_date,end_date
1,1,1,1,1,1,1,1,20211001,20220430
1,1,1,1,1,1,1,1,20211101,20220331
2,1,1,1,1,1,1,1,20211101,20220331
3,1,1,1,1,1,1,1,20211101,20220331
4,1,1,1,1,1,1,1,20211101,20220331
5,1,1,1,1,1,1,1,20211101,20220331
次の表は、このフィードに含まれる開始日と終了日をまとめたものです。
calendar.txt の最も遅い start_date |
20211001 |
calendar.txt の最も遅い end_date |
20220430 |
| 推定された開始日 | 20211101 |
| 推定された終了日 | 20220331 |
feed_info.txt の feed_start_date |
20211001 |
feed_info.txt の feed_end_date |
20220430 |
この設定では、冬期限定の経路（1、2、3、4、5）は 2022 年 3 月 31 日で運行が停止されます。feed_end_date を指定しない場合は、推定された終了日として 2022 年 3 月 31 日が使用され、冬季限定の経路は無期限に延長されます。