位置半径查找器 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被设计为可以在不同环境中无缝集成。无论用户是在网页应用、移动应用还是其他基于位置的服务中工作，API都能促进集成，增强这些平台的整体能力。这种适应性确保API可以在广泛的行业和用例中得到应用。

“地点半径查找API”是希望将基于位置的功能纳入其应用程序的开发人员的宝贵资产。其准确性、定制选项、高效的响应时间和跨平台集成能力使其成为适用于各种行业的多功能工具。无论是帮助旅行者探索新目的地，还是协助企业进行当地市场探索，此API都提供了一个稳健的基于邻近的搜索解决方案，在地理探索领域提供一个动态且易于使用的体验。

此API接收什么以及您的API提供什么（输入/输出）？

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

此API最常见的用例是什么？

旅游应用：使用户能够探索附近的城市和城镇以进行旅行规划，提供有关指定半径内潜在目的地的洞察。

房地产平台：通过让用户发现与他们感兴趣区域在一定距离内的城市和城镇，增强物业搜索和位置评估。

本地商业发现：通过将附近城市和城镇信息纳入专注于本地商业发现的应用程序，方便用户探索新市场和机会。

社区建设平台：通过帮助用户通过社区建设应用程序找到邻近城镇或城市，促进具有相似地理兴趣者之间的联系。

物流和配送服务：通过识别在指定半径内的城市和城镇，优化物流和配送服务的路线规划，简化交付和运输流程。

你的计划是否有任何限制？

基础计划：3000个API调用每天100个请求。
专业计划：6000个API调用每天200个请求。
专业增强计划：12000个API调用每天400个请求。
高级计划：24000个API调用每天800个请求。

API 文档

端点

范围内的城镇

要使用此端点，您必须在参数中指明纬度、经度和半径

                                                                            
GET https://zylalabs.com/api/3134/location+radius+finder+api/3329/towns+within+range

范围内的城镇 - 端点功能

对象	描述
`lat`	[必需]
`lng`	[必需]
`radius`	[必需]

测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"status":1,"count":77,"output":[{"name":"Aberargie","countrycode":"gb","distance":12.3,"latitude":56.316667,"longitude":-3.35,"population":null},{"name":"Abernethy","countrycode":"gb","distance":10.82,"latitude":56.333333,"longitude":-3.333333,"population":"1010"},{"name":"Arngask","countrycode":"gb","distance":15.7,"latitude":56.283333,"longitude":-3.383333,"population":null},{"name":"Auchterhouse","countrycode":"gb","distance":19.19,"latitude":56.516667,"longitude":-3.066667,"population":null},{"name":"Auchtermuchty","countrycode":"gb","distance":8.39,"latitude":56.283333,"longitude":-3.216667,"population":"2023"},{"name":"Backmuir Of New Gilston","countrycode":"gb","distance":17.83,"latitude":56.266667,"longitude":-2.916667,"population":null},{"name":"Balbeggie","countrycode":"gb","distance":14.72,"latitude":56.433333,"longitude":-3.35,"population":null},{"name":"Balmerino","countrycode":"gb","distance":9.49,"latitude":56.4,"longitude":-3.033333,"population":null},{"name":"Balmullo","countrycode":"gb","distance":15.14,"latitude":56.366667,"longitude":-2.916667,"population":"1085"},{"name":"Bridge Of Earn","countrycode":"gb","distance":14.87,"latitude":56.333333,"longitude":-3.4,"population":"2231"},{"name":"Cameron Bridge","countrycode":"gb","distance":19.99,"latitude":56.183333,"longitude":-3.05,"population":null},{"name":"Ceres","countrycode":"gb","distance":14.23,"latitude":56.283333,"longitude":-2.966667,"population":"1023"},{"name":"Collace","countrycode":"gb","distance":14.78,"latitude":56.466667,"longitude":-3.283333,"population":null},{"name":"Collessie","countrycode":"gb","distance":5.84,"latitude":56.3,"longitude":-3.15,"population":null},{"name":"Craigrothie","countrycode":"gb","distance":12.54,"latitude":56.283333,"longitude":-3,"population":null},{"name":"Cupar","countrycode":"gb","distance":9.74,"latitude":56.316667,"longitude":-3.016667,"population":"8822"},{"name":"Dron","countrycode":"gb","distance":14.26,"latitude":56.316667,"longitude":-3.383333,"population":null},{"name":"Dronley","countrycode":"gb","distance":17.43,"latitude":56.5,"longitude":-3.066667,"population":null},{"name":"Dunbog","countrycode":"gb","distance":2.21,"latitude":56.333333,"longitude":-3.15,"population":null},{"name":"Dundee City","countrycode":"gb","distance":19.7,"latitude":56.466667,"longitude":-2.916667,"population":null},{"name":"Errol","countrycode":"gb","distance":4.21,"latitude":56.383333,"longitude":-3.2,"population":"1039"},{"name":"Falkland","countrycode":"gb","distance":11.61,"latitude":56.25,"longitude":-3.2,"population":"1168"},{"name":"Fife","countrycode":"gb","distance":11.37,"latitude":56.25,"longitude":-3.166667,"population":null},{"name":"Fife Conty","countrycode":"gb","distance":10.15,"latitude":56.333333,"longitude":-3,"population":null},{"name":"Fife Region","countrycode":"gb","distance":11.37,"latitude":56.25,"longitude":-3.166667,"population":null},{"name":"Fifeshire","countrycode":"gb","distance":10.15,"latitude":56.333333,"longitude":-3,"population":null},{"name":"Forgandenny","countrycode":"gb","distance":19.97,"latitude":56.333333,"longitude":-3.483333,"population":null},{"name":"Freuchie","countrycode":"gb","distance":13.23,"latitude":56.233333,"longitude":-3.15,"population":"1120"},{"name":"Gateside","countrycode":"gb","distance":13.51,"latitude":56.266667,"longitude":-3.316667,"population":null},{"name":"Gilston","countrycode":"gb","distance":17.83,"latitude":56.266667,"longitude":-2.916667,"population":null},{"name":"Glencarse","countrycode":"gb","distance":8.71,"latitude":56.366667,"longitude":-3.3,"population":null},{"name":"Glenfarg","countrycode":"gb","distance":17.54,"latitude":56.266667,"longitude":-3.4,"population":"449"},{"name":"Glenrothes","countrycode":"gb","distance":16.98,"latitude":56.2,"longitude":-3.183333,"population":"38734"},{"name":"Guildtown","countrycode":"gb","distance":19.44,"latitude":56.466667,"longitude":-3.4,"population":null},{"name":"Inchture","countrycode":"gb","distance":9.03,"latitude":56.433333,"longitude":-3.166667,"population":"715"},{"name":"Invergowrie","countrycode":"gb","distance":12.84,"latitude":56.45,"longitude":-3.05,"population":null},{"name":"Kennoway","countrycode":"gb","distance":18.26,"latitude":56.2,"longitude":-3.05,"population":"4596"},{"name":"Kilmany","countrycode":"gb","distance":10.05,"latitude":56.366667,"longitude":-3,"population":null},{"name":"Kilmaron","countrycode":"gb","distance":8.81,"latitude":56.316667,"longitude":-3.033333,"population":null},{"name":"Kilspindie","countrycode":"gb","distance":7.63,"latitude":56.4,"longitude":-3.25,"population":null},{"name":"Kinfauns","countrycode":"gb","distance":11.75,"latitude":56.366667,"longitude":-3.35,"population":null},{"name":"Kingskettle","countrycode":"gb","distance":11.69,"latitude":56.25,"longitude":-3.116667,"population":"993"},{"name":"Kinnaird","countrycode":"gb","distance":10.06,"latitude":56.433333,"longitude":-3.233333,"population":null},{"name":"Kinross County","countrycode":"gb","distance":19.43,"latitude":56.25,"longitude":-3.416667,"population":null},{"name":"Kinross-shire","countrycode":"gb","distance":19.43,"latitude":56.25,"longitude":-3.416667,"population":null},{"name":"Kirkton Of Auchterhouse","countrycode":"gb","distance":19.19,"latitude":56.516667,"longitude":-3.066667,"population":null},{"name":"Ladybank","countrycode":"gb","distance":9.66,"latitude":56.266667,"longitude":-3.133333,"population":"1519"},{"name":"Leslie","countrycode":"gb","distance":17.27,"latitude":56.2,"longitude":-3.216667,"population":null},{"name":"Leuchars","countrycode":"gb","distance":17.45,"latitude":56.383333,"longitude":-2.883333,"population":"2341"},{"name":"Leven","countrycode":"gb","distance":19.63,"latitude":56.2,"longitude":-3,"population":null},{"name":"Liff","countrycode":"gb","distance":15.35,"latitude":56.483333,"longitude":-3.083333,"population":null},{"name":"Lindores","countrycode":"gb","distance":2.51,"latitude":56.333333,"longitude":-3.183333,"population":null},{"name":"Logie","countrycode":"gb","distance":12.08,"latitude":56.366667,"longitude":-2.966667,"population":null},{"name":"Longforgan","countrycode":"gb","distance":11.21,"latitude":56.45,"longitude":-3.116667,"population":"678"},{"name":"Lundie","countrycode":"gb","distance":16.45,"latitude":56.5,"longitude":-3.15,"population":null},{"name":"Luthrie","countrycode":"gb","distance":4.8,"latitude":56.35,"longitude":-3.083333,"population":null},{"name":"Markinch","countrycode":"gb","distance":17.01,"latitude":56.2,"longitude":-3.133333,"population":null},{"name":"Milton Of Balgonie","countrycode":"gb","distance":19.15,"latitude":56.183333,"longitude":-3.1,"population":null},{"name":"Miltown","countrycode":"gb","distance":19.15,"latitude":56.183333,"longitude":-3.1,"population":null},{"name":"Monimail","countrycode":"gb","distance":6.05,"latitude":56.3,"longitude":-3.133333,"population":null},{"name":"Moonzie","countrycode":"gb","distance":6.19,"latitude":56.333333,"longitude":-3.066667,"population":null},{"name":"Muirhead","countrycode":"gb","distance":17.43,"latitude":56.5,"longitude":-3.066667,"population":null},{"name":"Muirhead Of Liff","countrycode":"gb","distance":17.43,"latitude":56.5,"longitude":-3.066667,"population":null},{"name":"New Scone","countrycode":"gb","distance":16.36,"latitude":56.416667,"longitude":-3.4,"population":"4355"},{"name":"Newburgh","countrycode":"gb","distance":5.87,"latitude":56.333333,"longitude":-3.25,"population":"1909"},{"name":"Newport","countrycode":"gb","distance":17.54,"latitude":56.433333,"longitude":-2.916667,"population":null},{"name":"Newport-On-Tay","countrycode":"gb","distance":17.54,"latitude":56.433333,"longitude":-2.916667,"population":null},{"name":"Perth","countrycode":"gb","distance":17.58,"latitude":56.4,"longitude":-3.433333,"population":"43634"},{"name":"Pitlessie","countrycode":"gb","distance":11.15,"latitude":56.266667,"longitude":-3.066667,"population":null},{"name":"Pitscottie","countrycode":"gb","distance":15.19,"latitude":56.3,"longitude":-2.933333,"population":null},{"name":"Rait","countrycode":"gb","distance":9.02,"latitude":56.416667,"longitude":-3.25,"population":null},{"name":"Saint Martins","countrycode":"gb","distance":17.47,"latitude":56.45,"longitude":-3.383333,"population":null},{"name":"Springfield","countrycode":"gb","distance":9.62,"latitude":56.283333,"longitude":-3.066667,"population":null},{"name":"Strathkinness","countrycode":"gb","distance":18.26,"latitude":56.333333,"longitude":-2.866667,"population":null},{"name":"Strathmiglo","countrycode":"gb","distance":11.53,"latitude":56.266667,"longitude":-3.266667,"population":"926"},{"name":"Woodside","countrycode":"gb","distance":19.77,"latitude":56.516667,"longitude":-3.283333,"population":null},{"name":"Wormit","countrycode":"gb","distance":13.08,"latitude":56.416667,"longitude":-2.983333,"population":null}]}

