TOD신호정보(제공)

TOD 신호정보를 제공합니다.

코드 정의서

UTIC(도로교통공단) 에서 정의한 코드 정의서 입니다.

지역 코드

L02 (인천)

L29 (대구)

L99 (화성-임시코드)

71KB

sig_region_cd.pdf

PDF

Open

지역코드

계획 요일 코드

46KB

sig_plan_dy.pdf

PDF

Open

계획요일코드

교차로 예약제어 코드

52KB

sig_resrv_contrl_cd.pdf

PDF

Open

교차로예약제어코드

1. 교차로 기초정보 조회 API (GetIntersectonInfo)

요청 URL

https://service.mqnicrnd5.com/api/v1/tod/offer/gli

연계 주기

요청 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

78KB

TOD신호정보(제공)_gli.pdf

PDF

Open

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> GET /api/v1/tod/offer/gli?regionCd=L01&nodeId=1500006500&ver=20240723 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/tod/offer/gli?regionCd=L01&nodeId=1500006500&ver=20240723' \
--header 'Authorization: Bearer <접근 토큰>'

응답 예시

[
    {
        "regionCd": "L29",
        "csrd": [
            {
                "csrdNo": 1375,
                "csrdNm": "월성태왕서편",
                "updtTm": "2022-10-27 12:59:12",
                "mapNo": "0",
                "xCoord": 1.285263005E9,
                "yCoord": 3.58235353E8,
                "nodeId": "1560117103.0",
                "intMainPhase": null,
                "aRing1PhaseDirCd": "S310130",
                "aRing2PhaseDirCd": null,
                "aRing3PhaseDirCd": null,
                "aRing4PhaseDirCd": null,
                "aRing5PhaseDirCd": null,
                "aRing6PhaseDirCd": null,
                "aRing7PhaseDirCd": null,
                "aRing8PhaseDirCd": null,
                "bRing1PhaseDirCd": "S130310",
                "bRing2PhaseDirCd": null,
                "bRing3PhaseDirCd": null,
                "bRing4PhaseDirCd": null,
                "bRing5PhaseDirCd": null,
                "bRing6PhaseDirCd": null,
                "bRing7PhaseDirCd": null,
                "bRing8PhaseDirCd": null
            }
        ]
    },
    {
        "regionCd": "L02",
        "csrd": [
            {
                "csrdNo": 1002,
                "csrdNm": "율목4거리",
                "updtTm": "2022-10-06 10:59:51",
                "mapNo": "0",
                "xCoord": 1.26636233E9,
                "yCoord": 3.7469174E8,
                "nodeId": "1610001001.0",
                "intMainPhase": null,
                "aRing1PhaseDirCd": "S140320",
                "aRing2PhaseDirCd": "L320030",
                "aRing3PhaseDirCd": "L030140",
                "aRing4PhaseDirCd": "S210030",
                "aRing5PhaseDirCd": null,
                "aRing6PhaseDirCd": null,
                "aRing7PhaseDirCd": null,
                "aRing8PhaseDirCd": null,
                "bRing1PhaseDirCd": "L140210",
                "bRing2PhaseDirCd": "S320140",
                "bRing3PhaseDirCd": "S030210",
                "bRing4PhaseDirCd": "L210320",
                "bRing5PhaseDirCd": null,
                "bRing6PhaseDirCd": null,
                "bRing7PhaseDirCd": null,
                "bRing8PhaseDirCd": null
            },
            {
                "csrdNo": 5168,
                "csrdNm": "건설회관3거리",
                "updtTm": "2022-10-06 10:59:59",
                "mapNo": "0",
                "xCoord": 1.26699959E9,
                "yCoord": 3.7452061E8,
                "nodeId": "1650017001.0",
                "intMainPhase": null,
                "aRing1PhaseDirCd": "L270010",
                "aRing2PhaseDirCd": "S190010",
                "aRing3PhaseDirCd": null,
                "aRing4PhaseDirCd": null,
                "aRing5PhaseDirCd": null,
                "aRing6PhaseDirCd": null,
                "aRing7PhaseDirCd": null,
                "aRing8PhaseDirCd": null,
                "bRing1PhaseDirCd": null,
                "bRing2PhaseDirCd": "S010190",
                "bRing3PhaseDirCd": null,
                "bRing4PhaseDirCd": null,
                "bRing5PhaseDirCd": null,
                "bRing6PhaseDirCd": null,
                "bRing7PhaseDirCd": null,
                "bRing8PhaseDirCd": null
            }
        ]
    }
]

