Trang này được dịch bởi Cloud Translation API.

Thông tin về đường bị đóng

Bạn có thể sử dụng nguồn cấp dữ liệu của Đối tác Waze để cung cấp thông tin về việc đóng đường theo kế hoạch và theo thời gian thực một cách tự động và trên quy mô lớn.

Lệnh đóng cửa theo kế hoạch mà bạn gửi đến Waze sẽ xuất hiện trong Trình chỉnh sửa bản đồ của Waze và sẽ xuất hiện trên ứng dụng Waze trong thời gian đóng thực tế.

Chỉ cung cấp đường bị đóng trong trường hợp tất cả các làn đường trên đường đã bị đóng. Nếu đường đóng chỉ ảnh hưởng đến một số làn đường, hãy mô tả các làn đường bị ảnh hưởng trong phần tử tác động đến làn đường.

Để đường đóng hiển thị chính xác trên bản đồ, bạn phải tuân theo các nguyên tắc dưới đây và thông số kỹ thuật của CIFS.

Nếu nguồn cấp dữ liệu của bạn không tuân thủ quy cách của CIFS nhưng chứa tất cả dữ liệu bắt buộc, Waze vẫn có thể xử lý dữ liệu đó. Gửi nguồn cấp dữ liệu của bạn qua Trung tâm đối tác để xác thực và phản hồi.

Trong trường hợp dữ liệu chưa đầy đủ hoặc không tương thích, tuyến đường đóng cửa sẽ không tự động xuất hiện trên bản đồ, nhưng sẽ được gửi tới Cộng đồng người chỉnh sửa của chúng tôi dưới dạng "sự cố bản đồ" để xem xét, phê duyệt hoặc từ chối thủ công.

Chia sẻ trạng thái đóng

1. Chỉ định thẻ đóng

Để lập bản đồ một đường bị đóng, hãy chỉ định ROAD_CLOSED làm dữ liệu đầu vào cho thẻ của phần tử type.

2. Sắp xếp thông tin về trạng thái đóng

Để chia sẻ thông tin về trạng thái đóng cửa qua Waze, hãy chỉ định polyline (bắt buộc) và direction (được yêu cầu).

Hình nhiều đường là chuỗi các toạ độ tuân theo hình học của đường và mô tả đoạn đường cần được đóng.
Thứ tự của toạ độ trong hình nhiều đường cho chúng tôi biết hướng lưu thông bị ảnh hưởng.
direction cho biết đường bị đóng áp dụng cho một hay cả hai hướng lưu thông.

Đối với đường bị đóng trên đường một chiều:

Thứ tự của các điểm trong hình nhiều đường phải khớp với hướng lưu thông.
Để tránh sự không rõ ràng và khắc phục sự khác biệt về bản đồ, bạn nên chỉ định ONE_DIRECTION ngay cả cho đường một chiều.

Đối với trường hợp bị đóng trên đường hai chiều:

Nếu đường bị đóng chỉ ảnh hưởng đến một hướng: thứ tự của các toạ độ trong hình nhiều đường sẽ cho chúng tôi biết hướng lưu thông cần đóng.
Nếu đường đóng ảnh hưởng đến cả hai hướng: chia sẻ hình nhiều đường và trong trường chỉ đường, hãy chỉ ra BOTH_DIRECTIONS.

Đối với hình nhiều đường kéo dài từ điểm A đến điểm B, đường bị đóng sẽ ảnh hưởng đến hướng lưu thông dựa trên hướng và loại đường như bên dưới:

Hình ảnh giải thích hành vi hình nhiều đường và chỉ hướng.

3. Tạo hình nhiều đường

Hình nhiều đường càng giống với hình dạng của con đường, thì càng có nhiều khả năng Waze có thể so khớp chính xác và xử lý việc đóng đường.
Bạn nên cung cấp nhiều điểm cho mỗi đoạn từ toạ độ đầu đến cuối. Chỉ cung cấp 2 toạ độ có thể đủ đối với các đoạn đường ngắn hoặc thẳng, nhưng thường là nguyên nhân gây ra lỗi xử lý.
Hình nhiều đường sau đây giúp giữ nguyên hình dạng chung của con đường:

