v1

latestOpenAPI 3.1.02026-07-14320308.9 KB

주변 명칭(POI)상세 검색

get/oilinfo/aroundOil

Query parameters

versioninteger required
pageinteger

조회할 목록의 페이지를 지정합니다.<br>- 유효 값 : 1~200

countinteger

페이지당 출력되는 개수를 지정합니다.<br>- 유효값 : 1~200<br>- POI 최대 검색 개수는 200개까지만 지원합니다.

categoriesstring

여러개의 업종 검색시 ';'로 구분하여 나열합니다.<br>-편의점;은행;숙박;마트;지하철

centerLonnumber float required

반경 검색에서 사용하는 중심 좌표의 경도 좌표입니다.

centerLatnumber float required

반경 검색에서 사용하는 중심 좌표의 위도 좌표입니다.

radiusinteger

검색반경 (1~33), 단위 “1”=1km<br>전국 반경으로 검색 시 단위 “0” 입력

reqCoordTypestring

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

resCoordTypestring

받고자 하는 응답 좌표계 유형을 지정합니다.<br>지구 위의 위치를 나타내는 좌표 타입 종류로, 투영 방법에 따라 다음과 같이 나뉩니다. <br><br>1) EPSG3857<br>- Google Mercator<br><br>2) WGS84GEO(기본값)<br>- 경위도<br><br>3) KATECH<br>- TM128(Transverse Mercator:횡메카토르): 한국 표준

multiPointstring

멀티입구점 미지원 여부 (“Y”:멀티입구점 미지원, “N”멀티입구점 지원).

callbackstring

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

sortstring

응답값 정렬 기준<br>score : 정확도순<br>distance : 거리순 (default)<br>price : 가격순

Headers

appKeystring required

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

Response

200

Example response

{
  "searchPoiInfo": {
    "totalCount": 5,
    "count": 2,
    "page": 1,
    "pois": {
      "poi": [
        {
          "id": "466860",
          "name": "SK 서광셀프주유소",
          "telNo": "025624855",
          "frontLat": "37.49443581",
          "frontLon": "127.03501791",
          "noorLat": "37.49435248",
          "noorLon": "127.03504569",
          "upperAddrName": "서울",
          "middleAddrName": "강남구",
          "lowerAddrName": "역삼동",
          "mlClass": "1",
          "firstNo": "834",
          "secondNo": "47",
          "roadName": "역삼로",
          "buildingNo1": "142",
          "rpFlag": "8",
          "parkFlag": "Y",
          "radius": "0.76",
          "dataKind": "3",
          "stId": "SK",
          "highHhSale": "1",
          "minOilYn": "N",
          "oilBaseSdt": "20181130",
          "hhPrice": "1555",
          "ggPrice": "1415",
          "llPrice": "0",
          "highHhPrice": "1715",
          "highGgPrice": "0",
          "pkey": "788491401",
          "evChargers": {
            "evCharger": [
              {
                "operatorId": "EV",
                "stationId": "EV003458",
                "chargerId": "01",
                "status": "2",
                "type": "02",
                "chargingDateTime": "20210910003307",
                "updateDateTime": "20210910003646",
                "isFast": "N",
                "isAvailable": "Y"
              }
            ]
          }
        }
      ]
    }
  }
}