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

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

 

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

  1. 导航系统:通过根据当前坐标显示人类可读地址来增强GPS导航系统。

  2. 基于位置的服务:通过将坐标转换为可理解的地址来支持基于位置的服务,如本地搜索。

  3. 电子商务配送:通过从客户坐标获取准确地址来简化电子商务配送流程,以实现高效物流。

  4. 紧急服务:帮助紧急服务迅速识别和到达基于接收到的求助电话的坐标位置。

  5. 社交媒体中的地理标记:通过将详细地址附加到地理标记的帖子上来改善社交媒体平台中的用户体验。

 

您计划的限制有哪些?

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

API 文档

端点


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



                                                                            
GET https://zylalabs.com/api/3943/coordinate+lookup+api/4686/calculate+distance
                                                                            
                                                                        

计算距离 - 端点功能

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

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"type":"FeatureCollection","features":[{"type":"Feature","geometry":{"type":"Point","coordinates":[19.908399,-80.508219]},"properties":{"country_code":"aq","name":"Antarctica","country":"Antarctica","datasource":{"sourcename":"whosonfirst","attribution":"Who's On First","license":"CC0","url":"https://www.whosonfirst.org/docs/licenses/"},"lon":19.908399,"lat":-80.508219,"distance":559112.2246212653,"result_type":"country","formatted":"Antarctica","address_line1":"Antarctica","address_line2":"","timezone":{"name":"Antarctica/Troll","offset_STD":"+00:00","offset_STD_seconds":0,"offset_DST":"+02:00","offset_DST_seconds":7200},"plus_code":"2FFXFWR5+P9","rank":{"popularity":0.09816269854899543},"place_id":"5117b83cd68ce83340592c0dfca8862054c0c0020b92030a416e7461726374696361e2031c77686f736f6e66697273743a636f756e7472793a3835363332373135"},"bbox":[-180,-90,180,-60.516209]}],"query":{"lat":-77.036547,"lon":38.897675,"plus_code":"2GJWXV7X+93"}}
                                                                                                                                                                                                                    
                                                                                                    

计算距离 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/3943/coordinate+lookup+api/4686/calculate+distance?lon=38.897675&lat=-77.036547' --header 'Authorization: Bearer YOUR_API_KEY' 


    

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



                                                                            
GET https://zylalabs.com/api/3943/coordinate+lookup+api/4687/detailed+address
                                                                            
                                                                        

详细地址 - 端点功能

对象 描述
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,"result_type":"building","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","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,"result_type":"building","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","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.0280696,38.8951025]},"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.0280696,"lat":38.8951025,"result_type":"building","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","rank":{"popularity":8.06250055951683,"confidence":0.7,"confidence_city_level":1,"confidence_street_level":0.7,"match_type":"full_match"},"place_id":"51c1806fe4cb4153c059af08feb792724340c00203e2031f6d697865643a616464726573733a706f6c796c696e653a3239373135363130"}},{"type":"Feature","geometry":{"type":"Point","coordinates":[-76.9820211,38.8787989]},"properties":{"country_code":"us","housenumber":"1600","street":"Pennsylvania Avenue Southeast","country":"United States","county":"District of Columbia","datasource":{"sourcename":"mixed"},"state":"District of Columbia","city":"Washington","suburb":"The Capitol Grounds","state_code":"DC","lon":-76.9820211,"lat":38.8787989,"result_type":"building","postcode":"20003","formatted":"1600 Pennsylvania Avenue Southeast, Washington, DC 20003, United States of America","address_line1":"1600 Pennsylvania Avenue Southeast","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+G5","rank":{"popularity":6.391268404135374,"confidence":0.7,"confidence_city_level":1,"confidence_street_level":0.7,"match_type":"full_match"},"place_id":"51d81e076fd93e53c05961a17b7b7c704340c00203e2031f6d697865643a616464726573733a706f6c796c696e653a3332323138303931"}},{"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","result_type":"street","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","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]}],"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/3943/coordinate+lookup+api/4687/detailed+address?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提供了几乎所有编程语言的广泛集成方法。您可以根据需要使用这些代码与您的项目进行集成

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

“计算距离”接口返回地理坐标、国家信息和格式化地址 “详细地址”接口提供全面的地址详情,包括门牌号、街道、城市、州和邮政编码

主要字段包括"formatted"用于完整地址,"lat"和"lon"用于坐标,"country_code"用于国家,以及"result_type"指示位置类型(例如,建筑物,国家)

响应的结构是一个包含“FeatureCollection”和“features”数组的JSON对象。每个特征包含“geometry”用于坐标和“properties”用于详细地址信息

“计算距离”端点需要经纬度作为参数“详细地址”端点需要一个具体地址以获取详细位置信息

“计算距离”端点提供国家和距离详细信息,而“详细地址”端点提供完整的地址组成部分,包括街道名称、城市、州和邮政编码

数据准确性通过使用广泛的地理空间数据库和先进的算法来确保,同时还定期从可靠来源如OpenAddresses和Who's On First更新

常见的用例包括增强GPS导航、为应用程序提供本地搜索、简化电子商务配送,以及改善社交媒体帖子中的地理标记

用户可以提取特定字段,例如“formatted”用于显示用途,使用“lat”和“lon”进行地图绘制,并利用“result_type”根据返回的位置类型定制功能

一般常见问题

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


您可能还喜欢