Penyiapan Feed
Informasi berikut akan membantu Anda menyiapkan dan menjalankan feed dengan benar.
Hosting file feed
Sistem akuisisi konten Waze secara otomatis mengambil data feed Anda secara berkala. Untuk memastikan Waze mengambil file feed yang benar:
- Buat agar dapat diakses: Gunakan protokol jaringan standar (HTTP, HTTPS, FTP, atau SFTP), atau Google Cloud Storage (GCS).
- Amankan data Anda (opsional):
- Anda dapat mengamankan feed dengan nama pengguna dan sandi menggunakan autentikasi BASIC melalui HTTPS. Anda memberikan kombinasi login dan sandi melalui Hub Partner.
- Selain itu, kami mendukung integrasi API yang menggunakan autentikasi berbasis header melalui header KeyID atau OCP_APIM_SUBSCRIPTION_KEY.
- Untuk file GCS, Anda dapat membatasi akses ke Akun Layanan yang akan kami berikan.
- Pastikan aksesibilitas: Pastikan file yang dihosting dapat diakses secara global.
- Untuk menghindari gangguan dalam pengambilan data, pastikan firewall Anda tidak memblokir akses berdasarkan negara, alamat IP, atau wilayah geografis. Pembatasan ini dapat mencegah kami mengambil data feed Anda.
- Kami menggunakan sistem dinamis untuk menarik informasi penutupan dan insiden. Artinya, kami tidak menggunakan IP statis atau mendukung URL/domain/karakter pengganti yang telah diberi otorisasi sebelumnya, atau otorisasi entri DNS.
Frekuensi feed
Sistem akuisisi konten mengambil data setiap beberapa menit. Jika Anda memiliki persyaratan khusus terkait frekuensi feed, tambahkan catatan yang menunjukkan permintaan ini saat mengirimkan feed, atau hubungi tim Waze agar kami dapat menyesuaikan periode polling untuk mencerminkan siklus pembaruan feed Anda.
Validasi XML
Waze menggunakan skema XML berikut untuk menentukan struktur feed Spesifikasi Feed Penutupan dan Insiden (CIFS) yang dapat diterima: https://www.gstatic.com/road-incidents/cifsv2.xsd.
Ada sejumlah alat yang tersedia di internet yang dapat membantu Anda memvalidasi struktur feed XML. Hal ini mencakup, tetapi tidak terbatas pada:
- http://www.w3.org/XML/Schema#Tools
- http://www.xml.com/pub/a/2000/12/13/schematools.html
- http://xmlsoft.org/xmllint.html
Perubahan feed penting
Sebelum melakukan perubahan berikut, beri tahu tim Waze dengan mengisi formulir ini dan mengedit permintaan Anda di Portal untuk mengidentifikasi feed yang diperbarui.
- Mengubah, menambahkan, atau menghapus wilayah atau negara dari feed Anda.
- Memperbarui URL feed atau kredensial apa pun yang diperlukan untuk mengakses informasi.
- Mengubah struktur feed atau nama tag.
Spesifikasi Feed
Satu file feed dapat memberikan informasi tentang beberapa penutupan dan insiden. Jika Anda memberikan informasi tentang beberapa acara, setiap penutupan atau insiden harus dijelaskan dalam elemen terpisah dan harus memiliki ID unik. Bagian ini harus menggunakan waktu dan tanggal setempat. Spesifikasi CIFS menjelaskan semua tag yang tersedia untuk mendeskripsikan insiden dan penutupan Anda.