스킬 레지스트리
커뮤니케이션 및 지식공개 스킬

Maps & Geolocation

AI 에이전트를 위한 위치 인텔리전스 — 지오코딩, 턴바이턴 경로 안내, 관심 지점(POI) 탐색, 고도, 거리 행렬, 시간대 조회. 설정 불필요, 무료, OpenStreetMap 기반 전 세계 커버리지.

이 스킬이 가르치는 것

특정 작업 유형을 위한 재사용 가능한 플레이북입니다.

MCP 서버는 에이전트에게 어떤 작업이 가능한지 알려줍니다. 스킬은 그 작업들에 대한 판단을 추가합니다: 작업을 인식하는 방법, 따라야 할 순서, 피해야 할 것, 그리고 결과가 완료되었는지 결정하는 방법.

지리 위치 작업을 조율하세요 — 주소 지오코딩, 턴바이턴 경로 계산, 관심 지점 검색, 고도 데이터 획득, 거리 행렬 계산, 시간대 결정 등을 수행합니다. 주소를 좌표로 변환, 운전 경로 안내, 인근 장소 찾기, 거리 계산 시 사용하세요…

아키텍처

Maps & Geolocation이(가) ADK-Rust 에이전트를 어떻게 안내하는지.

스킬은 서비스 자격 증명이나 비즈니스 데이터를 포함하지 않고 지침만 포함하므로 읽기 쉽고 휴대 가능합니다. ADK-Rust가 에이전트에 제공하고, 에이전트는 검토된 도구 경계에서 선택하며, 연결된 MCP 서버가 인증된 작업을 수행합니다.

01

사용자 요청

에이전트는 일반 언어로 표현된 목표를 받습니다.

02

Maps & Geolocation 스킬

의도를 일치시키고 결정 가이드를 제공하며 도구 경계를 좁힙니다.

03

ADK-Rust 에이전트

워크플로우를 계획하고 각 의미 있는 단계를 런타임을 통해 스트리밍합니다.

04

mcp-maps

기능을 소유한 시스템에 대해 인증된 작업을 실행합니다.

05

검증된 결과

스킬의 완료 규칙은 사용자에게 반환되는 증거를 형성합니다.

휴대 가능한 지침: SKILL.md · 기능 경계: mcp-maps · 허용된 도구: 7

결정 가이드

에이전트가 요청을 올바른 작업으로 전환하는 방법입니다.

이 경로들은 스킬 지침에서 직접 가져온 것입니다. 모델이 의도를 인식하고 전체 기능 범위 대신 집중된 도구나 워크플로우를 선택하도록 돕습니다.

01

"where is", "coordinates", "geocode", "address to"?

geocode

02

"what's at", "address of", "reverse"?

reverse_geocode

03

"route", "directions", "how to get to", "drive"?

get_route

04

"nearby", "find", "restaurants", "hospitals", "ATM"?

search_poi

05

"distance", "how far", "between"?

distance_matrix

06

"elevation", "altitude", "height"?

get_elevation

07

"timezone", "what time", "UTC offset"?

get_timezone

검증된 워크플로우

유용한 결과를 위한 반복 가능한 시퀀스입니다.

워크플로우는 여러 도구 호출을 사용자가 실제로 인식하는 작업으로 결합합니다. 스킬은 순서와 의도된 결과를 설명하며 ADK-Rust는 공유 런타임을 통해 에이전트의 진행 상황을 스트리밍합니다.

011-2개의 호출

길찾기

거리 및 소요 시간 포함 턴바이턴 안내

021-2개의 호출

인근 찾기

카테고리 및 반경별 POI 검색

031개의 호출

거리 행렬

여러 지점 간 모든 쌍 거리 계산

041개의 호출

시간대

국가 및 UTC 오프셋 조회

051개의 호출

고도

임의 좌표의 고도 확인

도구 경계

스킬은 7개의 문서화된 도구를 사용할 수 있습니다.

이 허용 목록은 스킬에서 선언합니다. 에이전트가 이 작업에 필요한 행동에 집중하도록 유지하며, mcp-maps는 인증, 검증, 연결된 시스템에 대한 책임을 집니다.

geocode
reverse_geocode
get_route
get_elevation
search_poi
distance_matrix
get_timezone

작동 규칙

에이전트가 해야 할 것

  • 경로 결과에 거리와 소요 시간 모두 포함
  • 운송 수단(운전/도보/자전거)을 명시 — 가정하지 마세요
  • 단위 포함 (km/마일, 분/시간)
  • POI 검색 시 반경 지정 (50km 이상 결과 제외)

운영 경계

에이전트가 피해야 할 것

  • 운송 수단이 불명확하면 가정하지 말고 문의
  • 좌표만 반환하지 말고 장소 이름 포함
  • 요청 제한(지오코딩 1초당 1회) 준수

설치 및 연결

기능이 기대하는 스킬을 그 옆에 추가하세요.

ADK-Rust 스킬 로더가 발견할 수 있는 저장소에 설치하고, mcp-maps에 연결하며, 선언된 도구가 사용 가능한지 확인한 후 에이전트에게 워크플로우 사용을 요청하세요.

스킬 설치
git clone https://github.com/zavora-ai/skill-maps-geolocation.git \
  ~/.skills/skills/maps-geolocation
ADK-Rust 로딩 형태
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("maps-geolocation").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

저장소의 호환성 선언: mcp-maps 서버 연결 필요 (OpenStreetMap, OSRM, OpenTopoData — 무료, API 키 불필요, 설정 없음).

공식 문서

완전한 스킬 패키지를 읽어보세요.

저장소는 정확한 지침, 예제, 헬퍼 스크립트, 자산, MCP 요구사항, 라이선스, 이후 업데이트에 대해 권위 있는 출처로 남아 있습니다.

소스 기록

이 스킬 항목의 저장소 메타데이터입니다.

공개 저장소 보기 ↗
라이선스
Apache-2.0
허용된 도구
7
참조
3
수정
e709ece01593
업데이트됨
2026년 5월 31일