核心API

地理位置信息 API 版本介绍

在查询地理位置信息时，选择合适的 API 版本可以有效提升数据的精准度，满足不同业务场景需求。目前，API 提供了以下三个版本：V1、V2、V3，用户可根据应用场景灵活选择。

V1 版本：基础地理位置信息

• 请求地址：
  https://api.kertennet.com/geography/locationInfo

• 请求方式：
  GET

• 请求参数：

  参数	类型	是否必填	说明
  lng	double	是	经度
  lat	double	是	纬度
  appCode	string	否	访问密钥（可选）

• 示例请求：
  https://api.kertennet.com/geography/locationInfo?lat=23.078717&lng=113.881279&appCode=密钥

• 响应示例：

  {
      "code": 200,
      "data": {
          "province": "省",
          "city": "城市",
          "district": "地区",
          "street": "街道名",
          "streetNumber": "街道门牌号",
          "distance": "相对当前坐标点距离（米），当有门牌号则返回",
          "direction": "和当前坐标点的方向"
      }
  }

• 功能特点：

• 提供基本地理信息：省、市、区、街道。

• 返回方向与距离信息（仅当有门牌号时提供）。

• 适用于对位置数据精度要求较低的场景。

• 适用场景：

• 快速查询某坐标的行政区域划分。

• 仅需基础地理信息的系统，如位置标注、区域识别等。

V2 版本：升级版，提供丰富的道路信息

• 请求地址：
  https://api.kertennet.com/geography/locationInfo_v2

• 请求方式：
  GET

• 请求参数：

  参数	类型	是否必填	说明
  lng	double	是	经度
  lat	double	是	纬度
  appCode	string	否	访问密钥（可选）

• 示例请求：
  https://api.kertennet.com/geography/locationInfo_v2?lat=23.078717&lng=113.881279&appCode=密钥

• 响应示例：

  {
      "code": 200,
      "data": {
          "address": "详细地址",
          "province": "省",
          "city": "城市",
          "direction": "地区",
          "street": "简要的位置信息描述，通常包括附近地标、道路等",
          "streetNumber": "街道门牌号",
          "roadList": [
              {
                  "distance": "与当前地址的距离（单位：米）",
                  "direction": "方向",
                  "name": "道路名称",
                  "latitude": "道路的纬度坐标",
                  "width": "道路宽度（单位：米）",
                  "longitude": "道路的纬度坐标"
              }
          ]
      }
  }

• 功能特点：

• 在 V1 基础上，新增详细地址信息。

• 提供周边道路信息（如名称、方向、距离、等级等）。

• 更适用于导航类应用或需要高精度地理信息的系统。

• 适用场景：

• 查询精细地址，如街道、门牌号。

• 获取周边道路信息，用于地图可视化或路径规划。

V3 版本：全球查询，支持中英文返回

• 请求地址：
  https://api.kertennet.com/geography/locationInfo_v3

• 请求方式：
  GET

• 请求参数：

  参数	类型	是否必填	说明
  lng	double	是	经度
  lat	double	是	纬度
  language	string	否	语言（zh: 中文, en: 英文）
  appCode	string	否	访问密钥（可选）

• 示例请求：
  https://api.kertennet.com/geography/locationInfo_v3?lat=23.129045&lng=113.320317&language=zh&appCode=密钥

• 响应示例：

  {
      "code": 200,
      "data": {
          "country": "国家",
          "state": "省级",
          "city": "一般为市/区级",
          "suburb": "街道",
          "road": "道路",
          "village": "村",
          "address": "完整地址"
      }
  }

• 功能特点：

• 支持全球范围位置查询。

• 返回完整地址信息：国家、省、市、街道、村庄等。

• 可根据 language 参数返回中文或英文。

• 适用场景：

• 跨国出行、国际物流等应用场景。

• 多语言支持需求的系统，如国际化应用、海外地图服务等。

版本对比与选择建议

• 选择建议：

• V1： 适合快速查询行政区划信息，对精度要求不高。

• V2： 推荐用于导航、地图、周边分析等高精度场景。

• V3： 最佳选择用于国际业务或需中英文信息支持的系统。

如需接入，请根据实际需求选择对应的版本接口并准备相应参数。