skills.rest
openakita
openakitaCOMMUNITY
Explore all skills by this author →
GitHub

openakita/skills@amap-maps

Queries Amap Maps APIs for POI search, route planning, geocoding, and weather.

2.0k|274|Updated Jan 30, 2026
Search Tags:#travel planning#weather#geocoding#amap#route planning#poi search#gaode maps
One-click install
npx skills add https://github.com/openakita/openakita --skill openakita-skills-amap-maps
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openakita/skills@amap-maps
Source: https://github.com/openakita/openakita/tree/main/skills/amap-maps
Command: npx skills add https://github.com/openakita/openakita --skill openakita-skills-amap-maps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It gives AI agents programmatic access to Amap (Gaode) Maps web services, eliminating manual lookups for location search, route planning, and geographic data in China.

Core Features & Use Cases

  • POI & Nearby Search: Find places by keyword, city, or coordinates using the Amap place APIs.
  • Route & Travel Planning: Compute walking, driving, cycling, and transit routes, plus multi-interest travel itineraries for a city.
  • Geocoding & Weather: Convert addresses to coordinates (and back) and query weather by city code.
  • Use Case: Ask the agent to plan a walking route from Tiananmen to the Forbidden City, or find coffee shops near a Beijing address, and it returns structured JSON results via the Amap API.

Quick Start

Set the AMAP_WEBSERVICE_KEY environment variable, then ask the agent to search for coffee shops near a Beijing address using the amap-maps skill.

Frequently Asked Questions about openakita/skills@amap-maps

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

FAQPage Schema
How do I search for POIs with the Amap Maps API?▼

Run the amap_tool.py script with the poi command, passing keywords and an optional city, for example: python3 scripts/amap_tool.py poi "coffee" --city Beijing. It calls the Amap place/text endpoint and returns JSON results.

How to plan a driving or walking route with Amap?▼

Use the drive or walk subcommands with --from and --to arguments, which accept either coordinates (lng,lat) or plain addresses. Addresses are automatically geocoded before calling the Amap direction API.

What API key does the Amap Maps skill require?▼

It requires an AMAP_WEBSERVICE_KEY environment variable obtained from the Amap open platform at lbs.amap.com. Without this key, the script exits with an error message asking you to set it.

Does the Amap tool support reverse geocoding and weather queries?▼

Yes. The reverse command converts lng,lat coordinates to an address via the regeo endpoint, and the weather command queries current weather by city code or name using the weatherInfo endpoint.

Why does Amap route planning fail with an address input?▼

Route planning fails when the address cannot be geocoded into coordinates, returning an error that the origin or destination could not be resolved. Use more specific addresses or pass explicit lng,lat coordinates instead.

Related Skills

Explore More Personal & Entrepreneur Skills→
wulaosijiwulaosiji
28

amap-navigator

Provide geocoding, routing, and point-of-interest searches via the Amap API.

Community
Intermediate
opensquillaopensquilla
6.8k

meta-travel-planner

Generates day-by-day travel itineraries by orchestrating weather, search, and constraint-extraction steps.

Official
Advanced
LirsakuraLirsakura
10

international-travel

Provides travel planning advice with multilingual support and pricing in two currencies.

Community
Intermediate
NoDeskAINoDeskAI
8

caring-startup-dog

Analyze Feishu messages and Cursor/Claude Code activity to infer work state hourly.

Official
Advanced