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 Đối tác Waze để tự động cung cấp thông tin về việc đóng đường theo kế hoạch và theo thời gian thực trên quy mô lớn.

Thông tin về việc đóng đường 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 đồ Waze và sẽ xuất hiện trên ứng dụng Waze trong thời gian thực của việc đóng đường.

Chỉ cung cấp thông tin về việc đóng đường trong trường hợp tất cả làn đường đều bị đóng. Nếu việc đó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 thành phần tác động đến làn đường.

Để thông tin về đường bị đóng xuất hiện chính xác trên bản đồ, bạn nên làm theo các nguyên tắc dưới đây và quy cách CIFS.

Nếu nguồn cấp dữ liệu của bạn không tuân thủ quy cách CIFS nhưng có tất cả dữ liệu bắt buộc, thì Waze vẫn có thể xử lý nguồn cấp 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à nhận ý kiến phản hồi.

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

Chia sẻ một hàm đóng

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

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

2. Xây dựng cấu trúc cho phần kết thúc

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

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

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

Thứ tự các điểm trong đường đa tuyến phải khớp với hướng lưu lượng truy cập.
Để tránh sự mơ hồ và khắc phục sự khác biệt trong việc lập bản đồ, bạn nên chỉ định ONE_DIRECTION ngay cả đối với đường một chiều.

Đối với đường bị đóng ở hai chiều:

Nếu việc đóng đường chỉ ảnh hưởng đến một hướng: thứ tự của các toạ độ trong đường đa tuyến sẽ cho chúng ta biết hướng lưu lượng truy cập cần đóng.
Nếu việc đóng đường ảnh hưởng đến cả hai hướng: hãy chia sẻ đường đa tuyến và trong trường hướng, hãy chỉ định BOTH_DIRECTIONS.

Đối với một đa tuyến tính kéo dài từ điểm A đến điểm B, việc đóng đường sẽ ảnh hưởng đến hướng lưu thông dựa trên hướng và loại đường như dưới đây:

Hình ảnh giải thích hành vi của đường đa tuyến và hướng.

3. Tạo hình cho đường đa tuyến

Hình nhiều đường càng giống với hình học của đườ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 phân đoạn giữa toạ độ bắt đầu và kết thúc. Việc chỉ cung cấp 2 toạ độ có thể là đủ cho các đoạn ngắn hoặc thẳng, nhưng thường là nguyên nhân gây ra lỗi xử lý.
Đường đa tuyến sau đây duy trì chính xác hình dạng chung của đường:

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

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

Tên đường phố
- Đường bị đóng chỉ có thể ảnh hưởng đến một đường phố hoặc con đường trên bản đồ Waze. Toạ độ bắt đầu và kết thúc của đoạn đường bị đóng phải có cùng tên đường. Một đoạn đường bị đóng được báo cáo trải dài trên nhiều tên đường có thể sẽ không được xử lý, ngay cả khi bạn cung cấp một đa tuyến chính xác.
- Waze sẽ cố gắng so khớp tên đường mà bạn cung cấp với tên đường chính hoặc đường thay thế trên bản đồ Waze tại vị trí được báo cáo. Kết quả khớp toàn bộ hoặc một phần sẽ giúp chúng tôi xác định chính xác đường cần đóng, đặc biệt là khi có nhiều đường đề xuất.
  - Ví dụ: I-95S, I-95 Southbound và JFK Memorial Highway đều được so khớp thành công với cùng một con đường.
- Để đảm bảo rằng tên đường phố và đường mà bạn cung cấp trong trang thông tin khớp với tên đường trên bản đồ Waze, hãy sử dụng API Mã hoá địa lý đảo ngược của Waze hoặc kiểm tra Công cụ chỉnh sửa bản đồ Waze.
Bạn chỉ có thể đóng nguồn cấp dữ liệu trên các loại đường sau đây trên Waze:
- Đường cao tốc
- Đường cao tốc
- Đường phố trong thành phố
- Đường nối
- Đường tư nhân
Không thể báo cáo đường bị đóng trên đường dành cho người đi bộ.
Thời gian bắt đầu:
- Bạn phải cung cấp thời gian bắt đầu cho một sự kiện đó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.
- Nội dung sửa đổi về thời gian bắt đầu:
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 trường này. Các trường hợp đóng không có thời gian kết thúc sẽ được chỉ định thời lượng mặc định (hiện là 2 tuần), sau đó sẽ hết hạn trừ phi bạn chỉ định thời gian kết thúc mới để gia hạn rõ ràng. 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 động dựa trên thời gian hiện tại.

Để biết thông số kỹ thuật chi tiết hơn về thẻ Quy cách nguồn cấp dữ liệu về sự cố và trường hợp đóng (CIFS), hãy xem Quy cách CIFS.

Ví dụ về hàm đóng

Các ví dụ sau đây cho thấy một trường hợp đóng đường ở định dạng XML và JSON.

Phần đóng XML

Sau đây là ví dụ về nguồn cấp dữ liệu chứa một thông tin về việc đóng đườ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>2024-06-07T09:00:00+01:00</starttime>
    <endtime>2024-06-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 sự kiện đườ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": "2024-06-07T09:00:00+01:00",
        "endtime": "2024-06-07T23:00:00+01:00",
        "description": "Closure on I-95 NB due to construction",
        "direction": "BOTH_DIRECTIONS"
      }
    }
  ]
}

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

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

Sau đây là ví dụ về tệp nguồn cấp dữ liệu đườ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>2024-07-04T13:31:17-04:00</creationtime>
      <updatetime>2024-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>2024-06-05T00:01:00-04:00</starttime>
      <endtime>2024-11-22T15:30:00-05:00</endtime>
    </incident>
    <incident id="zxf3kvmrpf">
      <creationtime>2024-08-04T13:31:30-04:00</creationtime>
      <updatetime>2024-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>2024-04-18T00:01:00-04:00</starttime>
      <endtime>2024-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 hoàn chỉnh về đường bị đóng ở định dạng JSON:

{
  "incidents": [
    {
      "id": "3f4r45ff233",
      "creationtime": "2024-07-04T13:31:17-04:00",
      "updatetime": "2024-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": "2024-06-05T00:01:00-04:00",
      "endtime": "2024-11-22T15:30:00-05:00",
      "type": "ROAD_CLOSED"
    },
    {
      "id": "zxf3kvmrpf",
      "creationtime": "2024-08-04T13:31:30-04:00",
      "updatetime": "2024-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": "2024-04-18T00:01:00-04:00",
      "endtime": "2024-12-31T23:59:00-05:00"
    }
  ]
}