amap-web-servicelisted
Install: claude install-skill kiakun-collab/kiakun-skills
# AMap Web Service
Use this skill to obtain structured results from AMap's server-side Web Service API. Run the bundled CLI instead of rebuilding request and error-handling logic.
## Configuration
The CLI reads the Web Service key from `AMAP_WEBSERVICE_KEY`. If the user provides a local environment file, pass it with `--env-file`; never print, log, commit, or embed the key in generated URLs or source files.
```powershell
python scripts/amap_cli.py --env-file .env regeo "116.397428,39.909230"
```
If no key is available, ask the user to configure a **Web Service Key** from the AMap Open Platform. Do not substitute a Web JS API key.
## Workflow
1. Identify the needed operation and required parameters.
2. Keep all coordinates in `longitude,latitude` order and treat AMap coordinates as GCJ-02.
3. Run one of the CLI commands below. Add `--env-file <path>` before the subcommand when needed.
4. Parse the returned JSON. Preserve AMap's factual fields and distinguish API results from interpretation.
5. For route estimates or POI availability, mention the query date when the result will be used operationally.
```powershell
python scripts/amap_cli.py place "地铁站" --city "上海" --types 150500 --city-limit --pages 2
python scripts/amap_cli.py regeo "121.473701,31.230416" --extensions all
python scripts/amap_cli.py walking "121.473701,31.230416" "121.481000,31.233000"
python scripts/amap_cli.py transit "121.473701,31.230416" "121.499700,31.239700" --city "上海"
python scripts/amap_cli.py