0
총 돌발건수
0
교통사고
0
도로공사
0
교통통제
돌발정보 지도
유형별 현황
시간대별 발생현황
최근 돌발정보
| 유형 | 위치 | 내용 | 발생일시 | 상태 |
|---|
조회 결과 0건
| 돌발ID | 유형 | 상세유형 | 위치 | 내용 | 발생일시 | 종료(예정)일시 | 좌표 |
|---|
API 요청
요청 이력
요청 이력이 없습니다
API 응답
대기중
--
// API 호출 결과가 여기에 표시됩니다.
//
// 1. 왼쪽에서 인증키와 파라미터를 설정하세요.
// 2. 'API 호출' 버튼을 클릭하세요.
// 3. 응답 결과가 이 영역에 표시됩니다.
//
// [참고] 서울 열린데이터광장에서 인증키를 발급받으세요.
// https://data.seoul.go.kr
서비스 개요
서울시 실시간 돌발정보 Open API
서울시 교통정보시스템(TOPIS)에서 수집되는 실시간 교통 돌발정보를 Open API 형태로 제공하는 서비스입니다. 교통사고, 도로공사, 집회 및 행사, 기상상황, 교통통제 등 서울시 전역의 돌발 상황을 실시간으로 조회할 수 있습니다.
데이터셋 ID
OA-13315
제공기관
서울특별시
담당부서
교통실 미래스마트교통과
원천시스템
서울시 교통정보시스템 (TOPIS)
갱신주기
실시간 / 매일
라이선스
공공누리 1유형 (출처표시)
API 호출 방법
요청 URL 형식
http://openAPI.seoul.go.kr:8088/{인증키}/{요청파일타입}/{서비스명}/{시작위치}/{끝위치}/
요청 인자
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
인증키 | String | Y | 열린데이터광장에서 발급받은 API 키 |
요청파일타입 | String | Y | json 또는 xml |
서비스명 | String | Y | ItsIncidentInfo |
시작위치 | Integer | Y | 데이터 행 시작 번호 (1부터) |
끝위치 | Integer | Y | 데이터 행 끝 번호 (최대 1,000) |
응답 필드
| 필드명 | 타입 | 설명 |
|---|---|---|
list_total_count | Integer | 총 데이터 건수 |
RESULT.CODE | String | 요청결과 코드 (INFO-000: 정상) |
RESULT.MESSAGE | String | 요청결과 메시지 |
hpd_id | String | 돌발 ID |
type_nm | String | 돌발 유형명 |
detail_type_nm | String | 돌발 상세유형명 |
ocr_date | String | 발생 일자 (YYYYMMDD) |
ocr_time | String | 발생 시각 (HHmmss) |
exp_clr_date | String | 종료(예정) 일자 |
exp_clr_time | String | 종료(예정) 시각 |
road_nm | String | 도로명 |
drc_type_nm | String | 방향 |
grs80tm_x | Double | X좌표 (경도) |
grs80tm_y | Double | Y좌표 (위도) |
msg_cn | String | 돌발 내용 |
호출 예시
curl -X GET \
"http://openAPI.seoul.go.kr:8088/{API_KEY}/json/ItsIncidentInfo/1/10/"
import requests
API_KEY = "발급받은_인증키"
url = f"http://openAPI.seoul.go.kr:8088/{API_KEY}/json/ItsIncidentInfo/1/10/"
response = requests.get(url)
data = response.json()
for item in data.get("ItsIncidentInfo", {}).get("row", []):
print(f"[{item['type_nm']}] {item['road_nm']} - {item['msg_cn']}")
const API_KEY = "발급받은_인증키";
const url = `http://openAPI.seoul.go.kr:8088/${API_KEY}/json/ItsIncidentInfo/1/10/`;
fetch(url)
.then(res => res.json())
.then(data => {
const rows = data.ItsIncidentInfo?.row || [];
rows.forEach(item => {
console.log(`[${item.type_nm}] ${item.road_nm} - ${item.msg_cn}`);
});
});
빠른 시작 가이드
1
회원가입
서울 열린데이터광장에 회원가입합니다.
2
인증키 발급
마이페이지에서 Open API 인증키를 발급받습니다.
3
API 설정
상단의 'API 설정' 버튼을 클릭하여 인증키를 등록합니다.
4
데이터 조회
대시보드에서 실시간 돌발정보를 확인합니다.
유의사항
- 한 번에 최대 1,000건까지 요청 가능
- 하루 1,000회 호출 제한 (기본)
- 인증키는 타인에게 공유하지 마세요
- 상업적 이용 시 출처를 표시해야 합니다
- 데이터 정확성은 원천시스템에 의존합니다