2. 교차로 운영계획정보 조회 API (GetSignalPlan)

요청 URL

https://service.mqnicrnd5.com/api/v1/tod/offer/gsp

연계 주기

요청 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

78KB

TOD신호정보(제공)_gsp.pdf

PDF

Open

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> GET /api/v1/tod/offer/gsp?regionCd=L02&csrdNo=1001&ver=20240722 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/tod/offer/gsp?regionCd=L02&ver=20240722&csrdNo=1001' \
--header 'Authorization: Bearer <접근 토큰>'

응답 예시

{
    "regionCd": "L02",
    "sigPlan": [
        {
            "csrdNo": 1001,
            "csrdNm": "신광4거리",
            "plan": [
                {
                    "csrdPlanNo": 1,
                    "csrdPlanIdxNo": 1,
                    "operPlanHh": 6.0,
                    "operPlanMi": 0.0,
                    "csrdOperCycleVal": 160.0,
                    "csrdOperOffsetVal": 45.0,
                    "aRing1PhaseVal": 63.0,
                    "aRing2PhaseVal": 45.0,
                    "aRing3PhaseVal": 52.0,
                    "aRing4PhaseVal": 0.0,
                    "aRing5PhaseVal": 0.0,
                    "aRing6PhaseVal": 0.0,
                    "aRing7PhaseVal": 0.0,
                    "aRing8PhaseVal": 0.0,
                    "bRing1PhaseVal": 63.0,
                    "bRing2PhaseVal": 45.0,
                    "bRing3PhaseVal": 52.0,
                    "bRing4PhaseVal": 0.0,
                    "bRing5PhaseVal": 0.0,
                    "bRing6PhaseVal": 0.0,
                    "bRing7PhaseVal": 0.0,
                    "bRing8PhaseVal": 0.0
                }
            ]
        }
    ]
}

3. 교차로 요일계획정보(평일) 조회 API (GetSignalWeekPlan)

요청 URL

https://service.mqnicrnd5.com/api/v1/tod/offer/gswp

연계 주기

요청 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

77KB

TOD신호정보(제공)_gswp.pdf

PDF

Open

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> GET /api/v1/tod/offer/gswp?regionCd=L02&csrdNo=1001&ver=20240722 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/tod/offer/gswp?regionCd=L02&ver=20240722&csrdNo=1001' \
--header 'Authorization: Bearer <접근 토큰>'

응답 예시

{
    "regionCd": "L02",
    "items": [
        {
            "csrdNo": 1001,
            "csrdNm": "신광4거리",
            "item": [
                {
                    "planDy": "1",
                    "csrdPlanNo": "4",
                    "collctDtime": "2024-07-22 01:00:16"
                },
                {
                    "planDy": "2",
                    "csrdPlanNo": "2",
                    "collctDtime": "2024-07-22 01:00:16"
                },
                {
                    "planDy": "3",
                    "csrdPlanNo": "1",
                    "collctDtime": "2024-07-22 01:00:16"
                },
                {
                    "planDy": "4",
                    "csrdPlanNo": "1",
                    "collctDtime": "2024-07-22 01:00:16"
                },
                {
                    "planDy": "5",
                    "csrdPlanNo": "1",
                    "collctDtime": "2024-07-22 01:00:16"
                },
                {
                    "planDy": "6",
                    "csrdPlanNo": "1",
                    "collctDtime": "2024-07-22 01:00:16"
                },
                {
                    "planDy": "7",
                    "csrdPlanNo": "3",
                    "collctDtime": "2024-07-22 01:00:16"
                }
            ]
        }
    ]
}

4. 교차로 특수일계획 정보 조회 API (GetHolyDayPlan)

요청 URL

https://service.mqnicrnd5.com/api/v1/tod/offer/ghdp

연계 주기

요청 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

76KB

TOD신호정보(제공)_ghdp.pdf

PDF

Open

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> GET /api/v1/tod/offer/ghdp?regionCd=L02&csrdNo=1001&ver=20240722 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/tod/offer/ghdp?regionCd=L02&csrdNo=1001&ver=20240722' \
--header 'Authorization: Bearer <접근 토큰>'

응답 예시

