地理位置信息查询接口V1
1. 接口简介
本接口用于查询指定经纬度的地理位置信息,包括省、市、区、街道等详细信息。
- 报文编码格式:UTF-8
- 接口分组:交通地理
- 创建者:何生
- 最后编辑人:何生
- 更新时间:2025-01-16 17:30:39
2. 请求说明
2.1 请求 URL
https://api.kertennet.com/geography/locationInfo?lat={纬度}&lng={经度}
示例:https://api.kertennet.com/geography/locationInfo?lat=23.078717&lng=113.881279
2.2 请求方法
GET
2.3 请求头部
参数名 | 类型 | 必填 | 说明 | 示例值 |
---|
Content-Type | string | 是 | 请求内容类型 | application/json |
2.4 Query 参数
参数名 | 类型 | 必填 | 说明 | 示例值 | 最小值 | 最大值 |
---|
lng | string | 是 | 经度 | 113.881279 | - | - |
lat | string | 是 | 纬度 | 23.078717 | - | - |
3. 返回说明
3.1 返回头部
参数名 | 类型 | 说明 | 示例值 |
---|
content-type | string | 响应内容类型 | application/json;charset=UTF-8 |
date | string | 响应时间 | Mon, 24 Oct 2022 02:44:37 GMT |
transfer-encoding | string | 传输编码 | chunked |
3.2 返回参数
返回 JSON 结构如下:
{
"code": "200",
"message": "success",
"data": {
"province": "广东省",
"city": "东莞市",
"district": "东莞市市辖区",
"street": "茶山大道",
"streetNumber": "中175号",
"distance": "35",
"direction": "near"
}
}
3.3 字段说明
参数名 | 类型 | 必填 | 说明 | 示例值 |
---|
code | string | 是 | 响应状态码 | 200 |
message | string | 是 | 响应消息 | success |
data | object | 是 | 具体的地理位置信息 | - |
province | string | 是 | 省份 | 广东省 |
city | string | 是 | 城市 | 东莞市 |
district | string | 是 | 区/县 | 东莞市市辖区 |
street | string | 是 | 街道名称 | 茶山大道 |
streetNumber | string | 是 | 门牌号 | 中175号 |
distance | string | 是 | 与当前坐标点的距离(米) | 35 |
direction | string | 是 | 方向信息 | near |
4. 备注
distance
仅在 streetNumber
存在时返回。direction
表示当前坐标点与返回位置的相对方向。appCode
需要由 API 提供方分配,调用接口时请确保携带该参数。