Vibe Coding 友好

让 AI 直接帮你
接入位置服务

越来越多开发者习惯借助 AI 编写代码,因此我们把全部接口整理成 AI 可读的接入指南文件, 把地址交给 AI,即可快速生成可运行的接入代码,无需逐页翻阅文档。

查看接口文档

三步完成 AI 接入

把指南地址交给 AI,剩下的交给它

01

把指南交给 AI

复制下方的指南文件地址,粘贴到你的 AI 编程工具中,AI 即可完整了解全部接口。

02

描述你的需求

告诉 AI 你想实现的功能,如地址解析、周边搜索、IP 定位等,越具体生成越准确。

03

运行测试上线

AI 生成代码后,填入你的 API Key 运行验证,再到控制台查看调用与配额情况。

提示词模板

一段提示词,说清需求

复制右侧模板,替换其中的需求描述后发给你的 AI 编程工具。 模板已内置指南文件地址,AI 会先读文档再写代码,生成结果更准确。

  • 内置全部接口信息,AI 无需猜参数
  • 统一错误码约定,自动处理失败分支
  • 默认安全规范,避免 API Key 泄露
prompt.md
请帮我基于「迈云位置服务(LTS)」开发一个功能。

## 前置资料
请先完整阅读 AI 接入指南(包含全部接口的鉴权、参数、响应格式与错误码):
https://lts.maiyun.net/stc/ai-guide.md

## 需求描述
(在这里描述你的功能,例如:实现一个"附近餐厅"查询,输入城市与坐标,
返回 2 公里内的餐厅列表并展示名称、距离与联系电话。)

## 开发要求
- 使用你擅长的语言 / 框架实现,输出完整可运行的代码
- API Key 通过环境变量注入,禁止硬编码
- 遵循接口文档中的参数与响应约定,处理 result 错误码
- 为关键代码添加中文注释
AI 接入指南文件

一份文件,读懂全部接口

指南文件涵盖服务简介、鉴权方式、12 个接口的完整参数与响应说明、 错误码对照表与安全建议,AI 读完后即可直接编写接入代码。

接口总览请求参数响应字段错误码表代码示例安全建议
ai-guide.md
https://lts.maiyun.net/stc/ai-guide.md
打开文件

主流 AI 编程工具均适用

支持读取 URL 或上传文件的 AI 工具,都可以使用本指南

Claude Code

支持直接读取 URL 文档

Cursor

支持 @ 引用链接与文件

GitHub Copilot

支持引用文档地址

ChatGPT / Claude

支持粘贴 URL 或上传文件

通义灵码

支持粘贴链接辅助编码

Kimi 探索版

支持读取网页内容

实战示例

看看 AI 是怎么工作的

以「用户输入城市,返回该城市行政区列表」为例, AI 会先读取指南,再选择正确的接口生成代码。

  • 读取指南
    AI 识别出应使用行政区搜索接口,而非直接猜接口
  • 生成代码
    按指南参数构造请求,处理 status 错误码与分页
  • 可运行交付
    输出含环境变量配置的完整代码,填入 Key 即可运行
先阅读接入指南 https://lts.maiyun.net/stc/ai-guide.md,然后帮我在小程序里实现: 用户输入城市名称,返回该城市的所有区县列表。
好的。根据指南,行政区划接口返回四级数据,需要先调用行政区搜索接口 scenario/search 定位城市,再调用下级行政区接口 scenario/children 获取区县列表。以下是完整代码(API Key 已通过环境变量 LTS_API_KEY 注入)……
以上为交互示意,实际结果以你的 AI 工具为准

安全提醒:API Key 不要交给 AI

接入指南包含的是接口文档,不含任何密钥。你的 API Key 属于敏感凭证, 请通过环境变量注入代码,不要让 AI 在代码中生成或复制真实密钥, 也不要将密钥提交到公开代码仓库。

密钥走环境变量前端不直连接口

注册即可获得免费测试额度

创建 API Key 后,把指南地址交给 AI,几分钟内跑通第一个位置功能