范围内的城镇 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/3134/location+radius+finder+api/3329/towns+within+range?lat=56.3522&lng=-3.1611&radius=20' --header 'Authorization: Bearer YOUR_API_KEY'

API 访问密钥和身份验证

注册后，每个开发者都会被分配一个个人 API 访问密钥，这是一个唯一的字母和数字组合，用于访问我们的 API 端点。要使用位置半径查找器 API 进行身份验证，只需在 Authorization 标头中包含您的 bearer token。

标头

标头	描述
`授权`	[必需] 应为 `Bearer access_key`. 订阅后，请查看上方的"您的 API 访问密钥"。

问题

简单透明的定价

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

月度年度

(年度计费可节省 2 个月 🎉)

💫Basic

$24.99/月

3,000 请求 / 月
然后 $0.0108290 如果超过限制，每次请求
速率限制: 60 reqs 每分钟
专业客户支持
实时 API 监控
包含无限数据传输

免费 7-天试用

无承诺。随时取消

Popular

⚡Pro

$49.99/月

6,000 请求 / 月
然后 $0.0108290 如果超过限制，每次请求
速率限制: 60 reqs 每分钟
专业客户支持
实时 API 监控
包含无限数据传输

免费 7-天试用

无承诺。随时取消

🔥Pro Plus

$99.99/月

12,000 请求 / 月
然后 $0.0108290 如果超过限制，每次请求
速率限制: 120 reqs 每分钟
专业客户支持
实时 API 监控
包含无限数据传输

