# Gaode Map

> A skill to interact with Gaode Map (AMap) for location search and route planning.

- Skill: `dvcrn/gaode-map` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add dvcrn/gaode-map`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/gaode-map/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/gaode-map

---


# Gaode Map Skill

This skill allows you to search for places and plan routes using Gaode Map (AMap) API.

## Usage

You can use the `amap_tool.py` script to perform actions. The API Key is expected to be in the `AMAP_API_KEY` environment variable.

### Place Search
Search for POIs (Points of Interest).

**Command:**
```bash
python amap_tool.py search --keywords "<keywords>" [--city "<city>"]
```

**Parameters:**
- `keywords`: The search query (e.g., "restaurants", "gas station").
- `city`: (Optional) The city to search in.

### Route Planning
Plan a route between two locations.

**Command:**
```bash
python amap_tool.py route --origin "<origin>" --destination "<destination>" [--mode "<mode>"] [--city "<city>"]
```

**Parameters:**
- `origin`: Start location (address or coordinates "lon,lat").
- `destination`: End location (address or coordinates "lon,lat").
- `mode`: (Optional) Route mode: `driving` (default), `walking`, `bicycling`, `transit`.
- `city`: (Optional) City name (required for `transit` mode, or to help geocoding).

## Examples

**User:** "Find coffee shops in Shanghai."
**Action:**
```bash
python amap_tool.py search --keywords "coffee shop" --city "Shanghai"
```

**User:** "Show me the driving route from Beijing West Station to the Forbidden City."
**Action:**
```bash
python amap_tool.py route --origin "Beijing West Station" --destination "Forbidden City" --mode "driving" --city "Beijing"
```