Java 实现百度地图 SN 权限签名及搜索接口调用

其生成算法如下图：

在下一节 Java 中应用详细进行代码调用实例。

二、在 Java 中的应用

本节将以地点搜索为例，重点讲解如何在 Java 中使用 SN 签名的生成及具体调用，通过实例展示，让大家掌握实际的项目开发过程。

1、请求 Map 参数化

这里以地点搜索接口为例，首先定义一个数据请求参数 Map，代码如下：

Map<String, String> params = new LinkedHashMap<String, String>(); // 美食餐饮 -- 543c03f1792d66df98709b45b009d67b String query = "邮政"; String region = "158";// 158 表示长沙市 String scope = "2"; String output = "json"; String ret_coordtype = "WGS84"; int pageSize = 20; int pageNum = 0; params.put("query", query); params.put("region", region); params.put("output", output); params.put("scope", scope); params.put("ret_coordtype", ret_coordtype); params.put("page_size", String.valueOf(pageSize)); params.put("page_num", String.valueOf(pageNum)); params.put("ak", AK);

这个 Map 是生成 SN 签名的基础，在后续的认证过程中会持续用到。

2、SN 签名生成

对于 Java 开发者来说，掌握正确的 SN 权限签名方法，不仅可以确保应用能够稳定地调用百度地图服务，还能避免因签名错误导致的频繁接口调用失败，从而提升开发效率和用户体验。为了在接口请求中对中文的字符进行转义，因此要求我们首先进行统一编码，将 map 拼接成请求字符串，核心方法如下：

// 对 Map 内所有 value 作 utf8 编码，拼接返回结果 public String toQueryString(Map<?, ?> data) throws UnsupportedEncodingException { StringBuffer queryString = new StringBuffer(); for (Map.Entry<?, ?> pair : data.entrySet()) { queryString.append(pair.getKey() + "="); // 第一种方式使用的 jdk 自带的转码方式 第二种方式使用的 spring 的转码方法 两种均可 // queryString.append(URLEncoder.encode((String) pair.getValue(), // "UTF-8").replace("+", "%20") + "&"); queryString.append(UriUtils.encode((String) pair.getValue(), "UTF-8") + "&"); } if (queryString.length() > 0) { queryString.deleteCharAt(queryString.length() - 1); } return queryString.toString(); }

然后拼接请求接口前缀和带上 SK 值，sk 值就是在前面创建应用时获取到的信息。拼接方法较简单，代码如下：

// 对 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("/place/v2/search?" + paramsStr + SK); System.out.println(wholeStr); // 对上面 wholeStr 再作 utf8 编码 String tempStr = URLEncoder.encode(wholeStr, "UTF-8");

最后对调用 MD5 加密生成 SN 值，调用及生成核心方法如下：

// 调用下面的 MD5 方法得到最后的 sn 签名 String sn = snCal.MD5(tempStr); System.out.println("sn===>" + sn); 

生成 MD5 的方法很多，这里分享一种比较简单方法，如下：

// 来自 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; }

3、搜索接口调用

为了演示实际的搜索方法，这里创建最原生的 Java 请求对象来进行发送网络请求，使用原生的方式创建请求对象及发送请求的核心代码如下：

