Evitalya API · v1

意大利任意地址的宜居性评分

一次 HTTP 调用：为意大利任意地址返回由 111 项指标计算的评分——安全、服务、交通、环境、房地产与自然风险。全国覆盖，官方数据来源（ISTAT、ARPA、ISPRA、INGV、OMI、AGENAS），许可允许商业使用。

适用对象

房产中介与顾问

一次调用即可为组合中的每个地址评分，并把总评分与六个分类放进房源页面。当客户问“这个社区怎么样”，答案来自官方数据，而不是个人看法。

搬迁与移民顾问

在一家人抵达之前比较候选地址：学校、医疗、交通、安全与自然风险在同一标尺上。insufficient_data 字段区分“差”与“未测量”——给出建议时，这就是全部差别。

门户与软件

在房源页面加入地址级评分。响应返回代码（safety、enviro）而非标签：站点语言变化时你的集成不会中断。配额按月计算，一次夜间导入即可用完。

价格

无合同、无商务洽谈、无最短期限。免费方案立即开通，且不需要银行卡：从账户中取得密钥即可开始调用。付费方案在你的账户中用信用卡开通，并在同一处取消。价格按月计，增值税按我们适用的税制计算。

五分钟上手

注册账户，验证邮箱，然后在你的账户中取得密钥。免费方案不需要银行卡。

curl -X POST https://evitalya.com/v1/score \
  -H "x-api-key: ev_pro_..." \
  -H "content-type: application/json" \
  -d '{"address": "Via Vigevano 12, Milano"}'

{
  "schema": "evitalya.score.v1",
  "plan": "pro",
  "address": { "resolved": "Via Vigevano 12, Milano", "istat": "015146",
               "comune": "Milano", "provincia": "MI" },
  "score": 72.4,
  "reliability": 0.91,
  "reliability_code": "high",
  "categories": {
    "safety":       { "score": 68.2, "reliability": 0.88 },
    "services":     { "score": 79.5, "reliability": 0.93 },
    "mobility":     { "score": 84.1, "reliability": 0.90 },
    "enviro":       { "score": 61.7, "reliability": 0.95 },
    "realestate":   { "score": 70.3, "reliability": 0.87 },
    "natural_risk": { "score": 88.0, "reliability": 0.96 }
  },
  "measured_metrics": 104,
  "total_metrics": 111,
  "insufficient_data": []
}

insufficient_data 为何重要：低分可能表示该地确实较差，也可能表示没有数据来衡量该分类。这个字段把两者区分开——对估价师而言，这就是全部差别。

响应

代码	含义
`200`	评分已计算。
`401`	密钥缺失、无效或已吊销。
`404`	`address_not_found` — 无法对该地址进行地理编码。
`429`	`monthly_quota_exceeded` — 本月配额已用尽。
`502`	地理编码服务暂时不可用。

你应当知道的

配额按月计算，而非按天：一次夜间导入或组合重算即可一次用完。
分类键是代码（safety、enviro），不是标签。站点语言变化时你的集成不会中断。
密钥只显示一次。服务器只保存其摘要。
取消订阅后密钥仍可使用，按免费方案的额度。我们不会在没有通知的情况下中断你的集成。

你可以做什么：在方案有效期内，你可以把获取的评分发布在自己的产品中以及交付给客户的文件中；必须标注来源。详见条款第 21 条。

面向机器：OpenAPI 描述与 JSON 格式的方案列表。

免费开始