Gaode Map (AMap) Integration for Openclaw

A Python-based skill for integrating Gaode Map (AMap) capabilities like POI search and multi-modal route planning into AI agent workflows.

279458179
v1.0.0
Feb 14, 2026
3
2.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install gaodemapskill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install gaodemapskill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Gaode Map (AMap) Integration?

The Gaode Map skill provides a robust interface for AI agents to interact with the AMap API, enabling location-aware functionalities. By utilizing this skill within the Openclaw Skills framework, developers can empower their agents to look up specific points of interest (POIs) and calculate complex routes across China with high accuracy. It acts as a bridge between raw geographic data and actionable agent responses.

This skill is particularly useful for developers building travel assistants or local discovery tools. It simplifies the complexity of geocoding and routing by providing a streamlined CLI-based interaction model that fits naturally into any Openclaw Skills implementation.

Gaode Map (AMap) Integration Use Cases

  • Finding specific businesses or services like coffee shops, gas stations, or restaurants within a specific city.
  • Planning travel routes between two locations using various transportation modes including driving and public transit.
  • Integrating geographic data into automation workflows that require precise location searching and navigation.
  • Enhancing travel-related AI assistants with real-time mapping and routing data.

How Gaode Map (AMap) Integration Works

  1. The skill interfaces with the Gaode Map API using a dedicated Python script and a valid API key provided via environment variables.
  2. Users or agents provide keywords for searching or origin/destination points for routing via command-line arguments.
  3. The tool processes geocoding automatically to convert address strings into coordinates required by the AMap backend.
  4. It returns structured location or route data which can then be parsed and presented by the calling agent within the Openclaw Skills ecosystem.

Gaode Map (AMap) Integration Setup

To get started with this skill, you must have Python installed and obtain an API Key from the Gaode Open Platform. Configure your environment as follows:

# Set your Gaode Map API Key
export AMAP_API_KEY='your_api_key_here'

# Run a test search
python amap_tool.py search --keywords "coffee shop" --city "Shanghai"

Gaode Map (AMap) Integration Data Schema & Taxonomy

The skill processes location data and route information based on a flexible schema. Below are the primary fields used during interaction:

Parameter Type Description
keywords String The search query for Points of Interest (POIs).
origin String The start location, accepting either an address or "lon,lat" coordinates.
destination String The end location, accepting either an address or "lon,lat" coordinates.
mode String The transportation mode: driving, walking, bicycling, or transit.
city String Optional city name to refine search results or geocoding accuracy.

Gaode Map (AMap) Integration Advanced Features

  • Multi-modal routing support allowing agents to switch between driving, cycling, and public transportation data.
  • Automatic geocoding that resolves human-readable addresses into precise longitudinal and latitudinal coordinates.
  • Direct integration into Openclaw Skills allowing for complex multi-agent coordination in travel planning.
  • City-level filtering to ensure high precision in search results within dense urban environments.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*