首页
博客
通过坐标搜索的API
博客

通过坐标搜索的API

通过坐标搜索的API

您需要在精确的纬度/经度周围搜索房地产列表，在地图上绘制多边形，或将结果限制为特定的邮政编码——并且您需要在本周内在您的应用中实现它。通过本指南的结束，您将能够使用 Zyla API Hub 上的实时 Zillow 数据 API 通过坐标、多边形或地点名称查询房产，将结果集成到您的地图或搜索 UI 中，并了解如何通过 MCP 从 AI 代理调用相同的端点。

此 API 的功能及其适合地理位置搜索的原因

实时 Zillow 数据 API 返回适合基于位置发现的实时住宅物业数据。您可以：

插图：通过坐标搜索的API
  • 按地点名称（城市、县、社区或邮政编码）搜索。
  • 使用中心点和直径按地理坐标搜索。
  • 在任意多边形内搜索自定义绘制的边界。

每个响应都包含开发人员实际在地图或结果列表上呈现的字段：zpid、address、latitude、longitude、price、homeStatus、bedrooms、bathrooms、livingArea、媒体引用等。这些是应用程序用于支持绘制地图搜索、“我附近的房屋”体验和地理围栏警报的相同类型的字段。

您可以在 Zyla API Hub 上找到此 API，该平台提供超过 10,000 个公共 API，使用一个帐户、一个 API 密钥和订阅 + 配额模型（不是按调用付费）。这里的第一个 API 提供 7 天试用或 50 次请求。请查看 API 页面以获取当前访问选项和定价。

在 Zyla API Hub 上开始

打开 Zyla API Hub 上的实时 Zillow 数据 API 列表，点击订阅或开始 7 天试用，并复制您的 API 密钥。以下所有调用都使用以下标头：

  • Authorization: Bearer YOUR_API_KEY

该平台使用订阅 + 配额。没有免费计划；这里的第一个 API 包括 7 天试用或 50 次请求，以帮助您构建和测试。

您将用于地理位置的端点

以下是三个专注于地理位置的端点。每个都是对 Zyla Hub URL 的 GET 请求，每个返回一个 JSON 负载，其中包含 parameters 回显和一个 data 列表数组。

1) 按坐标搜索

当您有一个中心点并希望在指定直径内查找列表时使用此功能。

  • 方法：GET
  • URL： https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
  • 描述：按中心纬度、经度点和直径搜索特定地理位置的物业。
  • 必需参数：
    • long（字符串）：-118.504744
    • lat（字符串）：34.01822
  • 可选参数：
    • diameter（字符串）：2

官方 cURL（复制/粘贴）：

curl -s -X GET "https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search?location=Los+Angeles%2C+CA&page=2&home_status=FOR_SALE" \
-H "Authorization: Bearer YOUR_API_KEY"

示例响应：

