공공데이터 포탈 API 사용하기(1)

https://www.data.go.kr/index.do

공공데이터 포털

 

공공 데이터 포탈은 국가에서 보유한 다양한 데이터를 개방하여 국민들이 쉽게 사용하도록 제공된 사이트입니다.

공공데이터 API 사이트에서 제공하는 다양한 분야의 정보들입니다.

각 파트별로 세부사항이 또 나뉘는데, 여기서 고를 뿐 아니라 검색을 통해 찾을 수도 있습니다.

단, 제공되는 API 를 사용하기 위해서는 먼저 해당 사이트에 회원가입 및 로그인을 해줄 필요가 있습니다.

회원 가입시 입력하실 사항은 다음과 같습니다.

• 회원 가입 이력 확인
• 14세 이상, 미만 여부 확인
• ID, PW
• 이름
• 이메일 및 인증
• 휴대전화 및 인증
• 자동등록방지 코드
• 약관동의

회원 가입 및 로그인 이 후 원하는 데이터 항목을 검색해줍니다.

저는 "전라남도 시군별 관광" 을 검색하여 다음과 같은 API를 사용하겠습니다.

원하는 데이터 항목을 선택하여 들어가시면 상세 페이지 우측에 '활용신청' 버튼이 나타납니다.

활용하시고자 한다면, 신청버튼을 누르신 다음 보통은 1-2시간 내에 인증키를 발급받습니다.

또한 해당 데이터의 최근 업데이트 유형, 비용, 키워드, 이용범위 등을 파악할 수 있으며

가장 중요한 포멧 유형을 파악할 수 있습니다.(물론, 상세페이지 이전의 게시판에서도 확인 가능합니다.)

이 포멧 유형은 해당 공공 데이터가 어떤 방식으로 정리되어 있으며, 저희가 어떻게 가져다 써야할지를 알 수 있게 해줍니다.

(보통 JSON+XML 방식이며, 해당 사이트에서는 hwp, xls 같은 문서형식으로 제공되기도 합니다.)

스크롤 좀 내려보시면 위와 같이 요청변수 및 출력결과에 대한 표가 존재합니다.

요청변수 항목은 여러분이 활용하실 소스코드의 URL 입력 부분에서 같이 들어가야 할 항목입니다.

 API 사용한 것을 미리보기 해보았습니다. (자세히보기는 아래의 더보기를 클릭)

 

위와 같이 페이지가 표출 됩니다.

상단의 url 부분을 보시면 다음과 같이 작성되어 있습니다.

http://apis.data.go.kr/6460000/tourInfo/getTourlnfoList?serviceKey=서비스키&tourArea=지역&tourCategory=카테고리&pageSize=10&startPage=1&numOfRows=10

중간에 getTourInfoList?serviceKey=서비스키&tourArea=지역~~~~~ 부분을 봐주세요.

요청변수 부분과 많이 닮아 보이지 않나요?

기본적인 웹 프로그래밍 지식이 있으신 분들은 알아보시겠지만, 비전공자 및 초보자 분들을 위해 조금 덧붙이자면

url 내에 물음표 앞까지는 해당 페이지 호출을,

물음표 뒤에서 부터는 해당 페이지에 정보를 요청할 때, 특정 조건을 걸어서 요청하며, 여러 조건은 & 표시로 구분하여 요청한다.

정도로 이해하셔도 무난할 듯 합니다.

여기서는 관광정보를 요청하면서 요청자의 인증키, 찾고자하는 지역, 정보구분, 호출 데이터의 수를 조건으로 지정하여 넘겨준 것입니다.

넘겨준 조건에 맞게 결과가 정리되어 오는 형식이 출력 결과 입니다.

신청 하신 API 에 대해 승인코드가 발급 되었는지는 마이페이지에서 확인 하실 수 있습니다.

승인되어진 데이터 항목을 클릭해봅시다.

승인 받은 인증키가 빨간 상자안에 있으실 겁니다.

검은상자로 가려진 부분에 있을 텍스트를 복사하여, 요청변수와 함께 url 로 만들어 안드로이드에서 사용하는 방법은 다음 게시글에서 같이 해보겠습니다.

감사합니다.

 

p.s. 오류 및 정정에 대한 피드백은 언제나 환영입니다.