Sign in

v1

latestOpenAPI 3.1.02026-07-14320308.9 KB

명칭(POI) 경로 반경 검색

post/poi/findPoiRoute?version=1.0&callback={callback}

Query parameters

versionstring required

API의 버전 정보입니다.

callbackstring

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

Headers

appKeystring required

<a href="https://openapi.sk.com/mypage/project/" target="_blank">마이페이지>앱</a>>앱키(appKey) 탭에서 확인 가능

Request body

pageinteger

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

countinteger

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

endXinteger required

목적지 X좌표입니다.<br>- 경도를 의미합니다.<br><br>[Example]<br>EPSG3857 : 14368651.605895586<br>WGS84GEO :129.07579349764512<br>KATECH : 498181.0591427401

endYinteger required

목적지 Y좌표입니다.<br>- 위도를 의미합니다.<br><br>[Example] <br>EPSG3857 : 4188210.3283031476<br>WGS84GEO : 35.17883196265564<br>KATECH : 287188.0233151837

reqCoordTypestring

출발지, 경유지, 목적지 좌표계 유형을 지정합니다.<br><br>지구 위의 위치를 나타내는 좌표 타입입니다.<br>EPSG3857<br>- Google Mercator <br><br>WGS84GEO(기본값)<br>- 경위도<br><br>KATECH<br>- TM128(Transverse Mercator:횡메카토르): 한국 표준

resCoordTypestring

받고자 하는 응답 좌표계 유형을 지정합니다.<br><br>지구위의 위치를 나타내는 좌표 타입입니다.<br>EPSG3857<br>- Google Mercator <br><br>WGS84GEO(기본값)<br>- 경위도<br><br>KATECH<br>- TM128(Transverse Mercator:횡메카토르): 한국 표준

startXinteger required

출발지 X좌표입니다.<br>- 경도를 의미합니다.<br><br>[Example]<br>EPSG3857 : 14135591.321771959<br>WGS84GEO : 126.98217734415019<br>KATECH : 310278.5350755865

startYinteger required

출발지 Y좌표입니다.<br>- 위도를 의미합니다.<br><br>[Example]<br>EPSG3857 : 4518111.822510956<br>WGS84GEO : 37.56468648536046<br>KATECH : 551869.0243206669

userXinteger required

사용자의 현재 X좌표입니다.<br>- 경도를 의미합니다. <br><br>[Example]<br>EPSG3857 : 14135591.321771959<br>WGS84GEO : 126.98217734415019<br>KATECH : 310278.5350755865

userYinteger required

사용자의 현재 Y좌표입니다.<br>- 위도를 의미합니다.<br><br>[Example]<br>EPSG3857 : 4518111.822510956<br>WGS84GEO : 37.56468648536046<br>KATECH : 551869.0243206669

searchTypestring

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

searchKeywordstring

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

searchCategorystring

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

sortstring

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

radiusinteger

km 단위 검색 반경.

poiGroupYnstring

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

groupQuerystring

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

tmapParkYnstring

티맵 주차장 검색여부.

directionstring

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

lineStringstring required

경로 궤적 정보.<br>X 좌표, Y 좌표를 콤마(,)와 밑줄()로 구분하여 순서대로 나열합니다.<br>- 형식: 궤적1 X 좌표,궤적1 Y 좌표_궤적2 X 좌표,궤적2 Y 좌표...<br><br>[Example]<br>EPSG3857 : 14180382.309390113,4349064.210998647_14180621.374037,4349376.787654<br>WGS84GEO : 127.38454163183215,36.35127257501252_127.38668918609662,36.353534038949995<br>KATECH : 344955.1840998584,416909.51311973063_345149.531047,417159.274957

Response

200