Hình nhiều đường sau đây không phản ánh rõ ràng hình dạng đường vì nó chỉ cung cấp toạ độ bắt đầu và kết thúc:
Waze sẽ sử dụng hình nhiều đường mà bạn cung cấp để áp dụng sự kiện cho một hoặc nhiều đoạn trên bản đồ Waze. Xin lưu ý rằng đường đóng được áp dụng có thể dài hơn hoặc ngắn hơn một chút so với hình nhiều đường, vì Waze chỉ có thể đóng toàn bộ đoạn đường như được định cấu hình trên bản đồ Waze.
Nếu bạn chỉ định một phần của đoạn để đóng, thì toàn bộ đoạn sẽ bị đóng.
Điểm bắt đầu và điểm kết thúc của một đường đóng cách nhau ít nhất 30 mét.
Chiều dài chặn không được vượt quá 20 km.

4. Đảm bảo rằng thông tin đóng của bạn tuân thủ các nguyên tắc sau:

Tên đường phố
- Các lệnh đóng cửa chỉ có thể ảnh hưởng đến một con phố hoặc con đường trên bản đồ Waze. Toạ độ bắt đầu và kết thúc của đường đóng phải có cùng tên đường. Thông tin đóng cửa được báo cáo trải dài qua các tên đường phố khác nhau có thể sẽ không được xử lý, ngay cả khi hình nhiều đường được cung cấp chính xác.
- Waze sẽ cố gắng khớp tên đường phố bạn cung cấp với tên đường chính hoặc tên đường thay thế trên bản đồ Waze tại vị trí được báo cáo. Việc trùng khớp toàn bộ hay một phần sẽ giúp chúng tôi xác định chính xác đường nào cần đóng, đặc biệt là khi có nhiều ứng cử viên.
  - Ví dụ: I-95S, I-95 Southbound và Đường cao tốc Tưởng niệm JFK đều sẽ được so khớp thành công với cùng một đường.
- Để đảm bảo rằng tên đường và tên đường mà bạn cung cấp trong danh sách khớp với tên trong bản đồ Waze, hãy sử dụng API mã hoá địa lý đảo ngược của Waze hoặc kiểm tra Trình chỉnh sửa bản đồ của Waze.
Bạn chỉ có thể đóng nguồn cấp dữ liệu trên các loại đường Waze sau đây:
- Đường cao tốc
- Đường cao tốc
- Đường phố trong thành phố
- Đường nối
- Đường tư nhân
Sau đây là các loại đường Waze không thể đóng bằng nguồn cấp dữ liệu:
- Đường ở bãi đỗ xe
- Đường địa hình (4 x 4) và đường dành cho người đi bộ

Thời gian bắt đầu và thời gian kết thúc:

Thời gian bắt đầu: Bạn phải cung cấp thời gian bắt đầu cho một đợt đóng cửa. Nếu không chắc chắn về thời gian bắt đầu, bạn có thể sử dụng dấu thời gian của báo cáo ban đầu, nhưng KHÔNG sửa đổi thời gian bắt đầu sau khi xuất bản sự kiện.
Thời gian kết thúc: Nếu bạn không biết thời gian kết thúc, hãy để trống. Các lệnh đóng không có thời gian kết thúc sẽ được chỉ định trong khoảng thời gian mặc định (hiện là 2 tuần). Sau đó, các lệnh đóng này sẽ hết hạn trừ phi được gia hạn rõ ràng bằng cách chỉ định thời gian kết thúc mới. Bạn có thể sửa đổi thời gian kết thúc sau khi xuất bản sự kiện, nhưng tránh đặt thời gian kết thúc một cách linh hoạt dựa trên thời gian hiện tại.

Để biết thêm thông số kỹ thuật chi tiết của thẻ Quy cách nguồn cấp dữ liệu về sự cố (CIFS), hãy xem thông số kỹ thuật của CIFS.

Ví dụ về lệnh đóng

