Gaode-Map-skills

Interact with Gaode Map API to search places and plan routes using driving, walking, bicycling, or transit modes with optional city context.

Security Scan

The skill's code, instructions, and required environment variable (AMAP_API_KEY) are consistent with its stated purpose of calling the Gaode/AMap REST API for place search and routing.

Purpose & Capability

Name/description, required binary (python), required env var (AMAP_API_KEY), and the included amap_tool.py client all align: they only call the AMap REST API for place search, geocoding, and route planning. No unrelated services, credentials, or binaries are requested.

Instruction Scope

SKILL.md instructs the agent to run amap_tool.py with arguments and to provide AMAP_API_KEY via env or --key. The script only performs HTTP requests to restapi.amap.com, parses JSON, and prints results; it does not read other system files, home directory configs, or additional environment variables.

Install Mechanism

There is no remote installer or download-from-URL behavior. The package is instruction-only in the registry but includes source and a requirements.txt with 'requests' (a standard dependency). Installation is a normal pip install -r requirements.txt as described in README; no unusual install-time network fetches beyond PyPI.

Credentials

Only AMAP_API_KEY is required (and python on PATH). That is proportional and expected for calling the AMap API. The code also allows passing the key via --key. No other credentials/config paths are requested.

Persistence & Privilege

The skill does not request always:true, does not modify other skills' configs, and does not request persistent system privileges. It is user-invocable and can be invoked autonomously (platform default), which is expected for a skill of this type.

Assessment

The skill appears to be what it says: a small Python client for the Gaode/AMap REST API. Before installing, confirm you trust the skill source (homepage unknown, owner ID present) and are comfortable providing an AMAP_API_KEY; the key will be sent to AMap endpoints. Use a dedicated API key with minimal permissions/quota limits if possible. Review the included amap_tool.py yourself (it's short and readable) before granting the key. Installation requires pip install requests; run installs in a virtualenv if you prefer isolation. If you require higher assurance, ask the publisher for a homepage or repository to verify provenance.

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:

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:

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:

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:

python amap_tool.py route --origin "Beijing West Station" --destination "Forbidden City" --mode "driving" --city "Beijing"