公开 API。
只读访问我们收录的法国公共数据:大区、省、市镇和地籍地块,以及网站上展示的统计数据和扩展信息。REST、JSON,请求头中带一个密钥即可。非商业用途免费。另有面向 AI 助手的 MCP 服务器。
创建账户.
密钥可在线自助获取,两分钟即可完成,无需联系我们:
账户默认包含免费套餐;付费套餐可在账户中订阅,无最低期限,随时可取消。
| 套餐 | 价格 | 每日 | 每分钟 | 用途 |
|---|---|---|---|---|
| 免费版 | 免费 | 100 次请求 | 10 次请求 | 仅限非商业用途 |
| 标准版 | 每月 19 欧元(不含税) | 2,000 次请求 | 60 次请求 | 允许商业用途 |
| 专业版 | 每月 79 欧元(不含税) | 25,000 次请求 | 300 次请求 | 允许商业用途 |
限额按账户计算,所有密钥共享。密钥用于标识一个集成,而非访客:请勿将其嵌入公开的前端代码。每个响应都会返回 X-Plan、X-Quota-Used 和 X-Quota-Remaining。如有特殊需求(公共机构、科研、更大用量),请发送邮件至 contact@lagrandecarte.fr。
curl -H "X-API-Key: YOUR_KEY" \ "https://lagrandecarte.fr/api/v1/communes/18033?include=stats"
MCP 服务器.
同样的数据,可直接在 Claude、ChatGPT、Cursor 或任何兼容 MCP 的客户端中使用:助手会对地址进行地理编码、找到对应地块,并读取其风险、城市规划或交易记录,您无需直接调用 API。每个工具都调用相应的 REST 端点:同一账户、同样的限额,每次工具调用计为一次请求。
https://lagrandecarte.fr/mcp
分步连接指南:lagrandecarte.fr/zh/mcp。
通过界面连接
在您的助手中添加一个使用此地址的自定义连接器。它会将您引导至 La Grande Carte:登录(或创建账户)并授权访问后,系统会在您的账户中自动创建一个“MCP · …”密钥。撤销该密钥即可断开助手的连接。
使用密钥
对于支持自定义请求头的客户端,请在您的账户中生成密钥。Claude Code:
claude mcp add --transport http lagrandecarte https://lagrandecarte.fr/mcp \ --header "X-API-Key: YOUR_KEY"
JSON 配置(Cursor、Claude Desktop、VS Code 等):
{
"mcpServers": {
"lagrandecarte": {
"type": "http",
"url": "https://lagrandecarte.fr/mcp",
"headers": {
"X-API-Key": "YOUR_KEY"
}
}
}
} 示例问题
- “关于 Bosdarros 这个市镇,你知道些什么?那里的自来水水质怎么样?”
- “我要去看 Bourges 市 4 rue Porte Jaune 的一栋房子:有哪些自然风险?PLU 城市规划分区是什么?附近最近有哪些成交?”
- “比较 Pau 和 Tarbes 的收入中位数、租金和治安状况。”
- “Pyrénées-Atlantiques 省的贫困率和预期寿命与 Nouvelle-Aquitaine 大区相比如何?”
助手只会发送工具参数(一个市镇、一个地址),绝不会发送您的对话内容:详见隐私政策。如有问题,请联系:contact@lagrandecarte.fr。
| 工具 | 说明 |
|---|---|
| get_commune | 市镇的全部信息:人口、收入、租金、自来水与空气质量、治安、气候、民选官员、财政……(含统计数据) |
| search_address | 查找市镇、地址或地名;返回 INSEE 代码和坐标 |
| get_parcel_enrichments | 地块完整报告:风险、城市规划、交易记录、能效评级、噪音、管网…… |
| get_parcel_at_point | 某个坐标点所在的地籍地块 |
| get_parcel | 按地籍编号(IDU)查询地块 |
| get_departement | 省及其统计数据,可选附带其下辖市镇 |
| get_region | 大区及其统计数据,可选附带其下辖各省 |
| find_commune | 包含某个坐标点的市镇 |
| list_communes | 某个省的全部市镇 |
| list_departements | 省列表,可按大区筛选 |
| list_regions | 大区列表 |
端点列表.
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1 | 服务索引 — 唯一无需密钥的调用 |
| GET | /api/v1/regions | 全部 18 个大区 |
| GET | /api/v1/regions/{code} | 单个大区 · include=geometry,stats,departements |
| GET | /api/v1/departements | 法国本土 96 个省 · ?region= |
| GET | /api/v1/departements/{code} | 单个省 · include=geometry,stats,communes |
| GET | /api/v1/communes | 某个省的全部市镇(?departement=),或包含某个坐标点的市镇(?lat=&lon=) |
| GET | /api/v1/communes/{codeInsee} | 单个市镇 · include=geometry,stats |
| GET | /api/v1/adresses?q= | 地址或地点的地理编码(Base Adresse Nationale 国家地址库) |
| GET | /api/v1/parcelles?lat=&lon= | 某个坐标点所在的地籍地块 |
| GET | /api/v1/parcelles/{idu} | 单个地块 · include=geometry |
| GET | /api/v1/parcelles/{idu}/enrichments | 我们掌握的该地块全部信息 |
海外省尚未收录在行政边界表中:/departements/974 会返回 404,但其市镇和地块数据可以正常获取(/communes?departement=974)。
数据以 Licence Ouverte 2.0 许可发布:可自由再利用(包括商业用途),但须注明来源。注明“La Grande Carte”并附上链接即可。
在线试用.
交互式文档由 OpenAPI 规范生成,内容为英文。