교통정보 샘플예제

교통정보

  • REQUEST ( 교통정보 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/traffic?version=1&reqCoordType=WGS84GEO&resCoordType=WGS84GEO&trafficType=null&radius=1&zoomLevel=1000&sort=index&appKey=hd921-ksu29-hzq8i-91jai' \
     --header 'Accept: application/json'
  • RESPONSE ( 교통정보 )
NameDate TypeMandatoryExampleDescription
typeStringYFeatureCollectionKML Root 노드입니다.
featuresNodeN포인트 및 라인의 형상 정보입니다. (geojson 표준 규격)
typeStringNFeature링크 정보입니다. (geojson 표준 규격)
geometryNodeN형상 정보 입니다. (geojson 표준 규격)
typeStringNLineStringgeometry의 type입니다.
coordinatesStringN좌표 정보입니다.

- 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
- 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]
propertiesnodeY사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격)
indexnumberN1전체 순번입니다.
lineIndexnumberN1링크의 순번입니다.
idStringN1000링크 ID(TSD Link ID)입니다.
nameStringN마포대교북단링크 명칭입니다.
descriptionStringN소통정보 원할정보 내용입니다.
- 형식: {startNodeName}에서 {endNodeName} 방면 {congestion}
- 동발정보형태: 돌발 상세 정보
congestionnumberN혼잡도 입니다.

- 0: 정보없음
- 1: 원할
- 2: 서행
- 3: 지체
- 4: 정체
directionnumberN방향 정보입니다.

- 0: 정방향
- 1: 역방향
roadTypenumberN도로 타입 정보입니다.

- 001: 고속도로
- 002: 도시고속도로
- 004: 주요도로
- 005: 터널
- 006: 한강교량
- 007: 한강주변도로
- 013: 수도권 주요국도
startNodeNameStringN동부간선도로 수락산역시작 노드명입니다.
endNodeNameStringN동부간선도로 마들길종료 노드명입니다.
distancenumberN300구간 거리(단위: m)입니다.
timenumberN40통행 시간(단위: 초)입니다.
speednumberN69통행 속도(단위: km/h)입니다.
updateTimedateN교통정보 최종 업데이트 일시입니다.
- index=0일 때 응답되는 정보 입니다.
- 형식 : YYYYMMDDHHMMSS
typeStringNFeature돌발 정보입니다. (geojson 표준 규격)
geometryNodeN형상 정보 입니다. (geojson 표준 규격)
typeStringNPointgeometry의 type입니다.
coordinatesStringN좌표 정보입니다.

