Maintenance and Troubleshooting

Routine tasks

Update CSV data – Pull the latest price files regularly and store them locally (not in git). Verify the schema stays consistent.
Rotate Kakao keys – Monitor API usage and rotate REST keys if they are compromised or near quota limits.
Refresh dependencies – Periodically upgrade pandas and requests to benefit from security patches. Re-run the CLI smoke test afterward.
Tag releases – Create annotated git tags (e.g., v0.0.1) whenever you ship notable changes so release notes stay accurate.

RuntimeError: KAKAO_REST_API_KEY not set: The environment variable is missing. Export it in the same shell session or configure it via a .env/login script.
지오코딩 성공한 주유소가 없습니다.: Kakao Local could not geocode any addresses. Check for typos in the CSV, ensure the API key has Local permissions, and confirm there is no firewall blocking outbound HTTPS requests.
후보 주유소가 없습니다(버퍼 기준).: All stations were filtered out during preselect_candidates. Increase ROUTE_BUFFER_KM or confirm the CSV actually contains entries for the specified corridor.
requests.exceptions.HTTPError from Kakao Mobility: Usually indicates an invalid request or exhausted quota. Inspect the --debug logs for the failing station and verify origin/destination coordinates are valid.
Slow performance: Excessive API calls can slow down evaluation. Reduce TOPK_BY_PRICE or implement result caching if you run the tool continuously.