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ề các đường bị đó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 cửa theo kế hoạch mà bạn gửi tới 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 tế bị đóng.

Chỉ cung cấp thông tin về việc đóng đường trong trường hợp tất cả làn đường trê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.

Để đường bị đóng hiển thị chính xác trên bản đồ, bạn cần tuân theo các nguyên tắc dưới đây và quy cách của 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 chứa tất cả dữ liệu bắt buộc, 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à phản hồi.

Trong trường hợp dữ liệu không đầy đủ hoặc không tương thích, việc đóng cửa sẽ không tự động xuất hiện trên bản đồ mà sẽ được gửi đến Cộng đồng người chỉnh sửa của chúng tôi dưới dạng một "sự cố 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

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

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

Để 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 trạng thái đóng cửa là áp dụng cho một hay cả hai hướng giao thông.

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

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 trên đường hai chiều:

Nếu việc đóng chỉ ảnh hưởng đến một hướ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 cần đóng.
Nếu đường đóng ảnh hưởng đến cả hai hướng: dùng chung hình nhiều đường và trong trường chỉ hướng, hãy biểu thị 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ẽ tác động đến hướng lưu thông dựa trên hướng và loại đường như được minh hoạ dưới đây:

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

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

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 đoạn từ toạ độ bắt đầu đến kết thúc. Chỉ cung cấp 2 toạ độ có thể là đủ cho 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 duy trì đúng hình dạng của đường:

Hình nhiều đường sau đây không phản ánh rõ hình dạng đường vì 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 đường 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 kết thúc 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ả trùng 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 nào cần đóng, đặc biệt là khi có nhiều đề xuất.
  - Ví dụ: I-95S, I-95 Hướng Nam 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 phố và tên đường mà bạn cung cấp trong trang thông tin của mình khớp với tên trên bản đồ Waze, hãy sử dụng công cụ Waze Reverse API mã hóa địa lý hoặc kiểm tra Waze Map Editor.
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
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 việc đóng.
- 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.
- Sửa đổi 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. Những lượt đóng không có thời gian kết thúc sẽ được chỉ định khoảng thời gian mặc định (hiện là 2 tuần), sau đó 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 động 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 kết thúc và nguồn cấp dữ liệu sự cố (CIFS), hãy xem quy cách CIFS.

Ví dụ về đóng

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

Đó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ề đường bị đóng ở cả tệp XML và Định dạng 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"
    }
  ]
}