正逆地址解析采坑

工作中需要做一个地址解析的功能，即地址转经纬；经纬转地址。然后就去看了业界巨头——百度、腾讯的做法。不过踩了点坑，这里记录已做查阅。

腾讯那边的文档按照官网的去实现即可，百度那边的花了3个多小时左右才发现自己的问题所在，有点费时费脑，差点都想放弃了。可能也是因为被网友们各种带偏了，不过他们也给我提供的思路。

踩坑的点

1. 没找到SK。点击【设置】按钮就可以看到了，而不是官网说得"点击下面那排星号，显示Security Key"。
2. 官网Web服务API#地理编码API的版本跟SN计算里面的版本不一样，一个是v3一个是v2，有点混淆了。经过试验，其版本跟着你调用的URL走的，即你的URL是v3就用v3.
3. 下面这句话不理解，直接复制粘贴，导致出错了。即拼接上的是你的目标URL，而不是文章中示例的"/geocoder/v2/?"。为我的愚蠢，不爱动脑筋干杯[滑稽表情]。

对paramsStr前面拼接上/geocoder/v2/?，后面直接拼接yoursk得到/geocoder/v2/?address=%E7%99%BE%E5%BA%A6%E5%A4%A7%E5%8E%A6&output=json&ak=yourakyoursk

package cn.com.test;

/**
 * @author 01406242
 * @date 2022/6/27 10:14
 * @description
 **/

import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.serializer.SerializerFeature;
import org.apache.commons.codec.digest.DigestUtils;
import org.bouncycastle.pqc.math.linearalgebra.ByteUtils;

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Map.Entry;

//java版计算signature签名
public class SnCal {
    
    public static void main(String[] args) throws UnsupportedEncodingException, NoSuchAlgorithmException {
    
    //输入"青秀山"，找到对应的经纬度，即URL是
    //https://api.map.baidu.com/geocoding/v3/?address={address}&output=json&ak={ak}
        String address = "青秀山";
        String output = "json";
        String ak = "{ak}";
        String urlPrefix = "/geocoding/v3/?";
        String sk = "{sk}";

        Map<String, Object> parameterMap = new HashMap<>(16);
        parameterMap.put("address", address);
        parameterMap.put("output", output);
        parameterMap.put("ak", ak);
        parameterMap.put("urlPrefix", urlPrefix);
        parameterMap.put("sk", sk);

        Map<String, Object> resultMap = getSnAndEncodeAddress(parameterMap);
        System.out.println(JSONObject.toJSONString(resultMap, SerializerFeature.PrettyFormat));
        //resultMap里面返回的
        //1 SN需要拼接到URL上
        //2 address是经过编码后的地址，也是要放到URL上
        //最终的URL是https://api.map.baidu.com/geocoding/v3/?address=%E9%9D%92%E7%A7%80%E5%B1%B1&output=json&ak={ak}&sn={sn}
    }

    private static Map<String, Object> getSnAndEncodeAddress(Map<String, Object> parameterMap) throws UnsupportedEncodingException {
    
        SnCal snCal = new SnCal();

        // 计算sn跟参数对出现顺序有关，get请求请使用LinkedHashMap保存<key,value>，该方法根据key的插入顺序排序；post请使用TreeMap保存<key,value>，该方法会自动将key按照字母a-z顺序排序。所以get请求可自定义参数顺序（sn参数必须在最后）发送请求，但是post请求必须按照字母a-z顺序填充body（sn参数必须在最后）。
        // 以get请求为例：http://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak，paramsMap中先放入address，再放output，然后放ak，放入顺序必须跟get请求中对应参数的出现顺序保持一致。
        //https://api.map.baidu.com/geocoding/v3/?address=百度大厦&output=json&ak=vYNxK0xRk5rOjSTwE7OybUUG4XpU3LAu&sn=dc5bcf5629337c243f7ea310ea02e71d
        Map paramsMap = new LinkedHashMap<String, String>();
        paramsMap.put("address", parameterMap.get("address"));
        paramsMap.put("output", parameterMap.get("output"));
        paramsMap.put("ak", parameterMap.get("ak"));

        // 调用下面的toQueryString方法，对LinkedHashMap内所有value作utf8编码，拼接返回结果address=%E7%99%BE%E5%BA%A6%E5%A4%A7%E5%8E%A6&output=json&ak=yourak
        String paramsStr = snCal.toQueryString(paramsMap);
        // 对paramsStr前面拼接上/geocoder/v2/?，后面直接拼接yoursk得到/geocoder/v2/?address=%E7%99%BE%E5%BA%A6%E5%A4%A7%E5%8E%A6&output=json&ak=yourakyoursk
        String wholeStr = new String(parameterMap.get("urlPrefix") + paramsStr + parameterMap.get("sk"));

        // 对上面wholeStr再作utf8编码
        String tempStr = URLEncoder.encode(wholeStr, "UTF-8");

        // 调用下面的MD5方法得到最后的sn签名7de5a22212ffaa9e326444c75a58f9a0
        Map<String, Object> resultMap = new HashMap<>(16);
        resultMap.put("sn", snCal.MD5(tempStr));
        resultMap.put("address", URLEncoder.encode((String) parameterMap.get("address"), "UTF-8"));
        return resultMap;
    }


    // 对Map内所有value作utf8编码，拼接返回结果
    public String toQueryString(Map<?, ?> data)
            throws UnsupportedEncodingException {
    
        StringBuffer queryString = new StringBuffer();
        for (Entry<?, ?> pair : data.entrySet()) {
    
            queryString.append(pair.getKey() + "=");
            queryString.append(URLEncoder.encode((String) pair.getValue(),
                    "UTF-8") + "&");
        }
        if (queryString.length() > 0) {
    
            queryString.deleteCharAt(queryString.length() - 1);
        }
        return queryString.toString();
    }

    // 来自stackoverflow的MD5计算方法，调用了MessageDigest库函数，并把byte数组结果转换成16进制
    public String MD5(String md5) {
    
        try {
    
            java.security.MessageDigest md = java.security.MessageDigest
                    .getInstance("MD5");
            byte[] array = md.digest(md5.getBytes());
            StringBuffer sb = new StringBuffer();
            for (int i = 0; i < array.length; ++i) {
    
                sb.append(Integer.toHexString((array[i] & 0xFF) | 0x100)
                        .substring(1, 3));
            }
            return sb.toString();
        } catch (java.security.NoSuchAlgorithmException e) {
    
        }
        return null;
    }
}

参考

百度地址服务的额度说明
百度地图服务API（正逆地址解析）
腾讯地址服务的额度说明
腾讯地址解析（地址转坐标）