java 获取Map地图经纬度与所处地理名称相互转化

红太狼 2022-08-13 12:48 206阅读 0赞

## 什么是Geocoding？ ##

Geocoding API是一个供程序员调用的、http形式的地图服务接口。主要服务那些非网页程序的调用。例如C\# 、C++、Java等开发语言都能发送http请求且能接收返回数据。

用户只需在请求的url字串中拼接好关键字或者经纬度信息，即可获取到相应的百度经纬度或者结构化地理信息。

![java 获取Map地图 经纬度与所处地理名称 相互转化 - Yegshine - yegshine][java _Map_ _ _ - Yegshine - yegshine]

## Geocoding API有哪些功能？ ##

Geocoding API包括地址解析和逆地址解析功能。

*  地址解析是指，由详细到街道的结构化地址得到百度经纬度信息，且支持名胜古迹、标志性建筑名称直接解析返回百度经纬度。例如：“北京市海淀区中关村南大街27号”地址解析的结果是“lng:116.31985,lat:39.959836”，“百度大厦”地址解析的结果是“lng:116.30815,lat:40.056885”
 *  逆地址解析是指，由百度经纬度信息得到结构化地址信息。例如：“lat:31.325152,lng:120.558957”逆地址解析的结果是“江苏省苏州市虎丘区塔园路318号”。

注意：

1.因为Geocoding和反Geocoding使用的门址数据以及算法都不是一样的，所以会出现不能一一对应的现象。

2.解析过程中可能会出现一对坐标值对应多个地址门牌信息，本接口将返回距离坐标点最近的一个地址门牌信息。

## 使用限制 ##

目前无任何使用限制。请申请key，然后使用该接口。

## 如何使用 ##

第一步，申请key，点击这里[获取密钥][Link 1]，申请key需要注册百度账号；

第二步，拼写发送http请求的url，注意需使用第一步申请的key；

第三步，接收http请求返回的数据（支持json和xml格式）。

## 服务地址 ##

