교통정보 샘플예제

교통정보

  • 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 ( 교통정보 )

Name

Date Type

Mandatory

Example

Description

type

String

Y

FeatureCollection

KML Root 노드입니다.

features

Node

N

포인트 및 라인의 형상 정보입니다. (geojson 표준 규격)

type

String

N

Feature

링크 정보입니다. (geojson 표준 규격)

geometry

Node

N

형상 정보 입니다. (geojson 표준 규격)

type

String

N

LineString

geometry의 type입니다.

coordinates

String

N

좌표 정보입니다.

  • 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
    복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
  • 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]

properties

node

Y

사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격)

index

number

N

1

전체 순번입니다.

lineIndex

number

N

1

링크의 순번입니다.

id

String

N

1000

링크 ID(TSD Link ID)입니다.

name

String

N

마포대교북단

링크 명칭입니다.

description

String

N

소통정보 원할

정보 내용입니다.

  • 형식: {startNodeName}에서 {endNodeName} 방면 {congestion}
  • 동발정보형태: 돌발 상세 정보

congestion

number

N

혼잡도 입니다.

  • 0: 정보없음
  • 1: 원할
  • 2: 서행
  • 3: 지체
  • 4: 정체

direction

number

N

방향 정보입니다.

  • 0: 정방향
  • 1: 역방향

roadType

number

N

도로 타입 정보입니다.

  • 001: 고속도로
  • 002: 도시고속도로
  • 004: 주요도로
  • 005: 터널
  • 006: 한강교량
  • 007: 한강주변도로
  • 013: 수도권 주요국도

startNodeName

String

N

동부간선도로 수락산역

시작 노드명입니다.

endNodeName

String

N

동부간선도로 마들길

종료 노드명입니다.

distance

number

N

300

구간 거리(단위: m)입니다.

time

number

N

40

통행 시간(단위: 초)입니다.

speed

number

N

69

통행 속도(단위: km/h)입니다.

updateTime

date

N

교통정보 최종 업데이트 일시입니다.

  • index=0일 때 응답되는 정보 입니다.
  • 형식 : YYYYMMDDHHMMSS

type

String

N

Feature

돌발 정보입니다. (geojson 표준 규격)

geometry

Node

N

형상 정보 입니다. (geojson 표준 규격)

type

String

N

Point

geometry의 type입니다.

coordinates

String

N

좌표 정보입니다.

  • 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
    복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
  • 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]

properties

Node

N

사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격)

index

number

N

1

전체 순번입니다.

pointIndex

Node

N

1

포인트 노드의 순번입니다.

isAccidentNode

String

N

돌발 정보 여부입니다.

  • Y: 돌발정보 노드
  • N: 일반 노드

accidentUpperCode

String

N

돌발 정보 분류 코드입니다.
isAccidentNode=Y일 때 응답되는 정보입니다.

  • A: 사고
  • B: 공사
  • C: 행사
  • D: 재해
  • E: 통제

accidentUpperName

String

N

돌발정보 분류 명칭입니다.

accidentDetailCode

String

N

돌발 정보 상세 분류 코드입니다.
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: 기타

accidentDetailName

String

N

진출로차단

돌발 정보 상세 분류 명칭입니다.

description

String

N

소통정보 원할

정보 내용입니다.

  • 돌발정보형태: 돌발 상세 정보.
  • 교통정보 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에서 확인 할 수 있습니다.