지/정체 구간정보 조회
요청 URL - /api/rest/getRoadLinkCongestInfo
요청 Parameter
| 변수명 | 타입 | 설명 |
|---|---|---|
| serviceKey | String(필수) | 발급받은 키값 |
| routeId | String(선택) | 도로 ID |
| linkId | String(선택) | 링크 ID |
샘플 URL
소통정보를 검색할 경우 :
- /api/rest/getRoadLinkCongestInfo?serviceKey=72c03919776b2db8e4dd25aaebc1ae7f37bcf49&linkId=2300026003
요청결과 출력
| 변수명 | 타입 | 설명 |
|---|---|---|
| procDate | String | 소통정보 가공시간 |
| routeId | String | 도로 ID |
| routeNm | String | 도로 명칭 |
| linkId | String | 링크 ID |
| startNodeId | String | 시작노드 ID |
| startNodeNm | String | 시작노드 명 |
| endNodeId | String | 종료노드 ID |
| endNodeNm | String | 종료노드 명 |
| spd | String | 구간 속도 |
| vol | String | 교통량 |
| trvlTime | String | 여행시간 (1분 당 링크길이에 대한 링크평균속도를 시간으로 환산한 값) |
| congGrade | String | 혼잡 구분(0:정보없음, 1:원활, 2:지체, 3:정체) |
| routeWay | String | 도로 방향 |
| linkLength | String | 구간 길이 |
실패 시 에러 출력
| 변수명 | 타입 | 설명 |
|---|---|---|
| headerCd | String | 결과코드 |
| headerMsg | String | 결과메시지 |
| itemCount | String | 결과 데이터 개수 |
에러코드 상세 리스트
| 에러코드 | 에러메시지 |
|---|---|
| 0 | 정상적으로 처리되었습니다. |
| 1 | 시스템 에러가 발생하였습니다. |
| 2 | 필수 요청 Parameter가 존재하지 않습니다. |
| 3 | 필수 요청 Parameter가 잘못되었습니다. |
| 4 | 결과가 존재하지 않습니다 |
| 5 | 필수요청 Parameter(인증키)가 존재하지 않습니다. |
| 6 | 등록되지 않은 키 입니다. |
| 7 | 사용할 수 없는(등록은 되었으나, 일시적으로 사용 중지된)키입니다. |
| 8 | 요청 제한을 초과하였습니다. |
| 20 | 잘못된 위치로 요청하였습니다. 위경도 좌표값이 정확한지 확인하십시오. |
| 21 | 노선번호는 1자리 이상 입력하세요. |
| 22 | 정류소 명/번호는 1자리 이상 입력하세요. |
| 23 | 버스도착정보가 존재하지 않습니다. |
| 31 | 존재하지 않는 출발 정류소 아이디(ID)/번호입니다. |
| 32 | 존재하지 않는 도착 정류소 아이디(ID)/번호입니다. |
| 99 | API 서비스 준비 중입니다 |
요청결과 예시
