v1

latestOpenAPI 3.1.02026-07-14320308.9 KB

명칭(POI) 상세 정보 검색

가장 일반적으로 사용하는 명칭(Point Of Interest) 검색 기능입니다. 전화번호, 명칭으로 검색할 수 있습니다.

get/pois/{poiInfo}

Path parameters

poiInfostring required

POI ID 또는 POI 식별자(pkey)

Query parameters

versioninteger required

findOption'id' | 'key'

조회 옵션 id : POI ID로 조회하는 경우(기본값) key : POI 식별자로 조회하는 경우

resCoordType'WGS84GEO' | 'EPSG3857' | 'KATECH'

응답 좌표계 유형 - WGS84GEO: 경위도 - EPSG3857: Google Mercator - KATECH: TM128(Transverse Mercator, 횡메카토르), 한국 표준

navSeqstring

입구점 일련번호: POI ID 로 조회 시 선택적

callbackstring

Callback 함수명 정보: application/javascript 일 때 필수

Headers

appKeystring required

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

Response

200

Example response

{
  "poiDetailInfo": {
    "id": "1128603",
    "dbKind": "S",
    "pkey": "112860300",
    "navSeq": "0",
    "name": "SKT타워",
    "bizCatName": "빌딩",
    "address": "서울 중구 을지로2가",
    "firstNo": "11",
    "mlClass": "1",
    "lcdName": "서울",
    "mcdName": "중구",
    "scdName": "을지로2가",
    "bldAddr": "서울 중구 을지로",
    "roadName": "을지로",
    "bldNo1": "65",
    "lat": "37.56648210",
    "lon": "126.98502043",
    "frontLat": "37.56656541",
    "frontLon": "126.98452047",
    "twFlag": "0",
    "upperLegalCode": "11",
    "middleLegalCode": "140",
    "lowerLegalCode": "105",
    "detailLegalCode": "00",
    "upperAdminCode": "11",
    "middleAdminCode": "140",
    "lowerAdminCode": "550",
    "totalCnt": "0"
  }
}