gaode_map

What This Skill Does

The Gaode Map (AMap) skill provides the OpenClaw AI agent with powerful spatial capabilities by integrating with China's leading mapping platform. This skill enables the agent to perform geographic queries and logistics calculations, essentially giving the AI an understanding of physical locations and how to traverse them. By utilizing the official AMap API, it bridges the gap between digital queries and real-world navigation, allowing for seamless POI (Point of Interest) discovery and multi-modal route optimization. Whether you are looking to find specific businesses, landmarks, or calculate the most efficient way to travel between two points, this tool provides the necessary logic to execute these tasks accurately.

Installation

To integrate this functionality into your environment, use the OpenClaw CLI tool. Ensure you have your Gaode Map API Key ready, as it must be stored in the AMAP_API_KEY environment variable for the underlying scripts to authenticate. Run the following command in your terminal: clawhub install openclaw/skills/skills/279458179/gaodemapskill After installation, verify that your environment variables are correctly configured to point to your API key, or the tool will return an authentication error when attempting to call the AMap services.

Use Cases

This skill is highly effective for developers and power users who need to automate location-based tasks. Common use cases include generating travel itineraries, integrating location search into custom workflows, analyzing proximity data for business research, and providing real-time transit directions within a chat-based interface. It is particularly useful for agents managing logistical planning, urban exploration bots, or productivity assistants tasked with scheduling meetings that require travel calculations.

Example Prompts

1. "Find the nearest pharmacy in Hangzhou and tell me how long it takes to drive there."
2. "Plan a walking route from the Oriental Pearl Tower to the Bund in Shanghai."
3. "Show me all the high-rated gas stations along the highway in the Fengtai district of Beijing."

Tips & Limitations

To maximize the reliability of the output, always provide specific city names when performing searches, as this helps the geocoding service disambiguate results. Note that the transit mode requires a city context to function correctly. Ensure your API key has the necessary quotas for map services, as high-frequency usage may hit limits. Finally, coordinate inputs are expected in "longitude,latitude" format; reversing these will cause navigation errors. Be aware that the accuracy of routes depends on real-time traffic data provided by the AMap backend.