- 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
- 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]
propertiesNodeN사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격)
indexnumberN1전체 순번입니다.
pointIndexNodeN1포인트 노드의 순번입니다.
isAccidentNodeStringN돌발 정보 여부입니다.
- Y: 돌발정보 노드
- N: 일반 노드
accidentUpperCodeStringN돌발 정보 분류 코드입니다.
isAccidentNode=Y일 때 응답되는 정보입니다.
- A: 사고
- B: 공사
- C: 행사
- D: 재해
- E: 통제
accidentUpperNameStringN돌발정보 분류 명칭입니다.
accidentDetailCodeStringN돌발 정보 상세 분류 코드입니다.
isAccidentNode=Y일 때 응답되는 정보입니다. - A00: 사고
- A01: 차량단독사고
- A02: 추돌사고
- A03: 충돌사고
- A04: 도로시설물추돌사고
- A05: 차량고장
- A06: 낙하물적하
- A07: 보행자사고
- A08: 추락사고
- A09: 차량화재사고
- A10: 신호등고장
- A11: 도로시설물파손잔해
- A12: 사고조사및처리
- A13: 사고구경
- A14: 무단횡단
- A15: 차량전복사고
- A99: 기타
- B00: 공사
- B01: 도로확장및연결공사
- B02: 노면포장및유지보수
- B03: 차선도색
- B04: 도로시설물공사
- B05: 교통시설물공사
- B06: 맨홀공사
- B07: 지하철공사
- B08: 도로청소작업
- B99: 기타
- C00: 행사
- C01: 행사
- C02: 집회
- C03: 민방위훈련
- C04: 군사훈련
- C05: 주요인사통과
- C99: 기타
- D00: 재해
- D01: 폭우
- D02: 폭설
- D03: 노면침수
- D04: 노면결빙
- D05: 도로파손
- D06: 낙석
- D07: 토사유출
- D08: 재해예방작업
- D09: 재해복구작업
- D10: 화재
- D11: 산사태
- D12: 눈사태
- D13: 지진
- D14: 안개
- D99: 기타
- E00: 차단및통제
- E01: 부분통제
- E02: 전면통제
- E03: 부분차단
- E04: 전면차단
- E05: 진입로통제
- E06: 진입로차단
- E07: 진출로통제
- E08: 진출로차단
- E99: 기타
accidentDetailNameStringN진출로차단돌발 정보 상세 분류 명칭입니다.
descriptionStringN소통정보 원할정보 내용입니다.
- 돌발정보형태: 돌발 상세 정보.
  • 교통정보 RESPONSE ( type : json )
{
    "type": "FeatureCollection",
    "features": [
        {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [[126.9784884665,37.5744258358],[126.9777553529,37.5744231262],
                        [126.9765153724,37.5743138912],[126.9755996512,37.5742285106],[126.9744503678,37.5741368829]]
                },
                "properties":{
                    "index": 0,
                    "lineIndex": 0,
                    "id": "1008991",
                    "name": "내자동길/1008991/159762",
                    "description": "문화관광부 에서 중앙청사후문 방면 서행 / 24",
                    "congestion": 2,
                    "direction": 0,
                    "roadType": "004",
                    "startNodeName": "문화관광부",
                    "endNodeName": "중앙청사후문",
                    "distance": 357,
                    "time": 8.92,
                    "speed": 24
                }
        },
        {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [[126.9744647534,37.5740235391],[126.9756152415,37.574115263],[126.976531708,37.5742007132],
                        [126.9777636504,37.5743092403],[126.9784891367,37.5743119217]]
                },
                "properties":{
                    "index": 1,
                    "lineIndex": 1,
                    "id": "1008992",
                    "name": "내자동길/1008992/159763",
                    "description": "중앙청사후문 에서 문화관광부 방면 원활 / 31",
                    "congestion": 1,
                    "direction": 1,
                    "roadType": "004",
                    "startNodeName": "중앙청사후문",
                    "endNodeName": "문화관광부",
                    "distance": 357,
                    "time": 6.90,
                    "speed": 31
                }
        },
        {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [[126.9876086657,37.5726034034],[126.9874529785,37.5719362634],[126.9874459485,37.5718730774],
                        [126.9874391537,37.5717564377],[126.9874732062,37.5709210723],[126.9875109075,37.5703226513],[126.987515647,37.5701962681]]
                },
                "properties":{
                    "index": 2,
                    "lineIndex": 2,
                    "id": "1009341",
                    "name": "삼일로/1009341/159815",
                    "description": "낙원상가 에서 종로2가사거리 방면 서행 / 20",
                    "congestion": 2,
                    "direction": 0,
                    "roadType": "004",
                    "startNodeName": "낙원상가",
                    "endNodeName": "종로2가사거리",
                    "distance": 225,
                    "time": 6.75,
                    "speed": 20
                }
        },
        {"type": "Feature",
                "geometry": 
                        {
                        "type": "LineString",
                        "coordinates": [[126.9878562838,37.5702038458],[126.9878478146,37.5703314102],[126.9877776215,37.5716386502],
                        [126.9877776189,37.5717270841],[126.9877903782,37.5718704555],[126.987945228,37.5725770816],[126.9879653828,37.572728049],
                        [126.9879754027,37.5728317586],[126.9879822111,37.5729207931],[126.9879787775,37.5730496945],[126.9879681938,37.5731246118],
                        [126.9879506052,37.5731964478],[126.987919802,37.5732845166],[126.9878044732,37.5735732019]]
                },
                "properties":{
                    "index": 3,
                    "lineIndex": 3,
                    "id": "1009342",
                    "name": "삼일로/1009342/159816",
                    "description": "종로2가사거리 에서 낙원상가 방면 원활 / 32",
                    "congestion": 1,
                    "direction": 1,
                    "roadType": "004",
                    "startNodeName": "종로2가사거리",
                    "endNodeName": "낙원상가",
                    "distance": 225,
                    "time": 4.21,
                    "speed": 32
                }
        }   }
    ]
}
  • 교통정보 RESPONSE ( type : javascript )
