amap-maps

What This Skill Does

The amap-maps skill provides a powerful interface for Amap (Gaode) LBS services directly within the OpenClaw environment. By leveraging Streamable HTTP MCP, this skill acts as a bridge to comprehensive geospatial data. It empowers your AI agent to perform complex location-based tasks, including geocoding (address to coordinate translation and vice versa), real-time weather reporting, POI searching, and multi-modal route planning (driving, walking, cycling, and public transit). Additionally, it supports distance measurements, IP-based location lookups, and the generation of deep-link URIs for external navigation or taxi-hailing applications. It is an essential toolkit for any agent that needs to navigate, understand, or interact with physical space in China.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/elric2011/amap-maps

After installation, navigate to the skill directory, run npm install to resolve dependencies, and ensure you have an active Amap Key configured. Set this key in your environment variables via export AMAP_KEY="Your Amap Key" to authenticate your requests against Amap's LBS service endpoints.

Use Cases

This skill is ideal for logistical planning, travel assistance, and location-aware automation. Common scenarios include finding the best route between two points, checking if weather conditions might delay a trip, or converting raw location data into human-readable addresses. Businesses can utilize the POI search feature to locate nearby facilities or delivery points, while developers can use the navigation and taxi schema tools to build seamless hand-offs between their AI agents and mobile applications.

Example Prompts

1. "What is the current weather in Shanghai, and can you find me the closest Starbucks to the People's Square?"
2. "Plan a public transit route from my current location (116.48, 39.99) to the Beijing Capital Airport and estimate the travel time."
3. "Convert these coordinates (116.397428, 39.90923) into an address and generate a taxi-hailing link for that destination."

Tips & Limitations

• Accuracy: The IP location tool provides city-level accuracy; for precise navigation, always use explicit GPS coordinates when possible.
• Authentication: Ensure your Amap Key has the necessary web service permissions enabled in the Amap developer console.
• Rate Limits: Be mindful of API rate limits imposed by Amap; cache results locally where appropriate if your agent performs frequent lookups.
• Data Privacy: This skill interacts with third-party LBS services; ensure your usage complies with Amap's terms of service regarding data caching and retention.