amap-maps
Amap LBS services. Call Amap services via Streamable HTTP MCP, supporting geocoding, route planning, POI search, weather query, distance measurement, and more.
Amap Maps Skill
Call Amap services via Streamable HTTP MCP.
Quick Start
1. Install Dependencies
cd amap-maps
npm install
2. Set Environment Variables
export AMAP_KEY="Your Amap Key"
Get Key: https://lbs.amap.com/api/javascript-api-v2/guide/abc/register
3. Use Command Line Tool
# View all commands
node scripts/amap.js help
# Query weather
node scripts/amap.js weather 北京
# Address to coordinates
node scripts/amap.js geo encode "北京市朝阳区望京 SOHO" 北京
# Coordinates to address
node scripts/amap.js geo decode "116.482384,39.998383"
# Search POI
node scripts/amap.js search text 麦当劳 北京
# Nearby search
node scripts/amap.js search around "116.48,39.99" 餐厅 1000
# Route planning
node scripts/amap.js route driving "116.48,39.99" "116.40,39.91"
node scripts/amap.js route walking "116.48,39.99" "116.40,39.91"
node scripts/amap.js route bicycling "116.48,39.99" "116.40,39.91"
node scripts/amap.js route transit "116.48,39.99" "116.40,39.91" "北京" "北京"
# Distance measurement
node scripts/amap.js distance "116.48,39.99" "116.40,39.91" 1
# IP location
node scripts/amap.js ip-location "114.114.114.114"
# Navigation Schema (generate Amap URI)
node scripts/amap.js navi "116.397428" "39.90923"
# Taxi Schema
node scripts/amap.js taxi "116.397428" "39.90923" "天安门"
Tool List (15 tools)
| Category | Command | Description |
|---|---|---|
| Weather | weather <city> | Query city weather |
| Geocoding | geo encode <address> [city] | Address → Coordinates |
geo decode <coordinates> | Coordinates → Address | |
| Search | search text <keyword> [city] | Keyword search POI |
search around <coordinates> <keyword> [radius] | Nearby search | |
search detail <POI_ID> | POI details | |
| Routes | route driving <origin> <destination> | Driving route planning |
route walking <origin> <destination> | Walking route planning | |
route bicycling <origin> <destination> | Cycling route planning | |
route transit <origin> <destination> <city> <cityd> | Transit route planning | |
| Distance | distance <origin> <destination> [type] | Distance measurement (0=linear, 1=driving, 3=walking) |
| Location | ip-location <IP> | IP location |
| Schema | navi <lon> <lat> | Generate navigation URI |
taxi <lon> <lat> <name> | Generate taxi URI |
Common Workflows
Workflow 1: Search Place → Plan Route
# 1. Search destination
node scripts/amap.js search text 天安门 北京
# 2. Get location (coordinates) from results
# 3. Plan driving route
node scripts/amap.js route driving "116.48,39.99" "116.397428,39.90923"
Workflow 2: Current Location Weather
# 1. Get city via IP location
node scripts/amap.js ip-location "114.114.114.114"
# 2. Query weather for that city
node scripts/amap.js weather 南京
Workflow 3: Nearby Exploration
# 1. Address to coordinates
node scripts/amap.js geo encode "北京市朝阳区望京 SOHO"
# 2. Search nearby restaurants
node scripts/amap.js search around "116.47,39.99" 餐厅 1000
Error Handling
Common Errors
| Error | Cause | Solution |
|---|---|---|
AMAP_KEY not set | Missing environment variable | Run export AMAP_KEY="..." |
Invalid API Key | Key is invalid or expired | Check if Key is correct |
Missing parameters | Missing required parameters | Check command format |
Rate limit exceeded | Request rate limit exceeded | Reduce request frequency |
References
Related skills
- Downloads
- 1.8kAll time
- Security audit
- Pass
- Last updated
- 6mo ago
- Current version
- v1.0.1
- License
- MIT-0
