完整地址解析器 API

将用户输入转换为完整的、经过验证的地址,包括经纬度、时区、国家和OpenStreetMap归属信息。非常适合表单和物流应用程序
通过 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以JSON格式返回建议,这使其易于集成到各种应用和系统中。

地址自动补全API可用于多种目的,例如:

  • 在表单中自动补全地址字段
  • 改善用户体验
  • 减少错误
  • 地理定位
  • 兴趣点搜索
  • 地址验证
  • 国际地址支持

凭借其强大的功能和易于使用的界面,地址自动补全API是任何从事基于位置的服务、地理定位和地址验证的开发人员必不可少的工具。

 

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

将地址传递给该API,并根据该查询接收建议。

 

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

  1. 在表单中自动补全地址字段:地址自动补全API可用于在表单中自动补全地址字段,使用户更容易更快速地输入其地址信息。

  2. 改善用户体验:该API可用于在用户在搜索框中输入时提供实时匹配位置的建议,这有助于改善用户体验并减少错误。

  3. 地理定位:该API可用于根据地理定位数据提供匹配位置的建议,对于基于位置的服务和应用非常有用。

  4. 兴趣点搜索:该API可用于根据用户的地点或地址搜索兴趣点,如商店、餐馆等。

  5. 地址验证: 该API可用于验证地址信息并检测错误,有助于提高数据质量并减少邮寄和运输错误。

  6. 国际地址支持:该API支持国际地址,使其成为全球应用的多功能工具,同时还支持多种语言。

 

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

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

API 文档

端点


地址自动完成API允许开发者构建基于位置的服务,比如自动完成字段。当用户在搜索框中输入地址的一部分时,API会提供匹配地点的建议


                                                                            
GET https://www.zylalabs.com/api/7745/full+address+resolver+api/12608/autocomplete
                                                                            
                                                                        

自动完成 - 端点功能

对象 描述
text [必需] Free-form address, place, region or area name
lang 可选 Preferable results language code (en, de, it, fr)
countrycodes 可选 Limit search to a comma-separated list of countries (ISO country codes)
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"type":"FeatureCollection","features":[{"type":"Feature","properties":{"country":"United States","country_code":"us","state":"Maryland","county":"Prince George's County","postcode":"20772","street":"Furlong Court","datasource":{"sourcename":"openstreetmap","attribution":"© OpenStreetMap contributors","license":"Open Database License","url":"https://www.openstreetmap.org/copyright"},"state_code":"MD","lon":-76.8148443,"lat":38.8253609,"housenumber":"6","result_type":"building","city":"Upper Marlboro","formatted":"6 Furlong Court, Upper Marlboro, MD 20772, United States of America","address_line1":"6 Furlong Court","address_line2":"Upper Marlboro, MD 20772, 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":"87C5R5GP+43","plus_code_short":"R5GP+43 Upper Marlboro, Prince George's County, United States","rank":{"confidence":0.5,"confidence_street_level":1,"confidence_building_level":0,"match_type":"full_match"},"place_id":"5140f5b468263453c059d5720c6da5694340f00102f9019390be2500000000c00203"},"geometry":{"type":"Point","coordinates":[-76.8148443,38.8253609]},"bbox":[-76.8148443,38.8253609,-76.8135279,38.8254062]}],"query":{"text":"Furlong Court, 6","parsed":{"housenumber":"6","street":"furlong court","expected_type":"building"}}}
                                                                                                                                                                                                                    
                                                                                                    

自动完成 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/7745/full+address+resolver+api/12608/autocomplete?text=Furlong Court, 6&lang=en&countrycodes=gb' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

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

简单透明的定价

无长期承诺。随时升级、降级或取消。

🚀 企业版

起价
$ 10,000/年


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

客户喜爱的功能

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

完整地址解析器 API FAQs

完整地址解析器API根据用户输入返回匹配地址的建议 数据包括国家、省州、城市、街道、邮政编码和格式化地址等详细信息 所有数据均以JSON格式结构化

响应中的关键字段包括“格式化”(完整地址) “国家”(国家名称) “州”(州名称) “城市”(城市名称) “邮政编码”(邮政编码) 和“坐标”(纬度和经度)

响应数据以JSON结构组织在“FeatureCollection”下,包含一个“features”数组。每个特征代表一个建议地址,具有详细描述其组成部分和地理信息的属性

该API提供关于地址的信息,包括街道名称、城市和州的详细信息、邮政编码和地理坐标。它还支持国际地址和多种语言

地址自动完成API的数据来源于OpenStreetMap和其他可靠的数据库。这确保了全球地址和兴趣点的广泛覆盖

用户可以通过提供部分地址字符串作为输入来自定义他们的请求 API 将根据输入返回建议,从而实现定制的自动完成功能

典型的使用情况包括在在线表单中自动填写地址字段 增强基于位置的服务中的用户体验 验证运输地址以及搜索兴趣点

数据准确性通过定期从可靠来源如OpenStreetMap进行更新来维持,并通过质量检查确保地址建议是最新和相关的

一般常见问题

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


您可能还喜欢