Thiết lập nguồn cấp dữ liệu
Thông tin sau đây sẽ giúp bạn thiết lập và chạy nguồn cấp dữ liệu đúng cách.
Lưu trữ tệp nguồn cấp dữ liệu
Hệ thống thu nạp nội dung của Waze sẽ tự động tìm nạp dữ liệu nguồn cấp dữ liệu của bạn theo định kỳ. Để đảm bảo Waze truy xuất đúng tệp nguồn cấp dữ liệu, hãy làm như sau:
- Cho phép truy cập: Sử dụng các giao thức mạng tiêu chuẩn (HTTP, HTTPS, FTP hoặc SFTP).
- Bảo mật dữ liệu của bạn (không bắt buộc): Bạn có thể bảo mật nguồn cấp dữ liệu bằng tên người dùng và mật khẩu thông qua phương thức xác thực BASIC qua HTTPS. Bạn cung cấp tổ hợp thông tin đăng nhập và mật khẩu thông qua Trung tâm đối tác.
- Đảm bảo khả năng hỗ trợ tiếp cận: Đảm bảo rằng tệp được lưu trữ có thể truy cập được trên toàn cầu.
- Để tránh gián đoạn quá trình tìm nạp dữ liệu, vui lòng đảm bảo tường lửa của bạn không chặn quyền truy cập dựa trên quốc gia, địa chỉ IP hoặc khu vực địa lý. Những quy định hạn chế này có thể khiến chúng tôi không thể truy xuất dữ liệu nguồn cấp dữ liệu của bạn.
- Chúng tôi sử dụng một hệ thống linh động để lấy thông tin về sự cố và việc đóng. Điều này có nghĩa là chúng tôi không sử dụng IP tĩnh hoặc hỗ trợ URL/miền/ký tự đại diện được uỷ quyền trước hoặc uỷ quyền mục nhập DNS.
Tần suất của nguồn cấp dữ liệu
Hệ thống thu nạp nội dung tìm nạp dữ liệu vài phút một lần. Nếu bạn có yêu cầu đặc biệt về tần suất của nguồn cấp dữ liệu, hãy thêm ghi chú cho biết yêu cầu này khi gửi nguồn cấp dữ liệu hoặc liên hệ với nhóm Waze để chúng tôi có thể điều chỉnh khoảng thời gian thăm dò ý kiến cho phù hợp với chu kỳ cập nhật nguồn cấp dữ liệu của bạn.
Xác thực XML
Waze sử dụng giản đồ XML sau đây để xác định cấu trúc chấp nhận được của nguồn cấp dữ liệu Thông số kỹ thuật về sự cố và đường bị đóng (CIFS): https://www.gstatic.com/road-incidents/cifsv2.xsd.
Có một số công cụ trên Internet có thể giúp bạn xác thực cấu trúc của nguồn cấp dữ liệu XML. Những trường hợp như vậy bao gồm nhưng không giới hạn ở:
- http://www.w3.org/XML/Schema#Tools
- http://www.xml.com/pub/a/2000/12/13/schematools.html
- http://xmlsoft.org/xmllint.html
Các thay đổi quan trọng đối với nguồn cấp dữ liệu
Trước khi thực hiện bất kỳ thay đổi nào sau đây, hãy thông báo cho nhóm Waze bằng cách hoàn tất biểu mẫu này và chỉnh sửa yêu cầu của bạn trong Cổng thông tin để xác định nguồn cấp dữ liệu đã cập nhật.
- Sửa đổi, thêm hoặc xoá khu vực hoặc quốc gia khỏi nguồn cấp dữ liệu.
- Cập nhật URL nguồn cấp dữ liệu hoặc mọi thông tin xác thực cần thiết để truy cập vào thông tin.
- Thay đổi cấu trúc nguồn cấp dữ liệu hoặc tên thẻ.
Quy cách nguồn cấp dữ liệu
Một tệp nguồn cấp dữ liệu có thể cung cấp thông tin về nhiều sự cố và trường hợp đóng. Nếu bạn cung cấp thông tin về nhiều sự kiện, thì mỗi lần đóng hoặc sự cố phải được nêu chi tiết trong một phần tử riêng biệt và phải có mã nhận dạng duy nhất. Các phần này nên sử dụng ngày và giờ địa phương. Thông số kỹ thuật CIFS nêu chi tiết tất cả các thẻ có sẵn để mô tả các sự cố và trường hợp đóng của bạn.