設定動態饋給
以下資訊可協助你正確設定及執行動態饋給。
代管動態饋給檔案
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 動態饋給的結構。這類行為包括但不限於:
- http://www.w3.org/XML/Schema#Tools
- http://www.xml.com/pub/a/2000/12/13/schematools.html
- http://xmlsoft.org/xmllint.html
動態饋給重大異動
進行下列任何變更前,請先填寫這份表單通知 Waze 團隊,並在入口網站中編輯要求,找出更新後的動態饋給。
- 在動態消息中修改、新增或移除國家/地區。
- 更新動態饋給網址或存取資訊所需的任何憑證。
- 變更動態饋給結構或標記名稱。
動態饋給規格
單一動態消息檔案可提供多起封閉和事故的資訊。如要提供多起事件的資訊,每起封閉或事故都必須在個別元素中詳細說明,且必須有專屬 ID。這些部分應使用當地時間和日期。CIFS 規格詳細說明瞭可用於描述事故和封閉的所有標記。