← Back to Skills Marketplace
234
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install amap-integration
Description
Map and location services for search, routing, and visualization. Provides geocoding, POI search, route planning, and heatmap generation capabilities.
README (SKILL.md)
Map Integration Service
This skill provides map-based services including location search, routing, and data visualization.
Features
1. Location Search
For general searches without API key:
- Generate search URL:
https://www.amap.com/search?query={keywords} - Returns clickable link for user
2. Nearby Search (Requires API Key)
For "search near X" queries:
- Use geocoding API to get coordinates
- Generate nearby search link
API Key Required: Users must provide their own map service API key.
3. Route Planning (Requires API Key)
For directions queries:
- Get coordinates for origin and destination
- Use routing API for walking/driving/cycling routes
API Key Required: Standard Web Service API key needed.
4. Heatmap Visualization
For data visualization requests:
- Accept data URL (JSON format)
- Generate visualization link
Data Format:
[{"lng": 116.397428, "lat": 39.90923}]
5. Travel Planning (Requires API Key)
For trip planning queries:
- Extract city and interest types
- Search POI data
- Generate travel map
API Key Required
API Key Configuration
When API key is needed:
- Get API key from your map service provider
- Add to OpenClaw config:
AMAP_WEBSERVICE_KEY=your_key - Location:
~/.openclaw/.envor~/.openclaw/credentials/.env
Quick Reference
| Feature | API Key Needed |
|---|---|
| General Search | No |
| Nearby Search | Yes |
| Route Planning | Yes |
| Heatmap | No |
| Travel Planning | Yes |
Security Notes
- API keys are user-provided credentials
- Keys are stored in user's local environment
- No external data transmission except to map service provider APIs
- Use HTTPS for all production connections
Disclaimer
This skill is for educational/demonstration purposes. Users should ensure compliance with map service provider terms of service.
Usage Guidance
This skill appears to do what it says: map searches and routing, with an optional map API key for advanced features. Before installing, consider: 1) Where will heatmap visualizations be hosted? The SKILL.md doesn't specify whether data you provide is uploaded to a third-party service — avoid sending sensitive location data until you confirm the endpoint. 2) If you add AMAP_WEBSERVICE_KEY to ~/.openclaw/.env, ensure that file is stored securely (correct filesystem permissions) and that the key has minimal permissions. 3) Watch network activity (which map provider domains are called) during use to confirm the agent only talks to expected map APIs. 4) If you need higher assurance, ask the publisher for details on how heatmap links are generated/hosted and for an explicit list of network endpoints the skill will contact.
Capability Analysis
Type: OpenClaw Skill
Name: amap-integration
Version: 1.0.2
The skill bundle contains only metadata and documentation for a map integration service (Amap/Gaode Maps). It describes standard API usage for geocoding, routing, and visualization without providing any executable code or suspicious instructions that would lead to data exfiltration or unauthorized access. All described behaviors in SKILL.md are consistent with the stated purpose of providing location-based services.
Capability Assessment
Purpose & Capability
Name and description match the instructions: search, geocoding, POI, routing, and visualization are all described and the SKILL.md only asks (optionally) for a map service API key for features that need it. No unrelated credentials, binaries, or install steps are requested.
Instruction Scope
Instructions are mostly scoped to building search URLs, calling map provider web services, and accepting a JSON data URL for heatmaps. The doc references local config paths (~/.openclaw/.env and ~/.openclaw/credentials/.env) for storing an optional API key; it does not explicitly instruct broad collection of other files, but the heatmap workflow is vague about where visualization links are generated or hosted (could imply uploading data).
Install Mechanism
Instruction-only skill with no install spec and no code files — lowest-risk install model. Nothing is downloaded or written by an installer step described in the skill metadata.
Credentials
No required environment variables; an optional AMAP_WEBSERVICE_KEY is declared and is proportional to route/POI/routing features. The skill does suggest storing it in user-local .env files. It does not request unrelated secrets or multiple external credentials.
Persistence & Privilege
always is false and model invocation is normal (agent may call the skill autonomously). The skill does not request persistent system-wide changes or modify other skills' config; its claimed persistence is limited to storing an optional API key in the user's local OpenClaw env files.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install amap-integration - After installation, invoke the skill by name or use
/amap-integration - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Added explicit metadata for API credentials and config file locations to SKILL.md.
- Credential requirements are now clearly documented with descriptions and optionality.
- Configuration file paths are specified in a new metadata block for easier setup.
- No changes to feature functionality.
v1.0.1
**Summary:** Major documentation rewrite and skill name update for improved clarity and internationalization.
- Renamed skill from "amap" to "amap-integration".
- Rewrote documentation in English, focusing on concise feature descriptions.
- Clarified which features require an API key and how to configure it.
- Modernized structure: added sections for quick reference, security notes, and disclaimer.
- Streamlined scenario explanations and removed duplicate or detailed user guidance.
v1.0.0
amap-cn v1.0.0 初始版本
- 提供高德地图五大核心服务：基础搜索、周边搜索、路径规划、热力图生成、旅游规划。
- 按用户意图自动分流，无缝处理无需或需要 API Key 的场景。
- 支持生成地图直链、路径距离时长、热力图可视化和智能旅游行程安排。
- 提供 API Key 配置指导，明确不同场景权限需求和错误提示。
- 详细示例和参数说明，便于快速上手。
Metadata
Frequently Asked Questions
What is Map Integration Service?
Map and location services for search, routing, and visualization. Provides geocoding, POI search, route planning, and heatmap generation capabilities. It is an AI Agent Skill for Claude Code / OpenClaw, with 234 downloads so far.
How do I install Map Integration Service?
Run "/install amap-integration" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Map Integration Service free?
Yes, Map Integration Service is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Map Integration Service support?
Map Integration Service is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Map Integration Service?
It is built and maintained by Ayal (@ayalnova); the current version is v1.0.2.
More Skills