skills.rest
openakita
openakitaCOMMUNITY
Explore all skills by this author →
GitHub

openakita/skills@baidu-maps

Query Baidu Maps APIs for geocoding, POI search, and driving route planning.

2.0k|274|Updated Jan 30, 2026
Search Tags:#geocoding#route planning#poi search#baidu maps#Navigation#china maps#location api
One-click install
npx skills add https://github.com/openakita/openakita --skill openakita-skills-baidu-maps
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openakita/skills@baidu-maps
Source: https://github.com/openakita/openakita/tree/main/skills/baidu-maps
Command: npx skills add https://github.com/openakita/openakita --skill openakita-skills-baidu-maps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It gives AI agents programmatic access to Baidu Maps Web services so users can search locations, convert addresses to coordinates, and plan driving routes in China without writing API integration code themselves.

Core Features & Use Cases

  • Geocoding & Reverse Geocoding: Convert Chinese addresses to latitude/longitude coordinates and back via the Baidu Geocoding v3 API.
  • POI & Nearby Search: Find places by keyword within a region, such as restaurants or landmarks, using the Place v2 search endpoint.
  • Driving Route Planning: Compute driving directions between two coordinate pairs through the Direction v2 API.
  • Use Case: A user planning a trip in Chengdu asks the agent to find hotpot restaurants nearby and then get driving directions from their hotel to the chosen restaurant.

Quick Start

Set the BAIDU_MAP_AK environment variable with your Baidu Maps Web service API key, then ask the agent to search for a place or plan a route, for example: find coffee shops in Beijing and plan a driving route between two coordinates.

Frequently Asked Questions about openakita/skills@baidu-maps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Chinese address to latitude and longitude?▼

Use the geocode command of the baidu_maps.py script with the address as an argument. It calls the Baidu Geocoding v3 API and returns JSON containing the precise latitude and longitude coordinates.

How to search for nearby places with Baidu Maps API?▼

Run the poi command with a keyword and a region parameter, such as a city name. The script queries the Baidu Place v2 search endpoint and returns matching points of interest with pagination support.

What API key do I need for Baidu Maps web services?▼

You need a Baidu Maps Web service API key (AK) set as the BAIDU_MAP_AK environment variable. Without it, the script exits with an error message asking you to configure the key.

Does Baidu Maps route planning support walking or transit directions?▼

The current script only implements driving route planning through the Direction v2 driving endpoint. Walking, cycling, and public transit modes are not included in this implementation.

Why does the Baidu Maps script return an HTTP error?▼

HTTP errors usually indicate an invalid or expired AK, exceeded quota, or malformed coordinates. The script prints the error detail from the API response to stderr to help diagnose the issue.

Related Skills

Explore More Software Engineering Skills→
aiagenta2zaiagenta2z
3

baidu-maps-sse

Access Baidu Maps SSE tools through the OneKey Router.

Official
Intermediate
gked2121gked2121

itinerary-optimizer

Optimize multi-stop travel itineraries with routing, timelines, and buffer periods.

Community
Intermediate
acabreragnzacabreragnz

run-prep

Generate race preparation plans with meal, hydration, and rest schedules.

Community
Intermediate
wulaosijiwulaosiji
28

amap-navigator

Provide geocoding, routing, and point-of-interest searches via the Amap API.

Community
Intermediate