← Back to Skills Marketplace
jisuapi

GEO & Address Conversion - 经纬度地址转换

by 极速数据 · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ✓ Security Clean
460
Downloads
9
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install geoconvert
Description
在百度/Google 坐标系下做经纬度与地址互转。当用户说：把这个地址转成经纬度、这两个坐标是什么地方？或类似地图坐标问题时，使用本技能。
README (SKILL.md)

\r \r

极速数据经纬度地址转换（Jisu GeoConvert）\r

\r

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r 支持：\r \r

  • 经纬度转地址（/geoconvert/coord2addr）\r
  • 地址转经纬度（/geoconvert/addr2coord）\r \r 可选择使用 baidu 或 google 类型的地理编码服务。\r \r

前置配置：获取 API Key\r

\r

  1. 前往 极速数据官网 注册账号\r
  2. 进入 经纬度地址转换 API 页面，点击「申请数据」\r
  3. 在会员中心获取 AppKey\r
  4. 配置 Key：\r \r \r
# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/geoconvert/geoconvert.py`\r
\r
## 使用方式\r
\r
### 1. 经纬度转地址（/geoconvert/coord2addr）\r
\r
```bash\r
python3 skills/geoconvert/geoconvert.py coord2addr '{"lat":"30.2812129803","lng":"120.11523398","type":"baidu"}'\r
```\r
\r
请求 JSON：\r
\r
```json\r
{\r
  "lat": "30.2812129803",\r
  "lng": "120.11523398",\r
  "type": "baidu"\r
}\r
```\r
\r
### 2. 地址转经纬度（/geoconvert/addr2coord）\r
\r
```bash\r
python3 skills/geoconvert/geoconvert.py addr2coord '{"address":"益乐路39号","type":"baidu"}'\r
```\r
\r
请求 JSON：\r
\r
```json\r
{\r
  "address": "益乐路39号",\r
  "type": "baidu"\r
}\r
```\r
\r
`type` 说明：  \r
- `baidu`：使用百度地图坐标  \r
- `google`：使用 Google Maps 坐标  \r
\r
## 请求参数\r
\r
### 经纬度转地址\r
\r
| 字段名 | 类型   | 必填 | 说明                        |\r
|--------|--------|------|-----------------------------|\r
| lat    | string | 是   | 纬度                        |\r
| lng    | string | 是   | 经度                        |\r
| type   | string | 否   | 类型，`baidu` 或 `google`，默认 baidu |\r
\r
### 地址转经纬度\r
\r
| 字段名  | 类型   | 必填 | 说明                        |\r
|---------|--------|------|-----------------------------|\r
| address | string | 是   | 地址                        |\r
| type    | string | 否   | 类型，`baidu` 或 `google`，默认 baidu |\r
\r
## 返回结果示例（节选）\r
\r
### 经纬度转地址\r
\r
```json\r
{\r
  "lat": "30.2812129803",\r
  "lng": "120.11523398",\r
  "type": "google",\r
  "address": "中国浙江省杭州市西湖区文二西路11号 邮政编码: 310000",\r
  "country": "中国",\r
  "province": "浙江省",\r
  "city": "杭州市",\r
  "district": "西湖区",\r
  "description": ""\r
}\r
```\r
\r
### 地址转经纬度\r
\r
```json\r
{\r
  "address": "益乐路39号",\r
  "type": "google",\r
  "lat": "30.279864",\r
  "lng": "120.113885",\r
  "fulladdress": "中国浙江省杭州市西湖区益乐路39号 邮政编码: 310000",\r
  "precise": "",\r
  "confidence": "",\r
  "level": "street_address"\r
}\r
```\r
\r
## 常见错误码\r
\r
来源于 [极速数据经纬度文档](https://www.jisuapi.com/api/geoconvert/)：\r
\r
| 代号 | 说明         |\r
|------|--------------|\r
| 201  | 经纬度为空   |\r
| 202  | 地址为空     |\r
| 203  | 经纬度不正确 |\r
| 210  | 没有信息     |\r
\r
系统错误码：\r
\r
| 代号 | 说明                 |\r
|------|----------------------|\r
| 101  | APPKEY 为空或不存在  |\r
| 102  | APPKEY 已过期        |\r
| 103  | APPKEY 无请求权限    |\r
| 104  | 请求超过次数限制     |\r
| 105  | IP 被禁止            |\r
\r
## 推荐用法\r
\r
1. 用户给出坐标：「这个点 `30.2812129803,120.11523398` 是哪里？」  \r
2. 代理构造 JSON：`{"lat":"30.2812129803","lng":"120.11523398","type":"baidu"}` 并调用：  \r
   `python3 skills/geoconvert/geoconvert.py coord2addr '{"lat":"30.2812129803","lng":"120.11523398","type":"baidu"}'`  \r
3. 从返回结果中读取 `address/country/province/city/district` 字段，为用户总结清晰的地址描述；  \r
4. 反向场景下，可根据用户提供的地址调用 `addr2coord` 获取经纬度，用于后续地图或定位相关技能。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换  \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r
Usage Guidance
This skill appears to do exactly what it says: it converts between addresses and coordinates by calling JisuAPI. Before installing: (1) ensure your environment has Python and the 'requests' package available, (2) be aware your JISU_API_KEY will be sent to api.jisuapi.com (as a GET query param) — use a limited/rotatable key and monitor usage, (3) review JisuAPI's terms/privacy if you will submit sensitive locations, and (4) if you need stricter secrecy, verify whether the API supports sending keys in headers or POST to avoid logging in URL/query strings.
Capability Analysis
Type: OpenClaw Skill Name: geoconvert Version: 1.0.4 The geoconvert skill is a legitimate tool for converting between coordinates and addresses using the JisuAPI service. The Python script (geoconvert.py) correctly implements the API calls using the requests library, handles environment variables for authentication, and contains no evidence of malicious behavior, data exfiltration, or prompt injection.
Capability Assessment
✓ Purpose & Capability
Name/description (经纬度<->地址) align with the code and declared env. The only credential requested is JISU_API_KEY, which is exactly what the JisuAPI-based implementation needs. No unrelated services or permissions are requested.
✓ Instruction Scope
SKILL.md and the Python script instruct the agent to call the JisuAPI endpoints with JSON input and return the API result. The instructions do not read arbitrary files or access extra environment variables. The script performs only HTTP GETs to api.jisuapi.com and local JSON parsing.
ℹ Install Mechanism
There is no install spec (instruction-only), and the included script is small and self-contained. One practical omission: the script uses the Python 'requests' library but the skill's requirements only list 'python3' (no pip dependency declared). This is an operational note rather than a security red flag.
ℹ Credentials
Only JISU_API_KEY is required, which is proportional. Important security/privacy note: the script sends the appkey as a query parameter in GET requests (params), so the key may appear in logs and URL records on the client, proxies, or the JisuAPI side — consider using a limited key and monitor usage.
✓ Persistence & Privilege
always:false and no actions to persist or modify other skills or system-wide configs. The skill does not request elevated privileges or permanent presence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install geoconvert
  3. After installation, invoke the skill by name or use /geoconvert
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
- Improved documentation with a friendlier name and detailed API provider introduction. - Expanded instructions for applying and configuring the required API Key (JISU_API_KEY). - Added an "About JisuAPI" section, listing available services and APIs. - The skill workflow, API usage, request/response formats, and error codes remain unchanged. - No code or functional changes in this release.
v1.0.3
Version 1.0.3 - No file or documentation changes detected in this release. - Functionality, usage, and documentation remain unchanged.
v1.0.2
No changes detected in this version. - No file modifications or updates. - Functionality and documentation remain the same as the previous release.
v1.0.1
- Fixed a reference to the official documentation, changing “官方经纬度文档” to “极速数据经纬度文档” for accuracy and consistency. - No functional or code changes in this version.
v1.0.0
- Initial release of jisu-geoconvert skill. - Provides conversion between latitude/longitude and addresses using Jisu API, supporting both Baidu and Google coordinate systems. - Offers two main commands: coord2addr (convert coordinates to address) and addr2coord (convert address to coordinates). - Requires JISU_API_KEY environment variable for authentication. - Includes detailed error code documentation and sample command usage.
Metadata
Slug geoconvert
Version 1.0.4
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 5
Frequently Asked Questions

What is GEO & Address Conversion - 经纬度地址转换?

在百度/Google 坐标系下做经纬度与地址互转。当用户说：把这个地址转成经纬度、这两个坐标是什么地方？或类似地图坐标问题时，使用本技能。 It is an AI Agent Skill for Claude Code / OpenClaw, with 460 downloads so far.

How do I install GEO & Address Conversion - 经纬度地址转换?

Run "/install geoconvert" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GEO & Address Conversion - 经纬度地址转换 free?

Yes, GEO & Address Conversion - 经纬度地址转换 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does GEO & Address Conversion - 经纬度地址转换 support?

GEO & Address Conversion - 经纬度地址转换 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GEO & Address Conversion - 经纬度地址转换?

It is built and maintained by 极速数据 (@jisuapi); the current version is v1.0.4.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments