Quy cách CIFS
CIFS (Quy cách nguồn cấp dữ liệu về tình trạng đóng và sự cố) là giao thức tiêu chuẩn của Waze để mô tả Sự cố và đường bị đóng trong chương trình của Đối tác nguồn cấp dữ liệu.
Bảng thông số dưới đây phân loại từng phần tử như sau:
- Bắt buộc: Nếu bạn không có giá trị được định dạng đúng cho một thẻ bắt buộc, nguồn cấp dữ liệu của bạn sẽ bị coi là không hợp lệ.
- Đã yêu cầu: Mặc dù về mặt kỹ thuật không bắt buộc, nhưng bạn nên sử dụng thẻ đã yêu cầu.
- 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.
Những khác biệt nhỏ sẽ được giải thích nếu phù hợp.
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ố xảy ra trong nguồn cấp dữ liệu
Hãy nhớ rằng bạn có thể kết hợp Trường hợp đóng cửa và Sự cố trong cùng một tệp nguồn cấp dữ liệu.
Phần tử CIFS
| Phần tử | Bắt buộc | Nhập 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 gồm chữ và số hoặc số.
<incident id="LND11DEayKr">...</incident> |
| loại | Bắt buộc | Một trong các lựa chọn sau:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Loại sự kiện này sẽ xác định cách ứng dụng Waze sẽ sử dụng sự kiện của bạn.
Tất cả các loại khác sẽ hiển thị 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 có tác độ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 cho loại sự cố được báo cáo.
|
| hình nhiều đường | Bắt buộc | Danh sách các cặp lat lon trống được phân tách |
Độ thập phân (DD, phép chiếu SRID 4326) vĩ độ và kinh độ mô tả vị trí của sự cố hoặc đường bị đóng. Tốt nhất là các giá trị này nên 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 giao thông bị ảnh hưởng. Chúng tôi không thể khấu trừ hướng lưu thông từ một điểm duy nhất. Hình nhiều đường sau đây sẽ tác động đến một hướng lưu thông (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 |
Chỉ định liệu sự gián đoạn hoặc bị đóng ảnh hưởng đến một hoặc cả hai hướng lưu thông trên đường hay không. Bạn nên cung cấp hướng, ngay cả khi đã cung cấp hình nhiều đường. Nếu chỉ có thể cung cấp một bộ toạ độ, trường chỉ đường là bắt buộc để đảm bảo rằng sự kiện được hiển thị theo đúng hướng lái xe. <direction>BOTH_DIRECTIONS</direction> |
| đường phố | Bắt buộc | Văn bản tự do | Cho biết tên phố hoặc đường nơi diễn ra sự kiện. <street>NW 12th St</street> |
| thời gian bắt đầu | 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 cho các 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 với độ chi tiết tính bằng giây và có chênh lệch múi giờ. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| thời gian kết thúc | Ðã yêu cầu | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Chỉ định ngày giờ kết thúc bằng cách sử dụng định dạng ISO8601 với độ chi tiết vài giây và bao gồm thông tin chênh lệch múi giờ Nếu bạn bỏ qua thuộc tính này, thì theo mặc định, thời gian bắt đầu sẽ là 14 ngày sau thời gian bắt đầu. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| description | Ðã 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 phải dưới 40 ký tự. Mô tả dài hơn 40 ký tự sẽ được chấp nhận, nhưng có thể không hiển thị chính xác trong ứng dụng Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| tác động đến làn đường | tùy chọn | thông tin có cấu trúc về tác động trên làn đường | Chỉ cung cấp mã này nếu sự cố không dẫn đến việc đường bị đóng hoàn toàn!
Cung cấp thông tin về tất cả các làn đường bằng cách xác định một mảng các 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 từng 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 giờ bắt đầu và ngày 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ụ Sự cố và tình hình đóng cửa
Hãy cung cấp thêm thông tin chi tiết về bản chất của sự cố. Có thể chấp nhận các loại phụ được xác định theo loại được cung cấp.
| Loại | Loại phụ có thể sử dụng |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|