Quy cách CIFS
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ố.
<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.
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.
|
| 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. Đườ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ử <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ự.
Ví dụ về định dạng đầy đủ: <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 |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|