免费 7-天试用

无承诺。随时取消

⚜️Premium

$199.99/月

24,000 请求 / 月
然后 $0.0108290 如果超过限制，每次请求
速率限制: 120 reqs 每分钟
专业客户支持
实时 API 监控
包含无限数据传输

免费 7-天试用

无承诺。随时取消

💫Basic

$20.83/月

3,000 请求 / 月
然后 $0.0108290 如果超过限制，每次请求
速率限制: 60 reqs 每分钟
专业客户支持
实时 API 监控
包含无限数据传输

免费 7-天试用

无承诺。随时取消

Popular

⚡Pro

$41.66/月

6,000 请求 / 月
然后 $0.0108290 如果超过限制，每次请求
速率限制: 60 reqs 每分钟
专业客户支持
实时 API 监控
包含无限数据传输

免费 7-天试用

无承诺。随时取消

🔥Pro Plus

$83.33/月

12,000 请求 / 月
然后 $0.0108290 如果超过限制，每次请求
速率限制: 120 reqs 每分钟
专业客户支持
实时 API 监控
包含无限数据传输

免费 7-天试用

无承诺。随时取消

⚜️Premium

$166.66/月

24,000 请求 / 月
然后 $0.0108290 如果超过限制，每次请求
速率限制: 120 reqs 每分钟
专业客户支持
实时 API 监控
包含无限数据传输

免费 7-天试用

无承诺。随时取消

🚀 企业版

起价
$ 10,000/年

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

预约通话

客户喜爱的功能

✔︎ 仅支付成功请求
✔︎ 7 天免费试用
✔︎ 多语言支持
✔︎ 一个 API 密钥，所有 API。
✔︎ 直观的仪表板

✔︎ 全面的错误处理
✔︎ 开发者友好的文档
✔︎ Postman 集成
✔︎ 安全的 HTTPS 连接
✔︎ 可靠的正常运行时间

位置半径查找器 API FAQs

什么是位置半径查找器API

位置半径查找器API是一个强大的工具，旨在促进基于位置的搜索，允许用户发现并检索特定地理半径内的地点信息

我可以免费使用它或测试它吗

有不同的计划适合每个人，包括一个免费试用的小额请求，但其速率有限制以防止滥用服务

我该如何将它集成到我的项目中

Zyla提供了几乎所有编程语言的广泛集成方法。您可以根据需要使用这些代码与您的项目进行集成

“范围内的城镇”端点返回什么类型的数据

“Towns Within Range”端点返回一个包含城市和城镇详细信息的JSON对象，信息包括名称、国家代码、距离指定坐标的距离、纬度、经度和人口（如有）。

响应数据中的关键字段是什么

响应数据中的关键字段包括“name”（城镇名称）、“countrycode”（ISO国家代码）、“distance”（输入坐标的距离）、“latitude”（地理纬度）、“longitude”（地理经度）和“population”（城镇人口，如有提供）

响应数据是如何组织的

响应数据被组织为一个JSON对象，包含一个“status”字段指示请求的成功与否，一个“count”字段显示找到的城镇数量，以及一个“output”数组，包含各个城镇对象及其详细信息

该端点可以使用哪些参数

该端点需要三个参数：“纬度”（中心点的纬度），“经度”（中心点的经度）和“半径”（以公里为单位的搜索半径）。用户可以通过调整这些值来定制他们的请求。

通过该接口可以获得哪些类型的信息

终端提供关于附近城镇和城市的信息，包括它们的名称、地理坐标、与指定点的距离以及人口数据。这些信息对于各种应用很有用，如旅行规划和本地商业发现

如何保持数据的准确性

数据准确性通过定期更新和与可靠地理数据库的质量检查来维持 API利用复杂的地理算法确保结果与指定坐标的精确和相关

这些数据的典型用例是什么

典型的使用案例包括用于探索附近目的地的旅行应用程序用于评估房地产位置的房地产平台本地商业发现应用程序以及用于根据靠近城镇和城市优化交付路线的物流服务

用户如何有效利用返回的数据

用户可以通过提取相关字段如城镇名称和距离来利用返回的数据，以在他们的应用程序中显示附近的位置。这些信息可以通过提供旅行、房地产或社区参与的背景来增强用户体验

一般常见问题

什么是 Zyla API Hub？

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 调用将如何从我的计划中扣除？

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

您的计费周期如何工作？

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

如何升级我当前的 API 订阅计划？

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

如何查看本月我可以进行的剩余 API 调用次数？

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

如何找出我的订阅计划允许的最大 API 请求数？

要查看您的计划允许的最大 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 调用的权限。请记住这一点以避免不必要的费用。