충전소체크
Data Readiness

실데이터 전환 체크리스트

전국 전기차 충전소 페이지를 만들기 위해 필요한 공공데이터 호출, 표준데이터 보완, 지도 설정 상태를 확인할 수 있습니다.

3/4핵심 준비 항목
0API 실패
2값 미설정
2026. 6. 23. PM 3:24:36진단 시각

연결 상태

실데이터 전환에 필요한 외부 원천별 현재 상태입니다.

진단 상세

공공데이터포털 전기차 API

getChargerInfo HTTP 200 · getChargerStatus HTTP 200

요청 시도 총 2회 · 프로토콜 https · 키 파라미터 serviceKey · 키 형식 원본 키 · 응답 형식 JSON

준비 완료공공데이터 OpenAPI

카카오맵

충전소 상세 페이지의 위치 지도에 사용합니다. 로컬 확인에는 localhost 도메인 등록이 필요합니다.

키 설정됨카카오맵 가이드

관련 블로그/카페 글

블로그 ok · 카페 ok · 상세 페이지 하단 보조 링크로만 사용

선택 기능 준비

사이트 소유확인·AdSense

환경변수로 Google/Naver verification, AdSense client, 광고 슬롯을 넣으면 배포 빌드에 반영됩니다.

배포 전 입력

좌표 기반 지역 보강

도로명주소에 동명이 없을 때 sync:data -- --geocode가 충전소 좌표로 동/읍/면 값을 보강합니다. 현재 진단: KAKAO_REST_API_KEY is missing

REST 키 필요

전환 순서

공공데이터 호출이 안정화되면 아래 순서로 캐시를 새로 만듭니다.

  1. npm run check:apis로 getChargerInfo/getChargerStatus 응답 확인
  2. npm run sync:data -- --geocode --dry-run으로 좌표 보강 결과 확인
  3. 검증 후 npm run sync:data -- --geocode로 전기차 충전소 캐시 갱신
  4. npm run lint와 npm run build로 페이지 생성 확인
  5. sitemap을 Google Search Console과 네이버 서치어드바이저에 제출

서버 이전 기준

로컬 JSON 캐시가 안정화되면 같은 필드를 DB 테이블로 옮깁니다.

스냅샷 JSON

핵심 테이블은 stations, chargers, external_articles, data_reports, sync_statuses입니다. 화면 URL은 유지하고 repository 읽기 함수만 DB 조회로 바꾸는 방식이 가장 안전합니다.

자주 묻는 질문

방문 전에 확인하기 쉬운 항목만 데이터 기준으로 답합니다.

한국환경공단 전기차 API가 실패하면 무엇을 확인해야 하나요?

공공데이터포털에서 한국환경공단_전기자동차 충전소 정보 OpenAPI 활용신청이 해당 계정의 인증키에 연결됐는지 확인해야 합니다. 이 앱은 serviceKey와 ServiceKey 요청 변형을 키 노출 없이 검사합니다.

도로명주소에 동명이 없으면 어떻게 처리하나요?

주소 문자열만 보지 않고 충전소 좌표를 기준으로 행정동/법정동을 보강합니다. KAKAO_REST_API_KEY를 넣은 뒤 sync:data -- --geocode를 실행해야 역북동처럼 주소에 동명이 빠진 충전소도 동 페이지에 들어갈 수 있습니다.

서버 DB로 옮길 때 URL 구조가 바뀌나요?

바꾸지 않는 것이 좋습니다. /ev/[sido]/[sigungu]/[dong]와 /ev/station/[stationId] 구조를 유지하고, 로컬 JSON 읽기만 DB 조회로 바꾸는 흐름이 맞습니다.