位置查找 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提供什么(输入/输出)?

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

 

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

  1. 导航应用:通过将坐标转换为可读地址来增强逐步导航,提升用户体验。

    物流与配送:通过将坐标翻译为精确地址来优化路线规划和简化配送操作。

    紧急服务:迅速定位事件地点,以便快速准确地响应紧急情况。

    电子商务平台:提供基于地理数据的特定地点服务,如当地促销、店铺定位和个性化推荐。

    天气应用:通过将坐标与准确地址关联来改善基于位置的天气报告。

 

您的计划是否有任何限制?

除了API调用次数之外,没有其他限制。

API 文档

端点


要使用此端点,您必须在参数中指明纬度和经度



                                                                            
GET https://zylalabs.com/api/3046/%e4%bd%8d%e7%bd%ae%e6%9f%a5%e6%89%be+api/3221/%e5%8f%8d%e5%90%91%e5%9c%b0%e7%90%86%e7%bc%96%e7%a0%81
                                                                            
                                                                        

反向地理编码 - 端点功能

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

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"type":"FeatureCollection","features":[{"type":"Feature","properties":{"datasource":{"sourcename":"openstreetmap","attribution":"© OpenStreetMap contributors","license":"Open Database License","url":"https://www.openstreetmap.org/copyright"},"name":"White House","country":"United States","country_code":"us","state":"District of Columbia","city":"Washington","postcode":"20500","district":"Ward 2","street":"Pennsylvania Avenue Northwest","housenumber":"1600","lon":-77.03655315,"lat":38.897699700000004,"state_code":"DC","distance":0,"result_type":"amenity","formatted":"White House, 1600 Pennsylvania Avenue Northwest, Washington, DC 20500, United States of America","address_line1":"White House","address_line2":"1600 Pennsylvania Avenue Northwest, Washington, DC 20500, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4VXX7+39","rank":{"importance":0.6347211541681101,"popularity":8.615793062435909},"place_id":"5136f405e3564253c0598490e2d2e7724340f00102f901fe44330e00000000c0020192030b576869746520486f757365"},"geometry":{"type":"Point","coordinates":[-77.03655315,38.897699700000004]},"bbox":[-77.0368537,38.8974908,-77.0362519,38.897911]}],"query":{"lat":38.897675,"lon":-77.036547,"plus_code":"87C4VXX7+39"}}
                                                                                                                                                                                                                    
                                                                                                    

反向地理编码 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/3046/%e4%bd%8d%e7%bd%ae%e6%9f%a5%e6%89%be+api/3221/%e5%8f%8d%e5%90%91%e5%9c%b0%e7%90%86%e7%bc%96%e7%a0%81?lat=38.897675&lon=-77.036547' --header 'Authorization: Bearer YOUR_API_KEY' 


    

要使用此端点,您必须在参数中指定一个地址



                                                                            
GET https://zylalabs.com/api/3046/%e4%bd%8d%e7%bd%ae%e6%9f%a5%e6%89%be+api/3222/%e5%9c%b0%e7%90%86%e7%bc%96%e7%a0%81
                                                                            
                                                                        