*  地址解析：根据地址获取坐标
    
    [http://api.map.baidu.com/geocoder?address=地址&output=输出格式类型&key=用户密钥&city=城市名][http_api.map.baidu.com_geocoder_address_output_key_city]
 *  逆地址解析：根据坐标获取地址
    
    [http://api.map.baidu.com/geocoder?location=纬度,经度&output=输出格式类型&key=用户密钥][http_api.map.baidu.com_geocoder_location_output_key]

备注：

1. city属于可选参数，通常情况可以不使用，若解析无结果，请尝试增加此字段。

2. 支持名胜古迹、标志性建筑物名称解析返回百度经纬度坐标，如address=“百度大厦”。

3. 支持使用“\*路与\*路交叉口”方式解析返回百度经纬度坐标，若地址库中存在该地址描述，返回百度经纬度坐标。

4. 若解析status字段为OK，若结果内容为空，原因分析及可尝试方法：

*  
 *  地址库里无此数据，本次结果为空。
 *  加入city字段重新解析；
 *  将过于详细或简单的地址更改至省市区县街道重新解析；

5. 特别提醒：逆地址解析location参数传入的参数格式是(纬度lat，经度lng)。

## 接口参数 ##

<table style="line-height:21px; border-collapse:collapse; font-size:12px; margin:8px 0px 2px; color:rgb(0,0,0); font-family:Simsun; background-color:rgb(204,206,208)"> 
 <tbody> 
  <tr> 
   <th style="line-height:30px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px; background-color:rgb(238,244,254)"> 参数</th> 
   <th style="line-height:30px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px; background-color:rgb(238,244,254)"> 是否必须</th> 
   <th style="line-height:30px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px; background-color:rgb(238,244,254)"> 默认值</th> 
   <th style="line-height:30px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px; background-color:rgb(238,244,254)"> 格式举例</th> 
   <th style="line-height:30px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px; background-color:rgb(238,244,254)"> 含义</th> 
  </tr> 
  <tr> 
   <td style="line-height:20px; color:rgb(10,128,33); font-family:consolas,'courier new',monospace; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> output</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 否</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> json</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> json或xml</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 输出格式为json或者xml</td> 
  </tr> 
  <tr> 
   <td style="line-height:20px; color:rgb(10,128,33); font-family:consolas,'courier new',monospace; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> address</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 是</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 无</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 北京市海淀区上地十街10号</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 根据指定地址进行坐标的反定向解析</td> 
  </tr> 
  <tr> 
   <td style="line-height:20px; color:rgb(10,128,33); font-family:consolas,'courier new',monospace; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> location</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 是</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 无</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 38.76623,116.43213<br style="line-height:21px"> lat&lt;纬度&gt;,lng&lt;经度&gt;</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 根据指定坐标来进行地址的解析</td> 
  </tr> 
  <tr> 
   <td style="line-height:20px; color:rgb(10,128,33); font-family:consolas,'courier new',monospace; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> city</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 否</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> “北京市”</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> “广州市”</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 地址所在的城市名</td> 
  </tr> 
  <tr> 
   <td style="line-height:20px; color:rgb(10,128,33); font-family:consolas,'courier new',monospace; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> key</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 是</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 无</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 8cb976834235d8cbcde2dce4835ae191</td> 
   <td style="line-height:20px; border:1px solid rgb(204,204,204); height:30px; padding:0px 6px 0px 10px"> 用户申请注册的key</td> 
  </tr> 
 </tbody> 
</table>

上表中address和location两个字段如果同时出现，则优先选择address执行地理编码功能。对于address字段可能会出现中文或其它一些特殊字符（如：空格），所以对于类似的字符都要进行编码处理，编码成 UTF-8 字符的二字符十六进制值，凡是不在下表中的字符都要进行编码。

附注：

(1) javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

(2) Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

(3) C\#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

(4) php中可以使用函数urlencode对特殊字符进行编码。

## 返回数据说明 ##

返回结果（地址解析的结果）

{status: '字符串状态常量', 取值如下：
     //OK 成功
     INVILID_KEY 非法密钥 
     INVALID_PARAMETERS 非法参数，参数错误时候给出。
     result: {    
     location: {
     lat: 纬度：数值，
     lng: 经度：数值
     },
     precise:’位置的附加信息，是否精确查找’（1为精确查找，0为不精确查找）,
     confidence: 可信度,
     level:'级别'
     },
     }

返回结果（反地址解析的结果）

{status: '字符串状态常量', 取值如下：
     //OK 成功
     INVILID_KEY 非法密钥   
     INVALID_PARAMETERS 非法参数，参数错误时候给出。
     result: {    
     location: {
     lat: 纬度：数值，
     lng: 经度：数值
     },
     formatted_address: ‘详细地址描述’,
     business: '周围商圈',
     addressComponent:{
     city:’城市名称’,
     district: ‘区县名称’,
     province:’省份名称’, 
     street: ‘街道名称’,
     streetNumber: '门牌号码' 
     },
     cityCode: '城市代码'
     }
     }

## 接口示例 ##

根据详细地址获取坐标

http://api.map.baidu.com/geocoder?address=%E4%B8%8A%E5%9C%B0%E5%8D%81%E8%A1%9710%E5%8F%B7&output=json&key=37492c0ee6f924cb5e934fa08c6b1676
                //根据“上地十街10号”返回坐标“lng:116.307175, lat:40.057098”，以json格式输出
                http://api.map.baidu.com/geocoder?address=%E4%B8%8A%E5%9C%B0%E5%8D%81%E8%A1%9710%E5%8F%B7&output=xml&key=37492c0ee6f924cb5e934fa08c6b1676
                //根据“上地十街十号”返回坐标“lng:116.307175, lat:40.057098”，以xml格式输出

在指定城市内检索详细地址的坐标

http://api.map.baidu.com/geocoder?address=%E4%B8%8A%E5%9C%B0%E5%8D%81%E8%A1%9710%E5%8F%B7&output=json&key=37492c0ee6f924cb5e934fa08c6b1676&city=%E5%8C%97%E4%BA%AC%E5%B8%82
                // 在北京市内根据“上地十街10号”返回坐标“lng:116.307175, lat:40.057098”，以json格式输出
                http://api.map.baidu.com/geocoder?address=%E4%B8%8A%E5%9C%B0%E5%8D%81%E8%A1%9710%E5%8F%B7&output=xml&key=37492c0ee6f924cb5e934fa08c6b1676&city=%E5%8C%97%E4%BA%AC%E5%B8%82
                // 在北京市内根据“上地十街10号”返回坐标“lng:116.307175, lat:40.057098”，以json格式输出

根据特定建筑物获取它的坐标

http://api.map.baidu.com/geocoder?address=%E7%99%BE%E5%BA%A6%E5%A4%A7%E5%8E%A6&output=json&key=37492c0ee6f924cb5e934fa08c6b1676  //根据“百度大厦”名称返回坐标“lng:116.307175, lat:40.057098”，以json格式输入
    
                http://api.map.baidu.com/geocoder?address=%E7%99%BE%E5%BA%A6%E5%A4%A7%E5%8E%A6&output=xml&key=37492c0ee6f924cb5e934fa08c6b1676  //根据“百度大厦”名称返回坐标“lng:116.307175, lat:40.057098”，以xml格式输入

根据“\*路与\*路交叉路口”类型地址描述获得它的坐标

http://api.map.baidu.com/geocoder?address=%E5%8C%97%E4%B8%80%E7%8E%AF%E8%B7%AF%E5%92%8C%E9%98%9C%E9%98%B3%E8%B7%AF%E7%9A%84%E4%BA%A4%E5%8F%89%E8%B7%AF%E5%8F%A3&output=json&key=37492c0ee6f924cb5e934fa08c6b1676
                //根据“北一环路和阜阳路的交叉路口”名称返回坐标“lng:117.294364, lat:31.885558”，以json格式输入
    
                http://api.map.baidu.com/geocoder?address=%E5%8C%97%E4%B8%80%E7%8E%AF%E8%B7%AF%E5%92%8C%E9%98%9C%E9%98%B3%E8%B7%AF%E7%9A%84%E4%BA%A4%E5%8F%89%E8%B7%AF%E5%8F%A3&output=xml&key=37492c0ee6f924cb5e934fa08c6b1676
                //根据“北一环路和阜阳路的交叉路口”名称返回坐标“lng:117.294364, lat:31.885558”，以xml格式输入

根据坐标获取它的地址

http://api.map.baidu.com/geocoder?output=json&location=39.983424,%20116.322987&key=37492c0ee6f924cb5e934fa08c6b1676
                //解析“lat:39.983424, lng:116.322987”坐标返回“北京市海淀区中关村大街27号1101-08室”，以json格式输出
                http://api.map.baidu.com/geocoder?output=xml&location=39.983424,%20116.322987&key=37492c0ee6f924cb5e934fa08c6b1676
                //解析“lat:39.983424, lng:116.322987”坐标返回“北京市海淀区中关村大街27号1101-08室”，以xml格式输出

参考地址：http://developer.baidu.com/map/geocoding-api.htm#.E5.A6.82.E4.BD.95.E4.BD.BF.E7.94.A8

[java _Map_ _ _ - Yegshine - yegshine]: http://img.ph.126.net/P5vbeLp8GDdbJNWNVZ6isA==/6597316057261543624.jpg
[Link 1]: http://developer.baidu.com/map/apply-key.htm
[http_api.map.baidu.com_geocoder_address_output_key_city]: http://api.map.baidu.com/geocoder?address=%E5%9C%B0%E5%9D%80&output=%E8%BE%93%E5%87%BA%E6%A0%BC%E5%BC%8F%E7%B1%BB%E5%9E%8B&key=%E7%94%A8%E6%88%B7%E5%AF%86%E9%92%A5&city=%E5%9F%8E%E5%B8%82%E5%90%8D
[http_api.map.baidu.com_geocoder_location_output_key]: http://api.map.baidu.com/geocoder?location=%E7%BA%AC%E5%BA%A6,%E7%BB%8F%E5%BA%A6&output=%E8%BE%93%E5%87%BA%E6%A0%BC%E5%BC%8F%E7%B1%BB%E5%9E%8B&key=%E7%94%A8%E6%88%B7%E5%AF%86%E9%92%A5