查询美国房源到指定地址的通勤时间
查看 美国房产与房贷数据 API 的全部接口 →请求查询美国房源到目的地地址的出行时间。必填查询参数为 property_id 和 destination_address,均以字符串传入;property_id 应取自房源搜索结果。目的地尽量填写完整地址,并补充城市、州等信息;地点自动补全功能可用于获取更完整的地址。 可选参数 transportation_type 支持文档列出的 bicycling(骑行)、driving(驾车)、transit(公共交通)和 walking(步行)。walking 只是示例值,并非已确认的默认值。可选布尔参数 with_traffic 用于表达是否请求高峰时段耗时计算;false 同样只是文档示例,省略时的默认行为尚未验证。这些输入选项不代表接口已确认具备实时路况覆盖,也不保证每条行程都支持全部出行方式。 目前没有该接口的实测响应。现有响应示例已被截断,且开头是房源列表数据,无法识别出通勤结果,因此尚不能确认通勤响应的字段名称、耗时单位、路线几何数据或交通预测字段。解析耗时或展示房源间的数值对比前,请先核实实际响应结构,不要仅凭接口名称假定耗时字段或单位。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/properties-v3-get-commute-time API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-get-commute-time?key=<API_KEY>&destination_address=<destination_address>&property_id=<property_id>'
查询结果
使用场景
- 使用已收藏的房源和用户填写的工作地址,搭建由用户主动发起的居家到公司通勤查询表单。
- 让计划搬家的用户先选择文档支持的出行方式,再请求通勤估算,并明确提示路线是否可用仍需确认。
- 在通勤请求记录中保留高峰时段选项,便于后续结果展示时说明计算所依据的输入条件。
- 在集成测试中确认耗时字段及单位后,再启用多套候选房源的通勤时间数值对比。
常见问题
查询房源通勤时间需要哪些必填参数?
destination_address 和 property_id 均为必填项。请从房源列表结果获取 property_id,并提供完整的目的地地址。文档虽提供了仅含街道的示例,但补充城市、州等信息有助于明确目的地。
transportation_type 可以填写哪些出行方式?
文档列出的值为 bicycling(骑行)、driving(驾车)、transit(公共交通)和 walking(步行)。该参数可选,walking 只是示例值,并非已确认的默认值;各方式能否成功规划路线也尚未验证。
with_traffic 表示什么?
这是可选布尔参数,文档将其描述为控制是否计算高峰时段耗时。false 是输入示例。现有资料尚未确认省略该参数时的默认行为、实时路况是否可用,或是否采用按出发时间预测交通状况的模型。
哪个响应字段是通勤耗时,单位是什么?
现有资料无法确认耗时字段名称及其单位。目前没有实测响应,保留的示例是已截断的房源列表数据,而非经过验证的通勤响应。显示时间前,请检查并验证实际返回内容。
能否将此接口作为已验证的路线地图或交通预测服务展示?
不能。文档只说明了通勤时间请求及出行方式、高峰时段选项;目前没有实测响应能够确认路线几何数据、预测字段、交通方式覆盖范围或通勤估算准确性。