{
"status": "OK",
"request_id": "81fc95df-86f3-44b7-a3dc-1d81abcd7a97",
"parameters": {
"page": 2,
"home_status": "FOR_SALE",
"sort": "DEFAULT",
"listing_type": "BY_AGENT",
"location": "Los Angeles, CA"
},
"data": [
{
"zpid": "136702358",
"homeStatus": "FOR_SALE",
"detailUrl": "https://www.zillow.com/homedetails/24425-Woolsey-Canyon-Rd-SPC-39-Canoga-Park-CA-91304/136702358_zpid/",
"address": "24425 Woolsey Canyon Rd Spc 39, Canoga Park, CA 91304",
"streetAddress": "24425 Woolsey Canyon Rd Spc 39",
"city": "Canoga Park",
"state": "CA",
"country": "USA",
"zipcode": "91304",
"latitude": 34.235462,
"longitude": -118.661224,
"homeType": "MANUFACTURED",
"price": 99500,
"currency": "USD",
"zestimate": 178100,
"rentZestimate": 3439,
"taxAssessedValue": 21901,
"bathrooms": 2,
"bedrooms": 4,
"livingArea": 1818,
"daysOnZillow": 5,
"isFeatured": false,
"isPreforeclosureAuction": false,
"timeOnZillow": 498172000,
"isNonOwnerOccupied": true,
"isPremierBuilder": false,
"isZillowOwned": false,
"unit": "Spc 39",
"isShowcaseListing": false,
"listingSubType": {
"is_FSBA": true
},
"palsId": "3007_SR26162189",
"id": "136702358",
"rawHomeStatusCd": "ForSale",
"marketingStatusSimplifiedCd": "For Sale by Agent",
"imgSrc": "https://photos.zillowstatic.com/fp/1d8602169bd359c27caa6d6e25cdf662-p_e.jpg",
"hasImage": true,
"statusType": "FOR_SALE",
"statusText": "待售房屋",
"countryCurrency": "$",
"unformattedPrice": 99500,
"addressStreet": "24425 Woolsey Canyon Rd Spc 39",
"addressCity": "Canoga Park",
"addressState": "CA",
"addressZipcode": "91304",
"isUndisclosedAddress": false,
"shouldShowRequestOnPrice": false,
"beds": 4,
"baths": 2,
"area": 1818,
"latLong": {
"latitude": 34.235462,
"longitude": -118.661224
},
"flexFieldText": "5 days on…

实施者注意事项：

  • 使用 latitude 和 longitude 作为地图标记。
  • 使用 homeStatus 和 price 作为过滤器和徽章。
  • parameters 对象回显分页和默认过滤器（如适用）。

2) 按多边形搜索

当用户在地图上绘制边界时使用此功能。您发送有序的坐标对来限制搜索区域。

  • 方法：GET
  • URL： https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
  • 描述：在特定地理多边形区域内搜索物业。对于那些需要更多控制搜索边界的用户，此功能可以在复杂或非标准地理区域中查找物业。支持 Zillow.com 上可用的所有过滤器和选项。
  • 必需参数：
    • polygon（字符串）：-118.50394248962402 34.02926010734425, -118.5084056854248 34.02926010734425, -118.51286888122559 34.028691046671696, -118.51527214050293 34.02570341552858, -118.51321220397949 34.02257340341831, -118.51750373840332 34.0215774662657, -118.51681709289551 34.017878168811684, -118.51286888122559 34.016455319170184, -118.51080894470215 34.013324966013194, -118.50789070129395 34.010621386310234, -118.50411415100098 34.008629219864694, -118.49982261657715 34.008486920473, -118.49570274353027 34.007063913440916, -118.4919261932373 34.00891381793271, -118.48849296569824 34.01119056813859, -118.4860897064209 34.014463289606894, -118.48471641540527 34.018020452464164, -118.48042488098145 34.01858958468914, -118.4780216217041 34.0215774662657, -118.47939491271973 34.0249920592766, -118.47681999206543 34.02797971546417, -118.47493171691895 34.03125178964367, -118.4721851348877 34.034381481654364, -118.47733497619629 34.035377268536706, -118.48231315612793 34.035377268536706, -118.48677635192871 34.035377268536706, -118.49141120910645 34.03495050416125, -118.49604606628418 34.034096968969656, -118.49621772766113 34.03054047990366, -118.50033760070801 34.02926010734425, -118.50239753723145 34.032532132148006, -118.50394248962402 34.02926010734425

官方 cURL（复制/粘贴）：

示例响应：

实施者注意事项：

  • 将多边形作为“经度 纬度”对的逗号分隔列表发送。
  • API 支持 Zillow.com 上可用的过滤器。使用多边形搜索进行绘制地图和社区覆盖。

3) 按位置搜索（城市、社区、邮政编码）

当您已经知道一个常见的位置字符串时，使用此功能进行标准基于地点的搜索。

  • 方法：GET
  • URL： https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
  • 描述：按位置（县、社区、城市或邮政编码）搜索物业。
  • 必需参数：
    • location（字符串）：Los Angeles, CA
  • 可选参数：
    • page（字符串）：2
    • home_status（字符串）：FOR_SALE

官方 cURL（复制/粘贴）：

官方 JSON（逐字）：

开发者收获：

  • parameters.page 显示当前页面。使用此功能实现“下一页”分页。
  • 像 imgSrc、detailUrl 和 statusText 这样的字段可以帮助您快速呈现卡片。

一个有效的代码示例（Python）用于坐标搜索

以下 Python 示例调用按坐标搜索，并为每个物业打印一行紧凑的结果。它仅使用上面示例中记录的参数和字段。

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates"
params = {
"long": "-118.504744",
"lat": "34.01822",
"diameter": "2"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(url, params=params, headers=headers, timeout=30)
resp.raise_for_status()
payload = resp.json()

print(f"状态: {payload.get('status')} 请求 ID: {payload.get('request_id')}")
p = payload.get("parameters", {})
print(f"中心: ({p.get('lat')}, {p.get('long')}) diameter={p.get('diameter')} page={p.get('page')}")

for item in payload.get("data", []):
zpid = item.get("zpid")
addr = item.get("address")
city = item.get("city")
state = item.get("state")
price = item.get("price")
beds = item.get("bedrooms")
baths = item.get("bathrooms")
lat = item.get("latitude")
lon = item.get("longitude")
status = item.get("homeStatus")
print(f"{zpid} | {status} | ${price} | {beds} bd / {baths} ba | {addr} | {city}, {state} | ({lat}, {lon})")

需要适应的内容：

  • 在用户平移/缩放时，将 lat 和 long 绑定到您的地图中心。
  • 使用 zpid 作为去重或详细路由的稳定标识符。
  • 如果您添加了分页获取，请回显 parameters.page；按中心和页面缓存以避免额外调用。

您将实际使用的 JSON 字段指南

从上面的官方示例中，大多数应用程序会立即连接这些字段：

  • data[].latitude、data[].longitude：在您的地图投影上放置标记。
  • data[].address、data[].city、data[].state、data[].zipcode：搜索结果摘要和详细标题。
  • data[].price 和 data[].currency：定价显示。
  • data[].homeStatus（例如，FOR_SALE）：过滤和徽章。
  • data[].bedrooms、data[].bathrooms、data[].livingArea：过滤器和列表项事实。
  • data[].imgSrc 和 data[].detailUrl：英雄图像和外部详细深度链接（在位置搜索示例中存在）。
  • parameters.page：在添加分页用户体验时使用。

节省时间的实施注意事项：

  • 缓存：按完整请求 URL（包括查询字符串）缓存，以减少用户稍微平移但仍在同一区域时的重复调用。
  • 分页：响应包括 parameters.page 回显。将其保留在您的状态中以实现“加载更多”。
  • 地理搜索用户体验：对于坐标和多边形搜索，仅在空闲或拖动结束事件后重新计算查询，以避免过多请求。

您可以在本周交付的实际地理位置用例

  • “我附近的房屋”移动功能：获取设备位置，查询按坐标搜索，并为可见列表放置标记。
  • 绘制地图搜索：让用户绘制自定义边界并将结果坐标对发布到按多边形搜索。
  • 社区聚光灯：预定义社区的多边形，并在用户翻阅选项卡时在每个社区内查询。
  • 邮政编码浏览 + 精细化：首先使用按位置搜索查找城市或邮政编码，然后在用户平移/缩放时切换到按坐标搜索。

通过 MCP 从 AI 代理调用此 API

如果您使用与 MCP 兼容的客户端（Claude Code、Cursor、Windsurf 或任何 MCP 客户端），您的代理可以通过 Zyla 的 MCP 网关调用相同的 HTTPS 端点，网址为 https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY。这使得代理能够使用您现有的密钥调用实时 Zillow 数据 API，并将结果流回 IDE 或运行时。有关适配器详细信息，请参见 MCP。

集成清单

  • 从 API 列表中获取您的密钥并安全存储（例如，服务器端或 CI/CD 中的受管机密）。
  • 选择您的搜索模式：
    • 坐标用于中心 + 直径接近。
    • 多边形用于用户绘制的边界。
    • 位置用于城市/邮政编码/社区引导。
  • 呈现基本字段：
    • 来自 latitude/longitude 的地图标记。
    • 来自 address、price、bedrooms、bathrooms、livingArea 和图像 URL（如果存在）的卡片。
  • 使用 page 参数及其在 parameters.page 中的回显实现分页，如果您列出许多结果。
  • 按完整 URL 缓存查询；当地图中心或多边形更改时使其失效。

故障排除提示

  • 授权失败：确保标头完全为 Authorization: Bearer YOUR_API_KEY。
  • 空结果：验证您的 location、lat/long 或 polygon 值以及任何可选过滤器，如 home_status。
  • 多边形格式：以逗号分隔的“经度 纬度”对的列表发送；在构建查询字符串时确保 URL 编码空格/逗号。
  • 延迟：在拖动结束之前推迟请求或对输入进行去抖动，以避免在地图平移期间洪水调用。

常见问题

我如何对结果进行分页？
在接受的端点上使用 page 查询参数（例如，按位置搜索），并从响应中读取 parameters.page 以跟踪当前页面。

我应该将哪些字段存储为标识符？
zpid 是稳定的物业标识符。将其用于去重、书签和路由到详细屏幕。

我可以过滤特定的上市状态吗？
在支持的地方，传递 home_status（例如，FOR_SALE），完全按照端点参数中所示的方式，并在响应的 parameters 回显中验证。

价格和面积使用什么单位？
有效负载包括 price 和 currency（例如，USD），并可能包括 livingArea 或地块字段（如果存在）。按返回的值呈现；不要假设转换。

我可以从 AI 代理调用此功能吗？
可以。使用任何与 MCP 兼容的客户端从 https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY 访问 MCP 网关。有关详细信息，请参见 MCP 页面。

发布它

获取您的 API 密钥并开始通过坐标、多边形或地点名称查询物业。在这里创建您的帐户并开始实时 Zillow 数据 API 的 7 天试用： 开始实时 Zillow 数据 API 的 7 天试用。在 Zyla API Hub 上有超过 10,000 个公共 API，您可以扩展您的地理位置功能，而无需添加更多身份验证流程或计费系统。

准备使用 Zyla API HUB？

立即尝试！

相关文章

使用 YouTube 数据 API

使用 YouTube 数据 API

您需要提取 YouTube 视频元数据，获取最新评论，并推荐相关视频，而不必花费一周时间处理身份验证或分散的文档。在本指南结束时...

 警报和拥堵的 API

警报和拥堵的 API

您的团队需要 Waze 级别的事件警报和特定区域的实时交通拥堵，您需要一个可以在本周交付的端点。通过本文，您将查询一个返回 Waz...

 如何使用 YouTube 视频到音频 API

如何使用 YouTube 视频到音频 API

您有一个 YouTube URL，您需要一个 MP3 链接，并且您需要在本周内投入生产。到本文结束时，您将确切知道如何调用一个单一的端点...

 使用 YouTube 下载和信息 API

使用 YouTube 下载和信息 API

您需要让用户下载 YouTube 视频或以特定格式提取音频，并且您需要在本周内完成。通过本指南，您将获得一个可复制的请求，该请求...

 通过邮政编码获取犯罪率的API

通过邮政编码获取犯罪率的API

您本周需要按邮政编码获取犯罪风险，而不是进行GIS的全面改革。在本指南结束时，您将查询一个端点，传递一个邮政编码，并获得整...

 每个频道的视频 API

每个频道的视频 API

您需要在本周回答一个具体的问题：一个频道有多少个视频，或者哪些频道主导一个主题？在本文结束时，您将能够通过 Zyla API Hub...

搜索

相关文章

最近文章