도로 폐쇄 정보

Waze 파트너 피드를 사용하여 계획된 도로 폐쇄와 실시간 도로 폐쇄를 자동으로 대규모로 제공할 수 있습니다.

Waze에 전송한 계획된 폐쇄는 Waze 지도 편집기에 표시되며 실제 폐쇄 시간에는 Waze 앱에 표시됩니다.

도로의 모든 차선이 폐쇄된 경우에만 도로 폐쇄를 제공합니다. 폐쇄가 일부 차선에만 영향을 미치는 경우 차선 영향 요소에서 영향을 받는 차선을 설명합니다.

도로 폐쇄가 지도에 정확하게 표시되도록 하려면 아래 가이드라인과 CIFS 사양을 따라야 합니다.

피드가 CIFS 사양을 준수하지 않지만 필요한 모든 데이터가 포함되어 있는 경우에도 Waze에서 피드를 처리할 수 있습니다. 파트너 허브를 통해 피드를 제출하여 유효성 검사 및 의견을 받습니다.

데이터가 불완전하거나 호환되지 않는 경우 폐쇄가 지도에 자동으로 표시되지 않으며 수동 검토, 승인 또는 거부를 위해 '지도 문제'로 편집자 커뮤니티에 전송됩니다.

폐쇄 공유

1. 폐쇄 태그 지정

도로 폐쇄를 매핑하려면 ROAD_CLOSED를 type 요소의 태그 입력으로 지정합니다.

2. 마무리 문구 구성하기

Waze와 폐쇄를 공유하려면 polyline(필수) 및 direction(요청됨)을 지정합니다.

  • 다중선은 도로 도형을 따라가며 폐쇄해야 하는 도로 구간을 설명하는 좌표의 시퀀스입니다.
  • 다중선의 좌표 순서에 따라 영향을 받는 교통 방향이 결정됩니다.
  • direction는 폐쇄가 교통의 한 방향 또는 양방향에 적용되는지 여부를 나타냅니다.

단방향 도로 폐쇄의 경우:

  • 다중선의 점 순서는 교통 방향과 일치해야 합니다.
  • 모호함을 피하고 매핑 차이를 극복하려면 일방통행 도로에도 ONE_DIRECTION를 지정하는 것이 좋습니다.

양방향 도로 폐쇄의 경우:

  • 폐쇄가 한 방향에만 영향을 미치는 경우: 다중선의 좌표 순서에 따라 폐쇄할 교통 방향이 결정됩니다.
  • 클로저가 양방향에 영향을 미치는 경우 다중선을 공유하고 방향 필드에 BOTH_DIRECTIONS를 표시합니다.

A 지점에서 B 지점으로 이어지는 다중선의 경우 폐쇄는 아래와 같이 방향 및 도로 유형에 따라 교통 방향에 영향을 미칩니다.

다중선 및 방향 동작을 설명하는 이미지입니다.

3. 다중선 모양 지정

  • 폴리라인이 도로의 기하학적 형태와 비슷할수록, Waze가 경로를 정확하게 맞추고 폐쇄를 처리할 가능성이 더 높습니다.
    시작 및 종료 좌표 간에 각 세그먼트에 여러 지점을 제공하는 것이 좋습니다. 짧거나 직선인 구간의 경우 2개의 좌표만 제공해도 충분하지만 처리 실패의 원인이 되는 경우가 많습니다.
    다음 다중선은 도로의 일반적인 도형을 올바르게 유지합니다.

    컨텍스트에서 사용되는 다중선 이미지입니다.
    다음 다중선은 시작 좌표와 끝 좌표만 제공하므로 도로 도형을 명확하게 반영하지 않습니다.

    컨텍스트에서 사용되는 다중선 이미지입니다.

  • Waze에서는 제공된 다중선을 사용하여 Waze 지도의 하나 이상의 구간에 이벤트를 적용합니다. Waze는 Waze 지도에 구성된 전체 구간만 폐쇄할 수 있으므로 적용된 폐쇄 구간은 폴리라인보다 길거나 약간 짧을 수 있습니다.
  • 구간의 일부만 폐쇄하도록 지정하면 전체 구간이 닫힙니다.
  • 폐쇄의 시작점과 끝점은 30m 이상 떨어져 있는 것이 좋습니다.
  • 제공된 다중선의 길이는 20km를 초과해서는 안 됩니다.

4. 폐쇄가 다음 가이드라인을 준수하는지 확인합니다.

  • 도로명
    • 폐쇄는 Waze 지도의 한 거리나 도로에만 영향을 미칩니다. 폐쇄 구간의 시작 및 종료 좌표에 동일한 도로명이 있어야 합니다. 정확한 다중선이 제공되더라도 여러 도로 이름에 걸쳐 보고된 폐쇄는 처리되지 않을 수 있습니다.
    • Waze는 사용자가 제공한 거리 이름을 Waze 지도에 표시된 기본 도로명이나 대체 도로명과 일치시키려고 시도합니다. 전체 또는 부분 일치는 특히 후보가 여러 개인 경우 폐쇄할 도로를 올바르게 식별하는 데 도움이 됩니다.
      • 예: I-95S, I-95 남쪽 방면 및 JFK 메모리얼 하이웨이 모두 동일한 도로와 일치합니다.
    • 리스팅에 제공한 도로명과 도로 이름이 Waze 지도의 이름과 일치하도록 하려면 Waze Reverse를 사용하세요 Geocoding API를 확인하거나 Waze 지도 편집기를 확인하세요.
  • 피드 폐쇄는 다음 Waze 도로 유형에서만 할 수 있습니다.
    • 고속도로
    • 고속도로
    • 도시 거리
    • 경사로
    • 사유 도로
  • 도로 폐쇄는 보행자 전용 도로에서는 신고할 수 없습니다.
  • 시작 시간: <ph type="x-smartling-placeholder">
      </ph>
    • 폐쇄 시작 시간을 제공해야 합니다.
    • 시작 시간을 잘 모르겠다면 최초 보고서의 타임스탬프를 사용할 수 있습니다.
    • 시작 시간 수정:
      • 활성 폐쇄: 폐쇄의 시작 시간이 지나면(즉, 폐쇄가 활성 상태인 경우) 시작 시간을 수정해서는 안 됩니다.
      • 향후 영업 종료: 사업이 아직 시작되지 않은 경우 필요에 따라 시작 시간을 수정할 수 있습니다. 단, 일관성을 유지하려면 event_id를 동일하게 유지해야 합니다.
  • 종료 시간:
    • 종료 시간을 모르는 경우 비워 둡니다. 종료 시간이 없는 폐쇄에는 기본 기간(현재 2주)이 할당되며, 새 종료 시간을 지정하여 명시적으로 연장하지 않는 한 만료됩니다. 이벤트를 게시한 후 종료 시간을 수정할 수 있지만, 현재 시간을 기반으로 종료 시간을 동적으로 설정하지 마세요.

폐쇄 및 이슈 피드 사양 (CIFS) 태그의 자세한 사양은 CIFS 사양을 참조하세요.

폐쇄 예

다음 예는 XML 및 JSON 형식의 단일 도로 폐쇄를 보여줍니다.

XML 클로저

다음은 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>

JSON 폐쇄

다음은 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"
      }
    }
  ]
}

다음 예는 전체 도로 폐쇄 피드 파일을 XML 및 JSON 형식입니다.

XML 피드 파일

다음은 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>

JSON 피드 파일

다음은 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"
    }
  ]
}