把地名自动补全为 Idealista 地区 ID
查看 Idealista 房源数据接口:西班牙、葡萄牙与意大利房产搜索 的全部接口 →根据地名的开头几个字,在西班牙、葡萄牙或意大利解析出匹配的 Idealista 地区。请求时传入 location(es、pt 或 it)、operation(sale 或 rent)、prefix(目前已输入的文字,例如 madrid)以及 propertyType(homes、newDevelopments、bedrooms、offices、premises、garages、lands、storageRooms 或 buildings),四个参数全部必填。响应是一个 JSON 对象,包含 locations 数组和整数 total。在 location=es、operation=sale、prefix=madrid、propertyType=homes 的实际检查中,每个 locations 条目都带有 name、locationId、divisible、type、suggestedLocationId、subTypeText 以及自己的 total,匹配结果混合了市镇、马德里省和各个区。每个条目的 total 统计所选交易类型和房源类型下在售或在租的房源数量,而 locationId 正是各房源接口的 locationId 参数所需要的标识。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/idealista/get-suggestions API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-suggestions?key=<API_KEY>&location=es&operation=sale&prefix=madrid&propertyType=homes'
查询结果
使用场景
- 为租房应用打造输入即搜索的地点选择器,让联想结果与当前搜索的交易类型和房源类型保持一致。
- 在保存搜索或设置提醒之前,把用户输入的城市名转换成稳定的 locationId。
- 用一份纯文本的目标城市名单,为每晚运行的采集任务生成地区对照表。
- 校验线索表单中的地区字段,在没有任何联想结果时显示无匹配状态。
- 让海外买家从简短的联想列表中选出正确的市镇,不必猜测当地的确切拼写。
常见问题
Idealista 地区联想接口会返回什么?
返回一个 JSON 对象,包含 locations 数组和整数 total。在实际检查中,每个 locations 条目包含 name、locationId、divisible、type、suggestedLocationId、subTypeText 以及自己的 total。
哪些参数是必填的?
四个全部必填:location(es、pt 或 it)、operation(sale 或 rent)、prefix(地名文字)和 propertyType(homes、newDevelopments、bedrooms、offices、premises、garages、lands、storageRooms 或 buildings)。
operation 和 propertyType 会改变响应中的什么内容?
它们会改变每条联想结果的 total 字段,该字段统计该交易类型和该房源类型下的房源数量。
可以把 bedrooms 和 sale 一起请求吗?
不可以。接口文档说明 bedrooms 房源类型只能与 rent 操作搭配,所以请将 bedrooms 与 operation=rent 组合使用。
返回的 locationId 怎么用在其他接口里?
把所选匹配项的 locationId 复制到房源接口的 locationId 参数中。例如,针对 madrid 的检查为马德里市镇返回了 0-EU-ES-28-07-001-079,这与整栋建筑房源接口的示例值相同。
能联想出哪些类型的地点?
实际检查返回了名称中包含输入文字的市镇(Municipio)、一个省(Provincia)以及若干区(Distrito),每条都带有 divisible 标志。可能还存在其他地点级别,但没有被观察到。
输入的前缀没有任何匹配时应该怎么处理?
把空的 locations 数组视为没有匹配,让用户重新输入。响应顶层还带有一个整数 total。