Các ví dụ sau đây minh hoạ một đường bị đóng ở định dạng XML và JSON.

Đóng tệp XML

Sau đây là ví dụ về nguồn cấp dữ liệu chứa một đường bị đóng ở định dạng XML:

<incidents>
  <incident id="101">
    <type>ROAD_CLOSED</type>
    <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
    <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>
    <street>NW 12th St</street>
    <starttime>2016-04-07T09:00:00+01:00</starttime>
    <endtime>2016-04-07T23:00:00+01:00</endtime>
    <description>Closure on I-95 NB due to construction</description>
    <direction>BOTH_DIRECTIONS</direction>
  </incident>
</incidents>

Đóng JSON

Sau đây là ví dụ về tệp nguồn cấp dữ liệu chứa một đường bị đóng ở định dạng JSON:

{
  "incidents": [
    {
      "incident": {
        "id": "101",
        "type": "ROAD_CLOSED",
        "subtype": "ROAD_CLOSED_CONSTRUCTION",
        "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",
        "street": "NW 12th St",
        "starttime": "2016-04-07T09:00:00+01:00",
        "endtime": "2016-04-07T23:00:00+01:00",
        "description": "Closure on I-95 NB due to construction",
        "direction": "BOTH_DIRECTIONS"
      }
    }
  ]
}

Các ví dụ sau đây minh hoạ toàn bộ tệp nguồn cấp dữ liệu về đường bị đóng ở cả định dạng XML và JSON.

Tệp nguồn cấp dữ liệu XML

Sau đây là ví dụ về một tệp nguồn cấp dữ liệu về đường bị đóng hoàn chỉnh ở định dạng XML:

<?xml version="1.0" ?>
<incidents xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/road-incidents/cifsv2.xsd">
    <incident id="3f4r45ff233">
      <creationtime>2017-07-04T13:31:17-04:00</creationtime>
      <updatetime>2017-11-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <description>Complete road closure due to road works</description>
      <street>N Liberty St</street>
      <direction>BOTH_DIRECTIONS</direction>
      <polyline>42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266</polyline>
      <starttime>2017-06-05T00:01:00-04:00</starttime>
      <endtime>2017-11-22T15:30:00-05:00</endtime>
    </incident>
    <incident id="zxf3kvmrpf">
      <creationtime>2017-08-04T13:31:30-04:00</creationtime>
      <updatetime>2017-12-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
      <description>PLANNED ROAD CLOSURE St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31.</description>
        <street>St John's Sideroad</street>
        <direction>BOTH_DIRECTIONS</direction>
        <polyline>44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426</polyline>
      <starttime>2017-04-18T00:01:00-04:00</starttime>
      <endtime>2017-12-31T23:59:00-05:00</endtime>
    </incident>
</incidents>

Tệp nguồn cấp dữ liệu JSON

Sau đây là ví dụ về tệp nguồn cấp dữ liệu về đường bị đóng hoàn chỉnh ở dạng JSON:

{
  "incidents": [
    {
      "id": "3f4r45ff233",
      "creationtime": "2017-07-04T13:31:17-04:00",
      "updatetime": "2017-11-17T04:40:41-05:00",
      "description": "Complete road closure due to road works",
      "street": "N Liberty St",
      "direction": "BOTH_DIRECTIONS",
      "polyline": "42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266",
      "starttime": "2017-06-05T00:01:00-04:00",
      "endtime": "2017-11-22T15:30:00-05:00",
      "type": "ROAD_CLOSED"
    },
    {
      "id": "zxf3kvmrpf",
      "creationtime": "2017-08-04T13:31:30-04:00",
      "updatetime": "2017-12-17T04:40:41-05:00",
      "description": "St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31. ",
      "type": "ROAD_CLOSED",
      "subtype": "ROAD_CLOSED_CONSTRUCTION",
      "street": "St John's Sideroad",
      "direction": "BOTH_DIRECTIONS",
      "polyline": "44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426",
      "starttime": "2017-04-18T00:01:00-04:00",
      "endtime": "2017-12-31T23:59:00-05:00"
    }
  ]
}