명칭(POI) 경로 반경 검색

post https://apis.openapi.sk.com/tmap/poi/findPoiRoute?version=1.0&callback={callback}

Query Params

version

string

required

Defaults to 1

API의 버전 정보입니다.

callback

string

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

Body Params

page

int32

Defaults to 1

조회할 목록의 페이지를 지정합니다.

count

int32

Defaults to 20

페이지당 출력되는 개수를 지정합니다.

endX

int32

required

Defaults to 129.07579349764512

목적지 X좌표입니다.
- 경도를 의미합니다.

[Example]
EPSG3857 : 14368651.605895586
WGS84GEO :129.07579349764512
KATECH : 498181.0591427401

endY

int32

required

Defaults to 35.17883196265564

목적지 Y좌표입니다.
- 위도를 의미합니다.

[Example]
EPSG3857 : 4188210.3283031476
WGS84GEO : 35.17883196265564
KATECH : 287188.0233151837

reqCoordType

string

Defaults to WGS84GEO

출발지, 경유지, 목적지 좌표계 유형을 지정합니다.

지구 위의 위치를 나타내는 좌표 타입입니다.
EPSG3857
- Google Mercator

WGS84GEO(기본값)
- 경위도

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

resCoordType

string

Defaults to WGS84GEO

받고자 하는 응답 좌표계 유형을 지정합니다.

지구위의 위치를 나타내는 좌표 타입입니다.
EPSG3857
- Google Mercator

WGS84GEO(기본값)
- 경위도

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

startX

int32

required

Defaults to 126.98217734415019

출발지 X좌표입니다.
- 경도를 의미합니다.

[Example]
EPSG3857 : 14135591.321771959
WGS84GEO : 126.98217734415019
KATECH : 310278.5350755865

startY

int32

required

Defaults to 37.56468648536046

출발지 Y좌표입니다.
- 위도를 의미합니다.

[Example]
EPSG3857 : 4518111.822510956
WGS84GEO : 37.56468648536046
KATECH : 551869.0243206669

userX

int32

required

Defaults to 126.98217734415019

사용자의 현재 X좌표입니다.
- 경도를 의미합니다.

[Example]
EPSG3857 : 14135591.321771959
WGS84GEO : 126.98217734415019
KATECH : 310278.5350755865

userY

int32

required

Defaults to 37.56468648536046

사용자의 현재 Y좌표입니다.
- 위도를 의미합니다.

[Example]
EPSG3857 : 4518111.822510956
WGS84GEO : 37.56468648536046
KATECH : 551869.0243206669

searchType

string

• keyword - 일반 키워드 검색
• category - 카테고리검색 (키워드 없음)
• nearby - 근처검색( 키워드 없음)

searchKeyword

string

searchType 이 keyword 인 경우 필수,
경로 반경 내 특정 키워드를 검색할 경우.

searchCategory

string

searchType 이 category 인 경우 필수
• 특정 카테고리로 제한하여 검색할 경우
콤마로 구분하여 여러개 카테고리 선택 가능
(※사용 가능 : C01 : 휴게소 ,C02 :
주유소, C03 : EV충전소)

sort

string

Defaults to score

검색 결과 정렬.
• score : 랭킹 점수 높은순 (default)
• distance : 가까운 거리순
• evcharger : 가까운 거리 내 사용 가능한 EV 충전기 많은순

radius

int32

km 단위 검색 반경.

poiGroupYn

string

Defaults to N

POI 그룹핑정보 유무입니다.
Y : POI 그룹핑정보 유
N : POI 그룹핑정보 무

groupQuery

string

경로 내 존재하는 특정 업종을 검색할 경우.

tmapParkYn

string

티맵 주차장 검색여부.

direction

string

경로를 기반으로 radius 반경 만큼 확장할 버퍼의 방향.
• all : 경로 상 양방향 모두 포함한 반경 검색
• right : 경로 상 오른쪽 반경 검색 (default)

lineString

string

required

Defaults to 127.38454163183215,36.35127257501252_127.38668918609662,36.353534038949995

경로 궤적 정보.
X 좌표, Y 좌표를 콤마(,)와 밑줄()로 구분하여 순서대로 나열합니다.
- 형식: 궤적1 X 좌표,궤적1 Y 좌표궤적2 X 좌표,궤적2 Y 좌표_...

[Example]
EPSG3857 : 14180382.309390113,4349064.210998647_14180621.374037,4349376.787654
WGS84GEO : 127.38454163183215,36.35127257501252_127.38668918609662,36.353534038949995
KATECH : 344955.1840998584,416909.51311973063_345149.531047,417159.274957

Headers

appKey

string

required

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

Responses

Language

Credentials

Header


xxxxxxxxxx
22
1
curl --request POST \
2
     --url 'https://apis.openapi.sk.com/tmap/poi/findPoiRoute?version=1.0&callback=callback' \
3
     --header 'accept: application/json' \
4
     --header 'appKey: e8wHh2tya84M88aReEpXCa5XTQf3xgo01aZG39k5' \
5
     --header 'content-type: application/json' \
6
     --data '
7
{
8
  "page": 1,
9
  "count": 20,
10
  "endX": 129.07579349764512,
11
  "endY": 35.17883196265564,
12
  "reqCoordType": "WGS84GEO",
13
  "resCoordType": "WGS84GEO",
14
  "startX": 126.98217734415019,
15
  "startY": 37.56468648536046,
16
  "userX": 126.98217734415019,
17
  "userY": 37.56468648536046,
18
  "sort": "score",
19
  "poiGroupYn": "N",
20
  "lineString": "127.38454163183215,36.35127257501252_127.38668918609662,36.353534038949995"
21
}
22
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400