動態饋給傳送相關規範

本指南說明如何產生微型移動工具動態饋給,並提供給 Google。如要瞭解如何建立動態饋給,請參閱「參考資料」分頁中的規格。

動態消息規範

將產生的微型移動工具動態饋給傳送給 Google 時,請注意下列程序和規範:

  • 確認單車供應情形和動態票價資料 (如適用) 為最新狀態。如要這麼做,你必須每 30 秒將新版動態饋給上傳至 GBFS 動態饋給主機。此外,擷取資料的延遲時間不得超過 30 秒。

  • 如要將動態消息傳送給 Google,你必須支援 HTTP GET。

透過 HTTP GET 傳送動態消息

Google 會透過HTTPS GET要求從設定的位置擷取動態消息,並支援下列驗證方法:

  • HTTP 摘要驗證:如果實作這項功能,請將設定的使用者名稱和密碼透過電子郵件傳送給微型移動裝置合作夥伴支援團隊
  • 自訂 HTTP 標頭欄位:如要支援這項功能,請在向 Google 提出要求時,傳送所需的標頭欄位和值。
  • GET 參數:如需其他 GET 參數,請在透過電子郵件將主機地址傳送給 Micromobility 合作夥伴支援團隊前,先將這些參數加入主機地址。

為在傳輸期間最佳化檔案大小,Google 支援 HTTP 標頭中的 gzip 壓縮。具體來說,Google 會在 HTTP 要求標頭中傳送 Accept-Encoding: gzip, deflate,並接受含有 HTTP 標頭 Content-Encoding: gzip 的回應。

決定主機位置和詳細資料後,請將設定詳細資料以電子郵件傳送給微型機動車輛合作夥伴支援團隊

動態饋給分片

如要分割動態饋給,請將整個動態饋給分成多個不相交的子集。視後端系統、車隊類型和規模而定,可能需要分片。

如要瞭解何時及如何將動態饋給分片,請參閱參考資料部分中的「動態饋給分片」。

Google 會使用相同的機制擷取分片和未分片的動態饋給,如「透過 HTTP GET 傳送動態饋給」一文所述。

決定每個分片的代管位置和詳細資料後,請將每個分片的設定詳細資料,以及分片涵蓋的都會區,透過電子郵件傳送給 Micromobility 合作夥伴支援團隊