本地搜索 API

本地搜索API是一个提供特定位置附近的商业和兴趣点信息的工具
通过 MCP 从您的 AI 代理使用此 API
支持 OpenClaw、Claude Code/Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的 AI 客户端。
文档和设置
通过封装此 MCP 创建技能: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

关于API:  

开发者和企业可以利用这些数据创建基于位置的应用程序和服务,如旅游指南、寻找餐厅等地方。

本地搜索API通过访问企业和兴趣点的数据库来工作,如餐厅、博物馆、公园。API通常提供有关企业或兴趣点的信息,例如名称、地址等。它们还提供数据,如纬度、经度和其他有用的信息。

本地搜索API最常见的用途之一是用于旅行应用程序。通过访问企业和兴趣点的数据库,旅行指南和旅行预订网站可以为用户提供特定地点最佳餐厅和景点的信息。这可以帮助旅行者做出明智的决定,选择在哪里享受用餐和不同活动。

本地搜索API对于食品和饮料应用程序也很有用。通过提供附近餐厅、酒吧和咖啡馆的信息,这些应用程序可以帮助用户找到特定地点的最佳用餐和饮酒场所。

除了旅行和食品饮料应用程序外,本地搜索API还可以用于许多其他目的。例如,它们可以用于创建当地事件列表,提供有关附近公园和休闲区域的信息,以及帮助用户找到所需的服务。

总体而言,这对于希望将场所数据纳入其应用程序或系统的开发者来说是一个宝贵的资源。凭借其广泛的位置信息数据库和强大的搜索能力,这个API可以用于创建自定义搜索引擎、目录或活动列表,为用户提供做出明智决定所需的信息。

 

该API接收什么以及您的API提供什么(输入/输出)?

它将接收参数并为您提供JSON。

 

该API最常见的用例是什么?

  1. 旅游指南:可用于为用户提供特定地点的公园、餐厅和景点的信息。

  2. 食品和饮料应用程序:可以帮助用户找到特定地点的最佳用餐和饮酒场所。

  3. 公园和休闲区域:可以提供有关附近公园和休闲区域的信息。

  4. 位置:提供有关地点及其与服务的接近度的信息,使到达目的地更容易。

  5. 社交媒体:可用于在社交媒体平台上添加基于位置的功能,例如签到和基于位置的广告。

 

您的计划有什么 ограничения?

除了每月的API调用限制外,没有其他限制。

API 文档

端点


要使用此端点,您必须在参数中插入纬度、经度、类型(例如咖啡)和半径最大10,000米



                                                                            
GET https://www.zylalabs.com/api/2000/local+search+api/1767/get+places
                                                                            
                                                                        

获取地点 - 端点功能

对象 描述
location [必需]
type 可选
radius 可选
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"results":[{"id":"A3178B71DBCC0FA82D4F6285B2C1C03B","name":"La vida argentina","address":"California 93657, USA","location":{"lat":36.778265,"lng":-119.417914},"types":["cafe","food","store"],"distance":4},{"id":"230079E8F476345E575149EDC2DC1170","name":"CC Jittters","address":"Sanger, CA 93657, USA","location":{"lat":36.778265,"lng":-119.417914},"types":["cafe","food"],"distance":4}]}
                                                                                                                                                                                                                    
                                                                                                    

获取地点 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/2000/local+search+api/1767/get+places?location=36.7783,-119.4179&type=cafe&radius=180' --header 'Authorization: Bearer YOUR_API_KEY' 


    

 要使用这个端点,您必须在参数中插入一个地点的名称。



                                                                            
GET https://www.zylalabs.com/api/2000/local+search+api/1768/get+places+by+text
                                                                            
                                                                        

通过文本获取地点 - 端点功能

对象 描述
text [必需]
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"results":[{"id":"4CF8CF243454935EE20AE4CB2C266F01","name":"The Getty","address":"1200 Getty Center Dr, Los Angeles, CA 90049, United States","phone_number":"+13104407300","website":"https://www.getty.edu/visit/center/","location":{"lat":34.078044,"lng":-118.474074},"types":["museum","tourist_attraction"]}]}
                                                                                                                                                                                                                    
                                                                                                    

通过文本获取地点 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/2000/local+search+api/1768/get+places+by+text?text=The getty' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 本地搜索 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
标头
标头 描述
授权 [必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

简单透明的定价

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

🚀 企业版

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

客户喜爱的功能

  • ✔︎ 仅支付成功请求
  • ✔︎ 7 天免费试用
  • ✔︎ 多语言支持
  • ✔︎ 一个 API 密钥,所有 API。
  • ✔︎ 直观的仪表板
  • ✔︎ 全面的错误处理
  • ✔︎ 开发者友好的文档
  • ✔︎ Postman 集成
  • ✔︎ 安全的 HTTPS 连接
  • ✔︎ 可靠的正常运行时间

本地搜索 API FAQs

“获取地点”端点返回有关企业和兴趣点的信息,包括它们的名称、地址、位置(经度和纬度)、类型以及与指定坐标的距离。“通过文本获取地点”端点提供类似的详细信息,但基于特定的地点名称,包括额外的字段,如电话号码和网站

响应数据中的关键字段包括“id”(唯一标识符),“name”(商户名称),“address”(位置地址),“location”(纬度和经度),“types”(地点类别)和“distance”(与指定位置的距离)

“获取地点”端点需要纬度、经度、类型(例如,咖啡馆)和半径(最多10,000米) “通过文本获取地点”端点需要地点名称作为参数以搜索相关结果

响应数据以JSON格式组织,其中包含一个“results”数组,包含单个地点对象。每个对象包括“id”、“name”、“address”、“location”、“types”和“distance”等字段,使其易于在应用程序中解析和使用

数据来源于一个全面的商业和兴趣点数据库,该数据库定期更新以确保准确性。这包括用户生成的内容、商业列表和来自各种地方目录的验证信息

典型的使用案例包括提供当地景点的旅行应用程序、帮助用户找到附近餐厅的饮食和饮料应用程序,以及整合基于位置的签到和广告功能的社交媒体平台

用户可以通过调整纬度、经度、地点类型和半径等参数来自定义“获取地点”端点的请求,或者通过为“通过文本获取地点”端点指定不同的地点名称来细化搜索结果

用户可以通过以用户友好的格式显示返回的数据,例如地图或列表,并将其集成到导航、推荐或基于位置的服务应用中,从而增强用户体验和参与度

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。

价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]


此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。

定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。

有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]

价格由月度或年度订阅决定,具体取决于所选计划。

API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。

Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。

要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。

要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。

要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。

"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。

是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。

您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。

7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。

当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。

付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。

 服务级别
100%
 响应时间
454ms

类别:


相关 API


您可能还喜欢