← 返回 Skills 市场

Map Integration Service

Name: Map Integration Service
Author: ayalnova

作者 Ayal · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ✓ 安全检测通过

234

总下载

当前安装

版本数

在 OpenClaw 中安装

/install amap-integration

功能描述

Map and location services for search, routing, and visualization. Provides geocoding, POI search, route planning, and heatmap generation capabilities.

使用说明 (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/.env or ~/.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.

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install amap-integration
安装完成后，直接呼叫该 Skill 的名称或使用 /amap-integration 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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 配置指导，明确不同场景权限需求和错误提示。 - 详细示例和参数说明，便于快速上手。

元数据

Slug amap-integration

版本 1.0.2

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 3

常见问题