공간검색 API

Query Params

version

string

required

Defaults to 1

API 버전정보입니다.

page

string

Defaults to 1

- 페이지 번호 (1-200)

count

string

required

Defaults to 20

- 페이지당 조회된 공간검색 수

categories

string

required

Defaults to city_do

검색하고자 하는 카테고리를 지정합니다.
city_do
(old : SIDOP)
- 시,도 단위 검색

gu_gun
(old : SIGUNP)
- 시,군,구 단위 검색

legalDong
(old : BDONGP)
- 법정동 검색

adminDong
(old : HDONGP)
- 행정동 검색

searchType

string

required

Defaults to COORDINATES

검색 타입
KEYWORD
- 키워드 검색

COORDINATES
- 좌표 검색 : 해당 좌표가 있는 공간을 검색 합니다.

searchKeyword

string

검색 키워드 입니다.
- ‘searchType = KEYWORD’ 인 경우에 필수 입니다.
- UTF-8 기반 URL 인코딩 처리를 해야 합니다

resCoordType

string

Defaults to WGS84GEO

받고자 하는 응답 좌표계 유형을 지정합니다.
지구 위의 위치를 나타내는 좌표 타입 종류로, 투영 방법에 따라 다음과 같이 나뉩니다.

EPSG3857
- Google Mercator

WGS84GEO
- 경위도

KATECH
- TM128(Transverse Mercator:횡메카토르): 한국 표준

reqCoordType

string

Defaults to WGS84GEO

searchType = COORDINATES 인 경우 필수 입니다.
입력하는 좌표계 유형을 지정합니다.
지구 위의 위치를 나타내는 좌표 타입 종류로, 투영 방법에 따라 다음과 같이 나뉩니다.

EPSG3857
- Google Mercator

WGS84GEO
- 경위도

KATECH
- TM128(Transverse Mercator:횡메카토르): 한국 표준

reqLon

string

Defaults to 127.027621

- ‘searchType = COORDINATES’ 시 필수 입니다.
좌표 검색에서 경도 좌표 입니다.

reqLat

string

Defaults to 37.497916

- ‘searchType = COORDINATES’ 시 필수 입니다.
좌표 검색에서 위도 좌표 입니다.

callback

string

Defaults to function

jsonp 포맷에서 사용하는 callback 함수명 정보입니다.
application/javascript 일 때 필수로 입력해야 합니다.

Headers

appKey

string

required

마이페이지>앱>앱키(appKey) 탭에서 확인 가능

xxxxxxxxxx
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geofencing/regions?version=1&page=1&count=20&categories=city_do&searchType=COORDINATES&resCoordType=WGS84GEO&reqCoordType=WGS84GEO&reqLon=127.027621&reqLat=37.497916&callback=function' \
     --header 'accept: application/json' \
     --header 'appKey: e8wHh2tya84M88aReEpXCa5XTQf3xgo01aZG39k5'

200200

401401