/** * 选择了 ak，使用 SN 校验：根据您选择的 AK 已为您生成调用代码 检测您当前的 AK 设置了 sn 检验，本示例中已为您生成 sn 计算代码 *
* @param strUrl
* @param param
* @throws Exception */ public void requestGetSN(String strUrl, Map<String, String> param) throws Exception { if (strUrl == null || strUrl.length() <= 0 || param == null || param.size() <= 0) { return; } StringBuffer queryString = new StringBuffer(); queryString.append(strUrl); for (Map.Entry<?, ?> pair : param.entrySet()) { queryString.append(pair.getKey() + "="); // 第一种方式使用的 jdk 自带的转码方式 第二种方式使用的 spring 的转码方法 两种均可 // queryString.append(URLEncoder.encode((String) pair.getValue(), // "UTF-8").replace("+", "%20") + "&"); queryString.append(UriUtils.encode((String) pair.getValue(), "UTF-8") + "&"); } if (queryString.length() > 0) { queryString.deleteCharAt(queryString.length() - 1); } java.net.URL url = new URL(queryString.toString()); URLConnection httpConnection = (HttpURLConnection) url.openConnection(); httpConnection.connect(); InputStreamReader isr = new InputStreamReader(httpConnection.getInputStream()); BufferedReader reader = new BufferedReader(isr); StringBuffer buffer = new StringBuffer(); String line; while ((line = reader.readLine()) != null) { buffer.append(line); } reader.close(); isr.close(); System.out.println("SN: " + buffer.toString()); }

在 Main 方法中调用 SN 签名生成以及实际调用的代码如下，首先需要替换您的应用 ak 和 sk 的值，方可运行。

package com.yelang.project.unihttp; import org.springframework.web.util.UriUtils; import java.io.BufferedReader; import java.io.InputStreamReader; import java.io.UnsupportedEncodingException; import java.net.HttpURLConnection; import java.net.URL; import java.net.URLConnection; import java.net.URLEncoder; import java.security.NoSuchAlgorithmException; import java.util.LinkedHashMap; import java.util.Map; public class SearchHttpSN { public static String AK = "yourak"; public static String SK = "yoursk"; public static String URL = "https://api.map.baidu.com/place/v2/search?"; public static void main(String[] args) throws Exception { SearchHttpSN snCal = new SearchHttpSN(); Map<String, String> params = new LinkedHashMap<String, String>(); String query = "邮政"; String region = "158";// 158 表示长沙市 String scope = "2"; String output = "json"; String ret_coordtype = "WGS84"; int pageSize = 20; int pageNum = 0; params.put("query", query); params.put("region", region); params.put("output", output); params.put("scope", scope); params.put("ret_coordtype", ret_coordtype); params.put("page_size", String.valueOf(pageSize)); params.put("page_num", String.valueOf(pageNum)); params.put("ak", AK); params.put("sn", snCal.caculateSn()); snCal.requestGetSN(URL, params); } }

执行完成后，在控制台看到以下输出表示成功发起了请求，并且返回了数据，表示通过了 SN 验证并且返回了指定数据：

三、APP SN 校验失败可能的原因

在实际开发过程中，Java 开发者在进行百度地图 SN 权限签名时往往会面临诸多挑战。一方面，签名算法本身涉及多个参数的处理和特定的加密规则，稍有不慎就可能导致签名错误；另一方面，不同类型的百度地图 API 接口可能对签名参数的要求存在差异，这进一步增加了开发的复杂性。此外，随着百度地图服务的不断更新和升级，签名相关的规则和要求也可能发生变化，这就要求开发者必须及时跟进和掌握最新的签名规范，以确保应用的持续稳定运行。出现问题的原因可能有以下两个问题，即字符编码问题和参数顺序问题。

1、字符编码问题

API 请求中需要用到中文或一些特殊字符的参数，如 query、region 等，为了避免提交到后台乱码，需要对这几个参数值进行编码处理，转换成 UTF-8 字符的二字符十六进制值，凡是不在下表中的字符都需要进行编码。

如果中文参数中使用 URL 保留字字符的字面意思，例如：region 关键字取值为"?北京"，检索关键字包含一个问号，此问号也必须进行编码。在上面的内容，我们使用 UTF-8 进行转义，因此很好的避免了由于字符编码问题引起的问题。

2、参数顺序

另一个容易出现的问题就是参数的顺序问题，比如我们随意调整请求参数的顺序，计算出来的 SN 值为：sn==>0d5e1ea029c398ed47ef8cb8a0847eaf，未替换之前的 SN 值为：ba424c6d1f2661e30bcc88a364ee8c6e，此时就会出现：SN: {"status":211,"message":"APP SN 校验失败"}。所以如果碰到 SN 签名不通过的问题，首先应该查看参数的顺序，因为 SN 的签名算法很简单，就是按顺序计算 MD5，因此顺序的改变一定会导致 MD5 值的变化，从而导致服务端加密时不匹配，从而导致请求失败。

3、timestamp 的设置

官方文档中，timestamp 字段在设置了 sn 签名时要求必填，但是在实测过程中，并没有传递该参数，也不影响实际的请求，可能这是官方隐藏的彩蛋吧。

四、总结

以上就是本文的主要内容，本文将深入探讨 Java 开发者如何高效、准确地搞定百度地图 SN 权限签名实践，旨在为广大 Java 开发者提供一份清晰、实用的指南，帮助大家顺利跨越这一技术门槛，更好地利用百度地图的强大功能为自己的应用赋能。通过本文的深入讲解和实践指导，期望每一位 Java 开发者都能对百度地图 SN 权限签名有清晰、准确的认识和掌握，并能够将其熟练应用于实际开发项目中。无论你是初入职场的 Java 开发新手，还是经验丰富的资深开发者，本文都将为你提供有价值的参考和借鉴，帮助你在百度地图应用开发的道路上更加顺畅地前行。