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 thậ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:

  • Giúp tệp có thể truy cập được: Sử dụng các giao thức mạng tiêu chuẩn (HTTP, HTTPS, FTP hoặc SFTP) hoặc Google Cloud Storage (GCS).
  • 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 của mình bằng tên người dùng và mật khẩu bằng cách sử dụng phương thức xác thực BASIC qua HTTPS. Bạn cung cấp tổ hợp tên đăng nhập và mật khẩu thông qua Trung tâm đối tác.
    • Ngoài ra, chúng tôi hỗ trợ các tính năng tích hợp API sử dụng phương thức xác thực dựa trên tiêu đề thông qua tiêu đề KeyID hoặc OCP_APIM_SUBSCRIPTION_KEY.
    • Đối với các tệp GCS, bạn có thể giới hạn quyền truy cập vào Tài khoản dịch vụ mà chúng tôi sẽ cung cấp.
  • Đảm bảo khả năng truy cập: Đảm bảo tệp được lưu trữ có thể truy cập được trên toàn cầu.
    • Để tránh làm 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 hạn chế này có thể khiến chúng tôi không truy xuất được 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 động để thu thập thông tin về việc đóng cửa và sự cố. Đ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 nguồn cấp dữ liệu

Hệ thống thu thập nội dung sẽ tìm nạp dữ liệu sau vài phút. Nếu bạn có các yêu cầu đặc biệt về tần suất nguồn cấp dữ liệu, hãy thêm một 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ò để phản ánh chu kỳ cập nhật nguồn cấp dữ liệu của bạn.

Kiểm tra XML

Waze sử dụng lược đồ XML sau đây để xác định cấu trúc chấp nhận được của nguồn cấp dữ liệu Quy cách nguồn cấp dữ liệu về việc đóng cửa và sự cố (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. Các công cụ này bao gồm nhưng không giới hạn ở:

Các thay đổi quan trọng về 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á các khu vực hoặc quốc gia khỏi nguồn cấp dữ liệu của bạn.
  • Cập nhật URL nguồn cấp dữ liệu hoặc mọi thông tin đăng nhập 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à việc đóng cửa. Nếu bạn cung cấp thông tin về nhiều sự kiện, thì mỗi sự cố hoặc việc đóng cửa phải được nêu chi tiết trong một phần tử riêng và phải có một Mã nhận dạng duy nhất. Các phần này phải sử dụng thời gian và ngày địa phương. Quy cách CIFS nêu chi tiết tất cả các thẻ có sẵn để mô tả sự cố và việc đóng cửa.