{
    "regionCd": "L02",
    "items": [
        {
            "csrdNo": 1001,
            "csrdNm": "신광4거리",
            "item": [
                {
                    "planSn": 1,
                    "holyddPlanMM": 1,
                    "holyddPlanDD": 1,
                    "csrdPlanNo": "4",
                    "collctDtime": "2024-07-22 01:00:08"
                },
                {
                    "planSn": 2,
                    "holyddPlanMM": 3,
                    "holyddPlanDD": 1,
                    "csrdPlanNo": "4",
                    "collctDtime": "2024-07-22 01:00:08"
                },
                {
                    "planSn": 3,
                    "holyddPlanMM": 5,
                    "holyddPlanDD": 5,
                    "csrdPlanNo": "4",
                    "collctDtime": "2024-07-22 01:00:08"
                },
                {
                    "planSn": 4,
                    "holyddPlanMM": 6,
                    "holyddPlanDD": 6,
                    "csrdPlanNo": "4",
                    "collctDtime": "2024-07-22 01:00:08"
                }
            ]
        }
    ]
}

5. 교차로 예약계획 정보 조회 API (GetResrvPlan)

요청 URL

https://service.mqnicrnd5.com/api/v1/tod/offer/grp

연계 주기

요청 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

80KB

TOD신호정보(제공)_grp.pdf

PDF

Open

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> GET /api/v1/tod/offer/grp?regionCd=L02&csrdNo=1001&ver=20240722 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/tod/offer/grp?regionCd=L02&csrdNo=1001&ver=20240722' \
--header 'Authorization: Bearer <접근 토큰>'

응답 예시

{
    "regionCd": "L02",
    "items": [
        {
            "csrdNo": 1001,
            "csrdNm": "신광4거리",
            "item": [
                {
                    "resrvNo": 3,
                    "resrvMM": 0,
                    "resrvDD": 0,
                    "resrvDY": 0,
                    "resrvStrtHH": 0,
                    "resrvStrtMI": 0,
                    "resrvEndHH": 0,
                    "resrvEndMI": 0,
                    "resrvContrlCd": "0",
                    "collctDtime": "2024-07-22 01:00:00"
                }
            ]
        }
    ]
}

6. 교차로 시그널 맵 정보 조회 API (GetSignalMapInfo)

요청 URL

https://service.mqnicrnd5.com/api/v1/tod/offer/gsmi

연계 주기

요청 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

84KB

TOD신호정보(제공)_gsmi.pdf

PDF

Open

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> GET /api/v1/tod/offer/gsmi?regionCd=L02&csrdNo=1001&ver=20240722 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/tod/offer/gsmi?regionCd=L02&csrdNo=1001&ver=20240722' \
--header 'Authorization: Bearer <접근 토큰>'

응답 예시

{
    "regionCd": "L02",
    "items": [
        {
            "csrdNo": 1001,
            "csrdNm": "신광4거리",
            "item": [
                {
                    "ringNo": "0",
                    "planTp": "0",
                    "stepNo": "1",
                    "car1": 0,
                    "ped1": 0,
                    "car2": 0,
                    "ped2": 0,
                    "car3": 0,
                    "ped3": 0,
                    "car4": 0,
                    "ped4": 0,
                    "car5": 1,
                    "ped5": 0,
                    "car6": 0,
                    "ped6": 0,
                    "car7": 1,
                    "ped7": 0,
                    "car8": 1,
                    "ped8": 0,
                    "minTm": 4,
                    "maxTm": 0,
                    "eop": 0
                }
            ]
        }
    ]
}

7. TOD 수집 이력 조회 API (GetVersionList)

요청 URL

https://service.mqnicrnd5.com/api/v1/tod/offer/gvl

연계 주기

요청 시

프로토콜

HTTPS

HTTP 메서드

GET

데이터 포맷

85KB

TOD신호정보(제공)_gvl.pdf

PDF

Open

참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. 접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.

> GET /api/v1/tod/offer/gvl?regionCd=L02&csrdNo=1107&stDttm=20240720&edDttm=20240722 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>

요청 예시

curl --location 'https://service.mqnicrnd5.com/api/v1/tod/offer/gvl?regionCd=L02&csrdNo=1107&stDttm=20240720&edDttm=20240722' \
--header 'Authorization: Bearer <접근 토큰>'

응답 예시

{
    "regionCd": "L02",
    "items": [
        {
            "csrdNo": 1107,
            "updtTm": [
                "2024-07-22"
            ]
        }
    ]
}