CIFS (Quy cách nguồn cấp dữ liệu về sự cố và đường bị đóng) là giao thức tiêu chuẩn của Waze để mô tả Sự cố và Đường bị đóng trong nguồn cấp dữ liệu của Đối tác.
Bảng tham số bên dưới phân loại từng phần tử như sau:
- Bắt buộc: Nếu không có giá trị được định dạng đúng cho một thẻ bắt buộc, thì nguồn cấp dữ liệu của bạn sẽ được coi là không hợp lệ.
- Được yêu cầu: Mặc dù không bắt buộc về mặt kỹ thuật, nhưng thẻ được yêu cầu vẫn được coi là thẻ nên dùng.
- Không bắt buộc: Các thẻ không bắt buộc cho phép bạn cung cấp thêm dữ liệu.
Thứ tự của các phần tử không quan trọng đối với công cụ phân tích cú pháp tệp.
Các thẻ đó có thể mô tả Sự cố hoặc Đường bị đóng theo giá trị của thẻ type. Chúng tôi sẽ giải thích những điểm khác biệt nhỏ (nếu có).
Dưới đây là một số ví dụ về Đường bị đóng trong nguồn cấp dữ liệu Dưới đây là một số ví dụ về Sự cố trong nguồn cấp dữ liệu Xin lưu ý rằng bạn có thể kết hợp Đường bị đóng và Sự cố trong cùng một tệp nguồn cấp dữ liệu.
Các phần tử CIFS
Phần tử Bắt buộc Đầu vào thẻ Mô tả mã sự cố Bắt buộc Văn bản tự do
Chỉ định một giá trị nhận dạng bằng chữ và số hoặc bằng số. Mã nhận dạng phải là duy nhất trong nguồn cấp dữ liệu của bạn và giữ nguyên trong suốt thời gian xảy ra sự cố.
<incident id=”LND11DEayKr”>…</incident> loại Bắt buộc Một trong các mã sau: ROAD_CLOSED ACCIDENT HAZARD POLICE CHIT_CHAT JAM
Loại này sẽ xác định cách ứng dụng Waze sử dụng sự kiện của bạn. ROAD_CLOSED sẽ dẫn đến việc đóng hoàn toàn.
Tất cả các loại khác sẽ xuất hiện trên bản đồ Waze và sẽ kích hoạt thông báo bật lên cho những người dùng Waze ở gần, nhưng sẽ không ảnh hưởng trực tiếp đến việc định tuyến.
<type>ROAD_CLOSED</type> loại phụ Ðã yêu cầu Xem danh sách các loại phụ được phép
Nội dung mô tả chính xác hơn về loại sự cố được báo cáo. Loại phụ phải khớp với giá trị được cung cấp trong thẻ loại. Sau đây là danh sách đầy đủ các loại phụ được phép theo từng loại
polyline Bắt buộc Danh sách các cặp lat lon được phân tách bằng dấu cách
Toạ độ vĩ độ và kinh độ theo Độ thập phân (DD, phép chiếu SRID 4326) mô tả vị trí của sự cố hoặc đường bị đóng. Lý tưởng nhất là các giá trị này phải có ít nhất 6 chữ số sau dấu thập phân để đảm bảo độ chính xác.
Thứ tự của các toạ độ phải phản ánh hướng của lưu lượng truy cập bị ảnh hưởng.
Chúng tôi không thể suy ra hướng lưu lượng truy cập từ một điểm duy nhất. Nếu sự cố chỉ ảnh hưởng đến một chiều lưu thông, bạn nên cung cấp thêm một toạ độ để làm rõ hướng.
Đường nhiều đoạn sau đây sẽ ảnh hưởng đến một hướng lưu lượng truy cập (thêm phần tử direction để ảnh hưởng đến cả hai hướng):
<polyline>51.510090 -0.006902 51.509142 -0.006564 51.506291 -0.003640 51.503796 0.001051 51.499218 0.001687 51.497365 0.002020</polyline> chỉ đường Ðã yêu cầu BOTH_DIRECTIONS hoặc ONE_DIRECTION
Cho biết liệu tình trạng gián đoạn hoặc đóng đường có ảnh hưởng đến một hay cả hai chiều lưu thông trên đường.
Bạn nên cung cấp một hướng đi, ngay cả khi bạn cung cấp một đường nhiều đoạn. Nếu chỉ có thể cung cấp một bộ toạ độ, bạn phải điền trường hướng để đảm bảo sự kiện xuất hiện theo đúng hướng lái xe.
<direction>BOTH_DIRECTIONS</direction> đường phố Bắt buộc Văn bản tự do
Chỉ định tên của đường phố hoặc đường nơi sự kiện đang diễn ra.
<street>NW 12th St</street> starttime Bắt buộc yyyy-MM-dd’T’HH:mm:ss+HH:mm
Chỉ định ngày giờ bắt đầu cho một khoảng thời gian gián đoạn. Bạn có thể bỏ qua tham số này đối với những sự cố không thuộc loại ROAD_CLOSED và chúng tôi sẽ giả định rằng sự cố hiện đang diễn ra.
Dấu thời gian phải ở định dạng ISO8601, có độ chi tiết đến từng giây và bao gồm cả độ lệch múi giờ.
<starttime>2023-04-07T09:00:00+01:00</starttime> endtime Ðã yêu cầu yyyy-MM-dd’T’HH:mm:ss+HH:mm
Chỉ định ngày giờ kết thúc bằng định dạng ISO8601 với độ chi tiết là giây và thêm độ lệch múi giờ
Nếu bạn bỏ qua thông tin này, thì theo mặc định, thời gian sẽ là 14 ngày sau thời gian bắt đầu.
<endtime>2023-04-07T23:00:00+01:00</endtime> mô tả Ðã yêu cầu Văn bản tự do
Nguyên nhân gây gián đoạn giao thông. Nội dung mô tả này không được dài quá 40 ký tự. Nội dung mô tả dài hơn 40 ký tự sẽ được chấp nhận, nhưng có thể không hiển thị đúng cách trong ứng dụng Waze.
<description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> tác động của làn đường tùy chọn thông tin có cấu trúc về tác động của làn đường Chỉ cung cấp dữ liệu về tác động đến làn đường nếu sự cố không phải là đường bị đóng hoàn toàn và ảnh hưởng đến một chiều giao thông.
Cung cấp thông tin về tất cả các làn đường bằng cách chỉ định một mảng làn đường, sử dụng định dạng làn đường WZDx hoặc định dạng tương tự. Bạn có thể cung cấp thông tin về tác động của làn đường theo 2 định dạng: đầy đủ và một phần.
Ví dụ về định dạng đầy đủ:<order>1</order> biểu thị làn đường bên trái cùng.
<lanes> <lane> <order>1</order> <type>LANE</type> <status>CLOSED</status> </lane> <lane> <order>2</order> <type>LANE</type> <status>OPEN</status> </lane> </lanes> Ví dụ về định dạng một phần:<lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> lịch biểu Không bắt buộc <dayname>hh:mm-hh:mm</dayname>
Đóng gói tất cả ngày và giờ bắt đầu và kết thúc của sự cố.
<schedule> <monday>09:00-11:00,17:00-21:00</monday> <thursday>09:00-11:00,17:00-21:00</thursday> <friday>09:00-11:00,17:00-21:00</friday> <saturday>00:00-05:00</saturday> <sunday>09:00-18:00</sunday> </schedule>
Loại phụ của Sự cố và Lệnh đóng cửa
Cung cấp thêm thông tin chi tiết về tính chất của sự cố. Các loại phụ được chấp nhận do loại được cung cấp xác định.
Loại Các loại phụ có thể có ACCIDENT ACCIDENT_MINOR ACCIDENT_MAJOR HAZARD HAZARD_ON_ROAD HAZARD_ON_ROAD_CAR_STOPPED HAZARD_ON_ROAD_CONSTRUCTION HAZARD_ON_ROAD_EMERGENCY_VEHICLE HAZARD_ON_ROAD_ICE HAZARD_ON_ROAD_LANE_CLOSED HAZARD_ON_ROAD_OBJECT HAZARD_ON_ROAD_OIL HAZARD_ON_ROAD_POT_HOLE HAZARD_ON_ROAD_ROAD_KILL HAZARD_ON_ROAD_TRAFFIC_LIGHT_FAULT HAZARD_ON_SHOULDER HAZARD_ON_SHOULDER_ANIMALS HAZARD_ON_SHOULDER_CAR_STOPPED HAZARD_ON_SHOULDER_MISSING_SIGN HAZARD_WEATHER HAZARD_WEATHER_FLOOD HAZARD_WEATHER_FOG HAZARD_WEATHER_FREEZING_RAIN HAZARD_WEATHER_HAIL HAZARD_WEATHER_HEAT_WAVE HAZARD_WEATHER_HEAVY_RAIN HAZARD_WEATHER_HEAVY_SNOW HAZARD_WEATHER_HURRICANE HAZARD_WEATHER_MONSOON HAZARD_WEATHER_TORNADO ROAD_CLOSED ROAD_CLOSED_HAZARD ROAD_CLOSED_CONSTRUCTION ROAD_CLOSED_EVENT JAM JAM_LIGHT_TRAFFIC JAM_MODERATE_TRAFFIC JAM_HEAVY_TRAFFIC JAM_STAND_STILL_TRAFFIC POLICE POLICE_VISIBLE POLICE_HIDING POLICE_WITH_MOBILE_CAMERA
