열린데이터 광장
서울 열린데이터 광장에서는 서울에 관한 여러가지 공공 API 를 제공한다.
그 중에는 기상정보, 도로 정보, 지하철 정보 등 API 들이 다양하다.
그 중 오늘은 지하철 실시간 도착 정보 API 를 사용해보려 한다.
먼저 공공데이터 사이트로 접속 한 후 지하철을 검색한다.
지하철을 검색하면 지하철에 관련된 여러가지 API 들이 나오는데 그 중 실시간 도착정보를 선택한다.
API 정보
들어가면 API 에 대한 정보들이 나온다.
request params 과 response params 에 대한 설명들이 나온다.
URL 을 보면 인증키가 필요한걸 알 수 있다.
http://swopenAPI.seoul.go.kr/api/subway/(인증키)/xml/realtimeStationArrival/0/5/서울
API 를 사용하기 위해서는 인증키를 발급 받아야 하는데 그럴려면 회원가입을 해야한다.
회원가입을 하게되면 바로 인증키를 발급 받을 수 있다.
사용 URL 에 쓸게 없으니 그냥 http://localhost 를 입력하여 인증키를 신청했다.
API 테스트
인증키 발급이 끝났으면 API 를 테스트 해보자.
API URL 에 인증키를 넣는다. 그리고 xml 이 아닌 return type을 json 으로 할 것이며
서울역에 대한 정보를 가져와보자.
http://swopenAPI.seoul.go.kr/api/subway/인증키/json/realtimeStationArrival/0/5/서울
Postman 으로 요청한 결과이다.
서울역에 대한 정보가 잘 온다는 걸 확인 할 수 있다.
여러 호선이 지나가는 역인 만큼 여러가지 정보가 많다.
API URL 마지막에는 역 이름으로 API 를 받는데 역 이름은 Excel 파일을 다운받아서
정확한 역 이름으로 API 를 요청해야한다. (동네 역 정보가 나오지 않아서 당황했다.)
왜 이름으로 했는지 조금 의문이긴 하지만..
보통 이런 API 를 만든다면 한글 입력보다는 코드를 받아서 처리하는 API 를 만들어야한다.
역 이름으로 만든건 쉽게 검색 할 수 있게 하기 위함이 있는거 같은데
역 이름과 코드 두개의 API 를 만들어야 하지 않았을까 싶다.
이처럼 공공데이터 API 를 이용하여 여러정보를 활용 할 수 있다.
다만 1일 1,000회 로 제한되어 있다. 만약 큰 서비스에서 사용하게 된다면
따로 신청을 또 해주어야 한다.