국토 가치를 더하다 행복한 변화로 가득한 세상 공간정보로 펼쳐질 대한민국의 미래입니다

활용공간

사용가이드

home > 활용공간 > 국가공간정보포털API > 사용가이드
프린트

Open API 서비스

API 서비스

“플랫폼으로서의 웹” 이라는 특징을 기술적으로 구현한 대표적인 Web 2.0의 기술이며, 하나의 웹 사이트에서 자신이 가진 기능을 이용할 수 있도록 공개한 프로그래밍 인터페이스를 OpenAPI라고 합니다. 국가공간정보 통합 포털에서는 통합검색 서비스에서 제공하고 있는 공간 정보 및 속성정보에 대한 검색결과를 OpenAPI를 통해 누구든 이용할 수 있도록 제공합니다

Open API 는 속성정보와 공간정보를 담은 데이터를 외부에서 활용 할 수 있도록 KML 또는 GEOJSON 형태로 데이터를 제공하고 시각화 도구 SDK를 활용하여 지도를 표출 할 수 있도록 제공하는 API 서비스 입니다.

API 사용 KEY 발급

Open API 서비스를 사용하기 위해서는 API KEY 등록(활용공간 > 국가공간정보포털 오픈API > 신규 Open API 신청) 페이지에서 API 키 신청을 하여 API 사용 KEY를 발급 받아야 사용하실 수 있습니다.
신청 완료 시 관리자의 승인 처리 후 나의 인증키 조회(활용공간 > 국가공간정보포털 오픈API > 나의 인증키 조회) 페이지에서 승인처리된 API KEY와 함께 요청 URL을 서버로 전송하면 Open API 서비스를 사용하실 수 있습니다.

요청 변수

유효한 요청 URL의 구성을 위해 아래의 서비스별 요청변수 정보를 참고하여 요청 매개변수를 "요청변수=값 &요청변수=값 &..."의 형태로 추가하여야 합니다.

공간 정보 테이블 목록 요청 변수

공간 정보 데이터를 활용 하기 위해서 먼저 API 가 제공하는 데이터 테이블의 목록을 확인해야 합니다.
  *요청 URL : http://www.nsdi.go.kr/lxportal/zcms/nsdi/platform/openapi.html

공간 정보 테이블 목록 요청 변수
변수명 고정여부 샘플 데이터 설명
apitype 고정 dataList apitype이 dataList인 경우 Open API에서 제공하는 데이터 테이블의 ID 목록을 제공합니다. 검색 된 ID를 사용하여 다른 API의 검색 테이블을 설정 할 수 있습니다.
authkey 임의 ( 발급된 API KEY ) 발급 완료된 API KEY를 입력합니다.

공간 정보 테이블 컬럼 목록 요청 변수

공간정보 테이블의 컬럼 정보 목록을 제공 합니다.
  *요청 URL : http://www.nsdi.go.kr/lxportal/zcms/nsdi/platform/openapi.html

공간 정보 테이블 컬럼 목록 요청 변수
변수명 고정여부 샘플 데이터 설명
apitype 고정 columnList apitype이 columnList인 경우 Open API에서 제공하는 데이터 테이블의 컬럼 정보를 제공합니다.
datasets 고정 12642 공간정보 데이터 테이블 검색 API의 결과에서 검색 할 데이터 테이블을 정한 후 OBJ_SEQ값을 이곳에 입력합니다.
authkey 임의 ( 발급된 API KEY ) 발급 완료된 API KEY를 입력합니다.

공간 정보 테이블 데이터 요청 변수

공간정보 테이블의 데이터를 GeoJson, KML 형태로 제공 하며 데이터를 활용 하기 위해서 먼저 API 가 제공하는 데이터 테이블의 목록을 확인해야 합니다.
  *요청 URL : http://www.nsdi.go.kr/lxportal/zcms/nsdi/platform/openapi.html

공간 정보 테이블 데이터 요청 변수
변수명 고정여부 샘플 데이터 설명
data 고정 data apitype이 data인 경우 Open API에서 제공하는 데이터 테이블의 공간정보를 제공합니다.
resulttype 고정 geojson 결과가 표시될 포맷을 선택합니다.(geojson, kml 중 택 1)
datasets 고정 12642 공간정보 데이터 테이블 검색 API의 결과에서 검색 할 데이터 테이블을 정한 후 OBJ_SEQ값을 이곳에 입력합니다.
bbox 임의 933650.614474257,1943286.5512082838, 970380.2826180774,1961733.2057452637 검색 영역 사각형(x1y1, x2y1, x1y2, x2y2)의 x1y1과 x2y2를 입력합니다. 허용 좌표계는 EPSG:5179만 제공합니다.
authkey 임의 ( 발급된 API KEY ) 발급 완료된 API KEY를 입력합니다.

지도 시각화 SDK 요청 변수

공간정보를 지도 위에 시각화 하여 표출 할 수 있는 SDK를 제공 합니다.
  *요청 URL : http://www.nsdi.go.kr/lxportal/zcms/nsdi/platform/sdkGeoView.js.htm

지도 시각화 SDK 요청 변수
변수명 고정여부 샘플 데이터 설명
authkey 임의 ( 발급된 API KEY ) 발급 완료된 API KEY를 입력합니다.

데이터 API 예제

공간 정보 테이블 목록

  • 요청 예시
  • 요청 결과 예시
  • 요청 변수 입력
  • 요청 변수 입력
    항목명 입력값
    apitype dataList



  • 요청 결과

공간 정보 테이블 컬럼 정보

  • 요청 예시
  • 요청 결과 예시
  • 요청 변수 입력
  • 요청 변수 입력
    항목명 입력값
    apitype columnList
    datasets

    검색

  • 요청 결과

공간 정보 데이터

  • 요청 예시
  • 요청 결과 예시
  • 요청 변수 입력
  • 요청 변수 입력
    항목명 입력값
    apitype dataList
    resulttype
    datasets
    bbox

    검색

  • 요청 결과