旨在进行地理编码和地址验证,这是一个促进与地理数据无缝交互的重要工具。这个API不仅简化了地址处理的复杂性,还提高了数据驱动应用程序的整体效率。
本质上,地址检查API将人类可读的地址转换为精确的地理坐标,包括纬度和经度。这一转化对于地图应用程序、基于位置的服务以及任何需要了解物理位置的系统都是至关重要的。地理编码过程包括将地址分解为其组成部分——街道号码、街道名称、城市、州和邮政编码——并利用这些信息识别相应的地理坐标。通过提供这种系统化的转换方法,API使用户能够轻松将位置服务集成到他们的应用程序中。
总之,地址检查API是任何希望有效利用地理数据的用户的宝贵资产。通过简化地理编码和地址验证过程,API不仅提高了运营效率,还使个性化基于位置的服务的交付成为可能。随着对准确和可靠位置数据需求的增长,这个API成为现代开发者工具包中的一个重要组成部分,使他们能够创建满足用户在日益动态的世界中需求的创新解决方案。
要使用此端点,您必须在参数中指明区域代码、地点和地址行。
例如:
{
“address": {
“regionCode": ‘US’,
“locality": ‘山景城’,
“addressLines“: [”1600 Amphitheatre Pkwy"]
}
}
全球邮政编码 - 端点功能
| 对象 | 描述 |
|---|---|
请求体 |
[必需] Json |
{
"result": {
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
"hasInferredComponents": true
},
"address": {
"formattedAddress": "1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA",
"postalAddress": {
"regionCode": "US",
"languageCode": "en",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "Mountain View",
"addressLines": [
"1600 Amphitheatre Pkwy"
]
},
"addressComponents": [
{
"componentName": {
"text": "1600"
},
"componentType": "street_number",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "Amphitheatre Parkway",
"languageCode": "en"
},
"componentType": "route",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "Mountain View",
"languageCode": "en"
},
"componentType": "locality",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "USA",
"languageCode": "en"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
},
{
"componentName": {
"text": "94043"
},
"componentType": "postal_code",
"confirmationLevel": "CONFIRMED",
"inferred": true
},
{
"componentName": {
"text": "CA",
"languageCode": "en"
},
"componentType": "administrative_area_level_1",
"confirmationLevel": "CONFIRMED",
"inferred": true
},
{
"componentName": {
"text": "1351"
},
"componentType": "postal_code_suffix",
"confirmationLevel": "CONFIRMED",
"inferred": true
}
]
},
"geocode": {
"location": {
"latitude": 37.4225078,
"longitude": -122.0847365
},
"plusCode": {
"globalCode": "849VCWF8+24"
},
"bounds": {
"low": {
"latitude": 37.4225078,
"longitude": -122.0847365
},
"high": {
"latitude": 37.4225078,
"longitude": -122.0847365
}
},
"placeId": "ChIJF4Yf2Ry7j4AR__1AkytDyAE",
"placeTypes": [
"street_address"
]
},
"metadata": {
"business": true,
"residential": false
},
"uspsData": {
"standardizedAddress": {
"firstAddressLine": "1600 AMPHITHEATRE PKWY",
"cityStateZipAddressLine": "MOUNTAIN VIEW CA 94043-1351",
"city": "MOUNTAIN VIEW",
"state": "CA",
"zipCode": "94043",
"zipCodeExtension": "1351"
},
"deliveryPointCode": "00",
"deliveryPointCheckDigit": "0",
"dpvConfirmation": "Y",
"dpvFootnote": "AABB",
"dpvCmra": "N",
"dpvVacant": "N",
"dpvNoStat": "Y",
"carrierRouteIndicator": "D",
"postOfficeCity": "MOUNTAIN VIEW",
"postOfficeState": "CA",
"fipsCountyCode": "085",
"county": "SANTA CLARA",
"elotNumber": "0103",
"elotFlag": "A",
"addressRecordType": "S",
"dpvNoStatReasonCode": 5,
"dpvDrop": "N",
"dpvThrowback": "N",
"dpvNonDeliveryDays": "N",
"dpvNoSecureLocation": "N",
"dpvPbsa": "N",
"dpvDoorNotAccessible": "N",
"dpvEnhancedDeliveryCode": "Y"
}
},
"responseId": "99cc6092-16f5-40ec-b7d0-ff279326eb81"
}
curl --location --request POST 'https://zylalabs.com/api/5132/%e5%9c%b0%e5%9d%80%e6%a3%80%e6%9f%a5%e5%99%a8+api/6555/%e5%85%a8%e7%90%83%e9%82%ae%e6%94%bf%e7%bc%96%e7%a0%81' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"addressLines": ["1600 Amphitheatre Pkwy"]
}
}'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
要使用此API,用户必须输入区域代码、地方和地址
有不同的计划适合每个人,包括一个免费的试用来处理少量请求,但它的速率是有限的以防止滥用服务
地址检查器API验证和校验地址,确保基于位置的服务的准确性,并改善企业的数据质量
该API接收区域代码、地方和地址作为输入,并提供经过验证和格式化的地址以及地理坐标(纬度和经度)作为输出
除了每月的API调用次数,没有其他限制
API返回验证过的地址信息,包括格式化地址、邮政细节和地理坐标(纬度和经度)还提供输入和验证的粒度级别,指示地址的完整性
关键字段包括“formattedAddress”、“postalAddress”(包含“postalCode”和“administrativeArea”等组成部分)以及“addressComponents”,详细说明地址的各个部分,例如街道号码和路线
响应采用JSON格式构建,其中“result”对象包含用于验证详细信息的“verdict”和用于格式化和组成地址信息的“address”,便于解析和使用
该端点需要参数,如“区域代码”、“地区”和“地址行”。用户可以通过指定不同的地区和地址格式来定制请求,以获取量身定制的结果
该端点提供全面的地址验证、地理编码详细信息和地理坐标。它还包括有关地址完整性和推断组成部分的信息以提高准确性
数据准确性通过来自可靠地理数据库的持续更新和验证过程来维护,这些过程在返回结果之前确认地址组件的正确性
典型的用例包括在应用程序中集成位置服务、增强交付系统以及提高依赖准确地址信息的企业的客户数据质量
用户可以利用格式化地址用于展示用途,使用地理坐标进行制图,以及分析地址组件以进行数据验证和清洗在他们的应用中
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%
响应时间:
1,484ms
服务级别:
100%
响应时间:
413ms
服务级别:
100%
响应时间:
133ms
服务级别:
100%
响应时间:
695ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
266ms
服务级别:
100%
响应时间:
1,115ms
服务级别:
100%
响应时间:
219ms
服务级别:
100%
响应时间:
860ms
服务级别:
100%
响应时间:
695ms
服务级别:
92%
响应时间:
667ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
434ms
服务级别:
100%
响应时间:
0ms
服务级别:
67%
响应时间:
1,110ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
284ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
1,704ms