naver-map-route

Convert addresses to coordinates and query NAVER Cloud Platform Maps Directions 5 for car route summaries.

7.1k|836|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill naver-map-route
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: naver-map-route
Source: https://github.com/NomaDamas/k-skill/tree/main/naver-map-route
Command: npx skills add https://github.com/NomaDamas/k-skill --skill naver-map-route

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

차량 경로를 찾기 위해 출발지·목적지를 직접 입력하고, 거리·소요시간·통행료·연료비 요약까지 확인하느라 시간을 낭비하는 문제를 해결합니다.

Core Features & Use Cases

  • 자동차 길찾기 요약: 출발지와 목적지(주소 또는 좌표)를 받아 거리, 예상 소요시간, 통행료, 연료비를 한 번에 정리해 줍니다.
  • 주소↔좌표 변환(지오코딩/역지오코딩): 주소만 주어도 좌표로 변환한 뒤 길찾기를 수행합니다.
  • 프록시 기반 조회 + 안전한 mock fallback: live 모드는 k-skill-proxy를 통해서만 호출되며, 키 미설정/인증 실패/네트워크 이슈가 생기면 mock 결과로 안전하게 대체합니다.

Quick Start

AI에게 "/route 강남역에서 시청역"라고 말해 네이버 지도 기반 경로 요약을 받아보세요.

Frequently Asked Questions about naver-map-route

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get driving directions and toll costs without opening an interactive map?

You can get a car route summary including distance, duration, toll, and fuel cost by providing a start and goal address or coordinate to the route planning function. It converts addresses via geocoding and queries the map API to return a concise driving summary without interactive map usage.

Can I use a plain text address for route planning if I don't have exact coordinates?

Yes, route planning supports manual address inputs by performing geocoding to convert them into coordinates before querying the map API. You do not need exact coordinates to get driving directions, distance, and cost summaries.

Do I need a proxy to call the Naver Map API for transit and driving directions?

Live mode requires a proxy to call the map API for driving directions, but the system supports mock fallback when the upstream provider is disabled or misconfigured. If the API key is missing or authentication fails, it safely returns mock results instead of erroring out.

What happens if the map API key is missing or the network fails during route planning?

When the map API key is missing or network issues occur during route planning, the system safely falls back to mock results instead of failing. This ensures you still receive a route summary output even if the upstream provider is disabled or misconfigured.

What is the best way to calculate estimated fuel cost and toll for a car trip?

The best way to calculate estimated fuel cost and toll for a car trip is to query a route planning API that returns a driving summary with these fields included. You provide start and goal locations, and the API calculates distance, duration, toll, and fuel cost together.

Does mock fallback affect the accuracy of driving directions and distance results?

Yes, mock fallback affects accuracy because it returns simulated driving directions and distance results instead of live API data. It is designed as a safe fallback when the upstream provider is disabled or misconfigured, not for accurate route planning.