地理编码 - 端点功能

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

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"type":"FeatureCollection","features":[{"type":"Feature","geometry":{"type":"Point","coordinates":[-77.036547,38.897675]},"properties":{"country_code":"us","housenumber":"1600","street":"Pennsylvania Avenue NW","country":"United States","county":"District of Columbia","datasource":{"sourcename":"openaddresses","attribution":"© OpenAddresses contributors","license":"BSD-3-Clause License"},"postcode":"20500","state":"District of Columbia","city":"Washington","suburb":"White House Grounds","state_code":"DC","lon":-77.036547,"lat":38.897675,"formatted":"1600 Pennsylvania Avenue NW, Washington, DC 20500, United States of America","address_line1":"1600 Pennsylvania Avenue NW","address_line2":"Washington, DC 20500, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4VXX7+39","result_type":"building","rank":{"popularity":8.615793062435909,"confidence":0.7,"confidence_city_level":1,"confidence_street_level":0.7,"match_type":"full_match"},"place_id":"5115713ac9564253c059e9b7af03e7724340c00203e203496f70656e6164647265737365733a616464726573733a75732f64632f7374617465776964652d6164647265737365732d636974792e6373763a61613533643462643066653239356265"}},{"type":"Feature","geometry":{"type":"Point","coordinates":[-76.981976,38.879213]},"properties":{"country_code":"us","housenumber":"1600","street":"Pennsylvania Avenue SE","country":"United States","county":"District of Columbia","datasource":{"sourcename":"openaddresses","attribution":"© OpenAddresses contributors","license":"BSD-3-Clause License"},"postcode":"20003","state":"District of Columbia","city":"Washington","suburb":"Barney Circle","state_code":"DC","lon":-76.981976,"lat":38.879213,"formatted":"1600 Pennsylvania Avenue SE, Washington, DC 20003, United States of America","address_line1":"1600 Pennsylvania Avenue SE","address_line2":"Washington, DC 20003, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C5V2H9+M6","result_type":"building","rank":{"popularity":6.391268404135374,"confidence":0.7,"confidence_city_level":1,"confidence_street_level":0.7,"match_type":"full_match"},"place_id":"513e5dddb1d83e53c059e99b340d8a704340c00203e203496f70656e6164647265737365733a616464726573733a75732f64632f7374617465776964652d6164647265737365732d636974792e6373763a36396530353933646261343435366566"}},{"type":"Feature","geometry":{"type":"Point","coordinates":[-77.0280685,38.8951022]},"properties":{"country_code":"us","housenumber":"1600","street":"Pennsylvania Avenue Northwest","country":"United States","county":"District of Columbia","datasource":{"sourcename":"mixed"},"state":"District of Columbia","city":"Washington","suburb":"National Mall","state_code":"DC","lon":-77.0280685,"lat":38.8951022,"postcode":"20004","formatted":"1600 Pennsylvania Avenue Northwest, Washington, DC 20004, United States of America","address_line1":"1600 Pennsylvania Avenue Northwest","address_line2":"Washington, DC 20004, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4VXWC+2Q","result_type":"building","rank":{"popularity":8.06250055951683,"confidence":0.7,"confidence_city_level":1,"confidence_street_level":0.7,"match_type":"full_match"},"place_id":"510f63d2dfcb4153c059f0c979b592724340c00203e2031f6d697865643a616464726573733a706f6c796c696e653a3239353030343533"}},{"type":"Feature","properties":{"datasource":{"sourcename":"openstreetmap","attribution":"© OpenStreetMap contributors","license":"Open Database License","url":"https://www.openstreetmap.org/copyright"},"name":"Pennsylvania Avenue","country":"United States","country_code":"us","state":"District of Columbia","city":"Washington","postcode":"20045","district":"Ward 2","street":"Pennsylvania Avenue","lon":-77.0307713,"lat":38.895865,"state_code":"DC","formatted":"Pennsylvania Avenue, Washington, DC 20045, United States of America","address_line1":"Pennsylvania Avenue","address_line2":"Washington, DC 20045, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4VXW9+8M","result_type":"street","rank":{"importance":0.37500999999999995,"popularity":8.485326670419871,"confidence":0.5,"confidence_city_level":1,"confidence_street_level":1,"match_type":"match_by_street"},"place_id":"51f2c92f28f84153c059c6504eb4ab724340f00102f901e62cac2100000000c0020492031350656e6e73796c76616e6961204176656e7565"},"geometry":{"type":"Point","coordinates":[-77.0307713,38.895865]},"bbox":[-77.0308089,38.8958545,-77.0307313,38.8958753]},{"type":"Feature","geometry":{"type":"Point","coordinates":[-77.045926,38.901586]},"properties":{"country_code":"us","housenumber":"2019","street":"Pennsylvania Avenue","country":"United States","county":"District of Columbia","datasource":{"sourcename":"openstreetmap","attribution":"© OpenStreetMap contributors","license":"Open Database License","url":"https://www.openstreetmap.org/copyright"},"state":"District of Columbia","city":"Washington","suburb":"Downtown","state_code":"DC","lon":-77.045926,"lat":38.901586,"postcode":"20045","formatted":"2019 Pennsylvania Avenue, Washington, DC 20045, United States of America","address_line1":"2019 Pennsylvania Avenue","address_line2":"Washington, DC 20045, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4WX23+JJ","result_type":"building","rank":{"popularity":8.294584012183657,"confidence":0.5,"confidence_city_level":1,"confidence_street_level":1,"match_type":"full_match"},"place_id":"514f029b73f04253c0590744882b67734340f00102f901f878f90300000000c00203e203226f70656e7374726565746d61703a616464726573733a7761792f3636363831303830"}}],"query":{"text":"1600 Pennsylvania Ave Washington DC","parsed":{"housenumber":"1600","street":"pennsylvania ave","city":"washington","state":"dc","expected_type":"building"}}}
                                                                                                                                                                                                                    
                                                                                                    

地理编码 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/3046/%e4%bd%8d%e7%bd%ae%e6%9f%a5%e6%89%be+api/3222/%e5%9c%b0%e7%90%86%e7%bc%96%e7%a0%81?address=1600 Pennsylvania Ave Washington DC' --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

要使用此API,用户必须输入纬度和经度或地址

位置查找API是一个强大的工具,可以将地理坐标(纬度和经度)转换为人类可读的地址和基于位置的信息

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

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

GET 反向地理编码接口返回详细地址信息,包括格式化地址、城市、省份、国家和邮政编码 GET 地理编码接口提供地理坐标(纬度和经度)以及格式化地址和其他位置信息

响应中的关键字段包括“格式化”(完整地址)、“城市”、“州”、“国家”、“邮政编码”、“纬度”和“经度”。这些字段帮助用户识别精确的位置及其可读的地址

响应数据被结构化为一个包含“特征集合”的JSON对象 每个特征包括地址详细信息和地理坐标等属性 便于解析和集成到应用程序中

GET逆地理编码端点提供从坐标获取可读地址,而GET地理编码端点则返回从地址获取坐标。两个端点都包含国家代码和时区等额外元数据

该API利用来自OpenStreetMap和OpenAddresses等可靠来源的数据 这些来源确保准确地址转换的全面和最新的地理信息

用户可以通过指定反向地理编码所需的纬度和经度或地理编码所需的地址来自定义请求。其他参数可能包括针对特定数据类型或地区的过滤器,这取决于API的功能

用户可以提取关键字段,如“formatted”用于显示目的,“lat”和“lon”用于地图,和“city”或“state”用于基于位置的服务。这些数据可以增强导航、物流和应急响应中的应用

典型的用例包括通过可读地址增强导航应用程序 优化配送路线 提供电子商务中的位置特定服务 以及通过快速识别事件位置来改善紧急响应

一般常见问题

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 日之前提交请求,您的付款将在此时间范围内处理。


相关 API