baidu-map

What This Skill Does

The baidu-map skill enables your OpenClaw AI agent to interact with the comprehensive Baidu Map Web Services API. It functions as a powerful geographic intelligence layer, allowing the agent to perform real-time location searches, pathfinding across various transit modes (driving, walking, transit), and coordinate-address translations. Whether you need to find the nearest coffee shop, convert a street address into GPS coordinates for mapping software, or calculate the most efficient driving route between two distant cities, this skill acts as the bridge between raw location data and actionable insights. By leveraging the industry-leading Baidu map database, the agent can provide highly accurate local context for users.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/coreyleung-art/baidu-map-api

After installation, you must obtain an Access Key (AK) from the Baidu Map Open Platform. Set this key as an environment variable named BAIDU_MAP_AK. The OpenClaw agent will automatically detect and utilize this key for all API authentication requests. Without this key, the service will return authentication errors.

Use Cases

This skill is essential for agents acting as personal assistants, travel planners, or logistics coordinators. It handles complex geographic queries, such as identifying the coordinates of a business, calculating travel times for logistics, or providing context for weather services. It is particularly effective for location-based information retrieval and cross-referencing physical addresses with digital map datasets.

Example Prompts

1. "Could you search for the nearest public library within a 1km radius of my current office location?"
2. "I need to get from Zhongguancun to the Forbidden City. What is the best route using public transportation?"
3. "Please convert this address, No. 10 Xidan North Street, Beijing, into its precise latitude and longitude coordinates."

Tips & Limitations

To maximize the utility of the baidu-map skill, always ensure that your input location strings are as specific as possible to avoid ambiguous search results. When performing radius-based searches, remember that the default search range is 1000 meters; you can adjust the radius parameter for broader or narrower results. Be mindful of the coordinate system; Baidu uses the BD09 system, so if you are passing data from GPS or other mapping software, you may need to account for coordinate conversion. Finally, monitor your API usage on the Baidu developer dashboard, as excessive calls exceeding your plan's quota will result in service interruptions.