function (
  {
      "type": "FeatureCollection",
      "features": [
          {"type": "Feature",
                  "geometry": 
                          {
                          "type": "LineString",
                          "coordinates": [[126.9784884665,37.5744258358],[126.9777553529,37.5744231262],
                          [126.9765153724,37.5743138912],[126.9755996512,37.5742285106],[126.9744503678,37.5741368829]]
                  },
                  "properties":{
                      "index": 0,
                      "lineIndex": 0,
                      "id": "1008991",
                      "name": "내자동길/1008991/159762",
                      "description": "문화관광부 에서 중앙청사후문 방면 서행 / 24",
                      "congestion": 2,
                      "direction": 0,
                      "roadType": "004",
                      "startNodeName": "문화관광부",
                      "endNodeName": "중앙청사후문",
                      "distance": 357,
                      "time": 8.92,
                      "speed": 24
                  }
          },
          {"type": "Feature",
                  "geometry": 
                          {
                          "type": "LineString",
                          "coordinates": [[126.9744647534,37.5740235391],[126.9756152415,37.574115263],[126.976531708,37.5742007132],
                          [126.9777636504,37.5743092403],[126.9784891367,37.5743119217]]
                  },
                  "properties":{
                      "index": 1,
                      "lineIndex": 1,
                      "id": "1008992",
                      "name": "내자동길/1008992/159763",
                      "description": "중앙청사후문 에서 문화관광부 방면 원활 / 31",
                      "congestion": 1,
                      "direction": 1,
                      "roadType": "004",
                      "startNodeName": "중앙청사후문",
                      "endNodeName": "문화관광부",
                      "distance": 357,
                      "time": 6.90,
                      "speed": 31
                  }
          },
          {"type": "Feature",
                  "geometry": 
                          {
                          "type": "LineString",
                          "coordinates": [[126.9876086657,37.5726034034],[126.9874529785,37.5719362634],[126.9874459485,37.5718730774],
                          [126.9874391537,37.5717564377],[126.9874732062,37.5709210723],[126.9875109075,37.5703226513],[126.987515647,37.5701962681]]
                  },
                  "properties":{
                      "index": 2,
                      "lineIndex": 2,
                      "id": "1009341",
                      "name": "삼일로/1009341/159815",
                      "description": "낙원상가 에서 종로2가사거리 방면 서행 / 20",
                      "congestion": 2,
                      "direction": 0,
                      "roadType": "004",
                      "startNodeName": "낙원상가",
                      "endNodeName": "종로2가사거리",
                      "distance": 225,
                      "time": 6.75,
                      "speed": 20
                  }
          },
          {"type": "Feature",
                  "geometry": 
                          {
                          "type": "LineString",
                          "coordinates": [[126.9878562838,37.5702038458],[126.9878478146,37.5703314102],[126.9877776215,37.5716386502],
                          [126.9877776189,37.5717270841],[126.9877903782,37.5718704555],[126.987945228,37.5725770816],[126.9879653828,37.572728049],
                          [126.9879754027,37.5728317586],[126.9879822111,37.5729207931],[126.9879787775,37.5730496945],[126.9879681938,37.5731246118],
                          [126.9879506052,37.5731964478],[126.987919802,37.5732845166],[126.9878044732,37.5735732019]]
                  },
                  "properties":{
                      "index": 3,
                      "lineIndex": 3,
                      "id": "1009342",
                      "name": "삼일로/1009342/159816",
                      "description": "종로2가사거리 에서 낙원상가 방면 원활 / 32",
                      "congestion": 1,
                      "direction": 1,
                      "roadType": "004",
                      "startNodeName": "종로2가사거리",
                      "endNodeName": "낙원상가",
                      "distance": 225,
                      "time": 4.21,
                      "speed": 32
                  }
          }   
				}
      ]
  } 
)
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.