开发者文档

功能简介

该服务可通过用户输入的非格式化文本地址信息,根据标准权威的级地址,返回格式化的地址列表,供用户选择,从而录入格式化的地址。

请求地址
环境 HTTP请求地址
正式环境 http://api.globaladsser.com/autocomplete
沙箱环境 http://test.globaladsser.com/autocomplete
公共请求参数
名称 类型 是否必须 描述
app_key String 接入密钥
请求参数
名称 类型 是否必须 描述
country_code String 国家简码
input String 用户输入的城市
响应参数
名称 类型 描述
code Integer 调用是否成功,0:成功,非0:失败
message String 错误信息
data Json 响应详细信息
响应详情
名称 类型 描述
description String 地址详情描述
city String 城市名称
postcode String 邮政编码
请求示例
http://test.globaladsser.com/autocomplete?app_key=3691308f2a4c2f&country_code=US&input=NewYork
响应示例
{
"code": 0,
"message": "success",
"data": [
{
"description": "New York, NY, USA",
"highlight": [
{
"length": 8,
"offset": 0
}
]
},
{
"description": "New York Penn Station, New York, NY, USA",
"highlight": [
{
"length": 8,
"offset": 0
}
]
},
{
"description": "NewYork-Presbyterian Queens, Main Street, Flushing, NY, USA",
"highlight": [
{
"length": 7,
"offset": 0
}
]
},
{
"description": "New York Hall Of Science, 111th Street, Corona, NY, USA",
"highlight": [
{
"length": 8,
"offset": 0
}
]
},
{
"description": "New York Public Library - Stephen A. Schwarzman Building, 5th Avenue, New York, NY, USA",
"highlight": [
{
"length": 8,
"offset": 0
}
]
}
],
"localData": null
}

功能简介

对用户手动输入的地址进行校验、纠错。提高地址的正确率

请求地址
环境 HTTP请求地址
正式环境 http://api.globaladsser.com/verification
沙箱环境 http://test.globaladsser.com/verification
公共请求参数
名称 类型 是否必须 描述
app_key String 接入密钥
请求参数
名称 类型 是否必须 描述
country_code String 国家简码
state String 州省名称
city String 城市名
phone Integer 电话号码
postcode Integer 邮编
address String 校验地址
响应参数
名称 类型 描述
code Integer 调用是否成功,0:成功,非0:失败
message String 错误信息
data Json 响应详细信息
响应详情
名称 类型 描述
phone Object 电话号码校验结果
postcode Object 邮编校验结果
country_code Object 国家名校验结果
请求示例
http://test.globaladsser.com/verification?app_key=3691308f2a4c2f&postcode=80153&phone=716-663-0584&address=3079+Keith+Shore%0AMatthewside%2C+VT+74023
响应示例
正确的情况
{
"code": 0,
"message": "success",
"data": null,
"localData": null
}
错误的情况
{
"code": 2040000001,
"message": "Please enter correct address information",
"data": {
"addressline1": "Please enter correct addressline1",
"phone": "Please enter correct phone"
},
"localData": null
}

功能简介

国家、州省、城市三级下拉,精确匹配防止手误造成的输入错误地址

请求地址
环境 HTTP请求地址
正式环境 http://api.globaladsser.com/associate
沙箱环境 http://test.globaladsser.com/associate
公共请求参数
名称 类型 是否必须 描述
app_key String 接入密钥
请求参数
名称 类型 是否必须 描述
level String 行政级别等级
country_code String 国家简码
state_id Integer 州省id
响应参数
名称 类型 描述
code Integer 调用是否成功,0:成功,非0:失败
message String 错误信息
data Json 响应详细信息
localData Json 额外调试信息
响应详情
名称 类型 描述
country_acronym_two String 国家简码
country_name_gb String 国家名称
state_id Integer 州省id
state_code String 州省简码(可缺省)
state_name_en String 州省名称
city_id Integer 城市id
city_code Integer 城市简码(可缺省)
city_name_en String 城市名称
请求示例
http://test.globaladsser.com/associate?app_key=3691308f2a4c2f&level=country
http://test.globaladsser.com/associate?app_key=3691308f2a4c2f&level=state&country_code=US
http://test.globaladsser.com/associate?app_key=3691308f2a4c2f&level=city&country_code=US&state_id=121
响应示例
国家列表
{
"code": 0,
"message": "success",
"data": [
{
"id": "1",
"country_acronym_two": "AD",
"country_name_gb": "Andorra"
},
{
"id": "2",
"country_acronym_two": "AE",
"country_name_gb": "United Arab Emirates"
}
],
"localData": null
}

州省列表
{
"code": 0,
"message": "success",
"data": [
{
"state_id": "121",
"state_code": "AL",
"state_name_en": "Alabama"
},
{
"state_id": "176",
"state_code": "WI",
"state_name_en": "Wisconsin"
},
{
"state_id": "177",
"state_code": "WY",
"state_name_en": "Wyoming"
}
],
"localData": null
}
城市列表
{
"code": 0,
"message": "success",
"data": [
{
"city_id": "81513",
"city_code": "",
"city_name_en": "Abbeville"
},
{
"city_id": "82099",
"city_code": "",
"city_name_en": "York"
}
],
"localData": null
}

功能简介

过对输入的文本地址标准化及对经纬度列表过滤处理得到精确度更高的经纬度坐标信息。

请求地址
环境 HTTP请求地址
正式环境 https://api.globaladsser.com/coordinate
沙箱环境 https://test.globaladsser.com/coordinate
公共请求参数
名称 类型 是否必须 描述
app_key String 接入密钥
请求参数
名称 类型 是否必须 描述
lat String 经度
lng String 维度
响应参数
名称 类型 描述
code Integer 调用是否成功,0:成功,非0:失败
message String 错误信息
data Json 响应详细信息
响应详情
名称 类型 描述
formatted_address String 格式化后的地址
address_components Object 地址的详细信息
请求示例
http://test.globaladsser.com/coordinate?app_key=3691308f2a4c2f&lat=48.4445821&lng=-71.4976428
响应示例
{
"code": 0,
"message": "success",
"data": {
"formatted_address": "531 Chemin du Lac-Hippolyte, Larouche, Quebec, Canada",
"address_components": {
"country_code": "CA",
"country": "Canada",
"state": "Quebec",
"city": "Larouche",
"addressline1": "531 Chemin du Lac-Hippolyte",
"addressline2": "",
"postcode": "G0W 1Z0"
}
},
"localData": null
}