cheap-gas-nearby

한국석유공사 오피넷(Opinet) 공식 API를 사용해 근처의 가장 싼 주유소를 찾는 Node.js 패키지입니다.

설치

배포 후:

npm install cheap-gas-nearby

이 저장소에서 개발할 때:

npm install

사용 원칙

유저 위치는 자동으로 추적하지 않습니다.
먼저 현재 위치를 묻고, 받은 동네/역명/랜드마크/위도·경도를 사용하세요.
가격 데이터는 공식 Opinet Open API를 우선 사용합니다.
위치 문자열은 Kakao Map anchor 검색으로 좌표를 잡은 뒤, Opinet aroundAll.do 검색으로 연결합니다.
공식 API key (OPINET_API_KEY) 또는 apiKey 옵션이 필요합니다.

공식 표면

오픈 API 안내: https://www.opinet.co.kr/user/custapi/openApiInfo.do
반경 내 주유소: https://www.opinet.co.kr/api/aroundAll.do
주유소 상세정보(ID): https://www.opinet.co.kr/api/detailById.do
지역코드: https://www.opinet.co.kr/api/areaCode.do
Kakao Map anchor 검색: https://m.map.kakao.com/actions/searchView

사용 예시

const { searchCheapGasStationsByLocationQuery } = require("cheap-gas-nearby");

async function main() {
  const result = await searchCheapGasStationsByLocationQuery("서울역", {
    apiKey: process.env.OPINET_API_KEY,
    radius: 1000,
    productCode: "B027",
    limit: 3
  });

  console.log(result.anchor);
  console.log(result.items);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

공개 API

parseSearchResultsHtml(html)
selectAnchorCandidate(query, items)
normalizeAnchorPanel(panel, searchItem)
wgs84ToKatec(latitude, longitude)
buildAroundSearchParams(options)
parseAroundResponse(payload)
normalizeDetailItem(payload)
searchCheapGasStationsByCoordinates(options)
searchCheapGasStationsByLocationQuery(locationQuery, options)