开发者

公开 API。

只读访问我们收录的法国公共数据:大区、省、市镇和地籍地块,以及网站上展示的统计数据和扩展信息。REST、JSON,请求头中带一个密钥即可。非商业用途免费。另有面向 AI 助手的 MCP 服务器。

11 个端点 MCP 服务器 39 个公共数据源 Licence Ouverte 2.0(Etalab 开放许可) openapi.json
获取密钥

创建账户.

密钥可在线自助获取,两分钟即可完成,无需联系我们:

  1. 使用邮箱和密码或 Google 账号注册。
  2. 打开邮件中的确认链接。
  3. 在您的账户中点击“创建密钥”:密钥仅显示一次,请立即复制。

账户默认包含免费套餐;付费套餐可在账户中订阅,无最低期限,随时可取消。

套餐价格每日每分钟用途
免费版免费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"
AI 助手

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 规范生成,内容为英文。