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
Ready to run
npx skills add https://github.com/NomaDamas/k-skill --skill naver-map-route
๐Ÿ’ฌ Prompt for ChatGPT / Claude Chatโ–ผ
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.