設定動態饋給

以下資訊可協助你正確設定及執行動態饋給。

代管動態饋給檔案

Waze 內容擷取系統會定期自動擷取動態饋給資料。為確保 Waze 擷取正確的動態饋給檔案,請按照下列步驟操作:

  • 確保可存取:使用標準網路通訊協定 (HTTP、HTTPS、FTP 或 SFTP),或 Google Cloud Storage (GCS)。
  • 保護資料 (選用):
    • 你可以透過 HTTPS 使用基本驗證,以使用者名稱和密碼保護動態饋給。你可以在合作夥伴中心提供登入和密碼組合。
    • 此外,我們也支援透過 KeyID 或 OCP_APIM_SUBSCRIPTION_KEY 標頭,使用標頭式驗證的 API 整合。
    • 如果是 GCS 檔案,您可以將存取權授予我們提供的服務帳戶。
  • 確保可存取:確認代管檔案可供全球存取。
    • 為避免資料擷取作業中斷,請確保防火牆不會根據國家/地區、IP 位址或地理區域封鎖存取權。這些限制可能會導致我們無法擷取動態饋給資料。
    • 我們會使用動態系統擷取關閉和事件資訊,因此不會使用靜態 IP,也不支援預先授權的網址/網域/萬用字元,或 DNS 項目授權。

動態消息頻率

內容擷取系統每隔幾分鐘就會擷取資料。如果對動態消息頻率有特殊要求,請在提交動態消息時新增附註,指出這項要求,或與 Waze 團隊聯絡,我們會調整輪詢週期,以反映你的動態消息更新週期。

XML 驗證

Waze 使用下列 XML 結構定義,定義可接受的「封閉和事故動態饋給規格」(CIFS) 動態饋給結構: https://www.gstatic.com/road-incidents/cifsv2.xsd

網路上有許多工具可協助您驗證 XML 動態饋給的結構。這類行為包括但不限於:

動態饋給重大異動

進行下列任何變更前,請先填寫這份表單通知 Waze 團隊,並在入口網站中編輯要求,找出更新後的動態饋給。

  • 在動態消息中修改、新增或移除國家/地區。
  • 更新動態饋給網址或存取資訊所需的任何憑證。
  • 變更動態饋給結構或標記名稱。

動態饋給規格

單一動態消息檔案可提供多起封閉和事故的資訊。如要提供多起事件的資訊,每起封閉或事故都必須在個別元素中詳細說明,且必須有專屬 ID。這些部分應使用當地時間和日期。CIFS 規格詳細說明瞭可用於描述事故和封閉的所有標記。