附录1：编码说明

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

字符集合

字符

URL非保留字

a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~

URL保留字

! * ' ( ) ; : @ & = + $ , / ? % # [ ]

如果中文参数中使用URL保留字字符的字面意思，例如，检索关键字包含一个问号，此问号也必须进行编码。附注：

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

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

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

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

附录2：sn计算算法

假设ak=yourak(yourak为一个字符串)，

在 API控制台 中配置了该ak的验证方式是sn签名的验证方式，点击下面那排星号，显示Security Key，可以看到此ak对应的sk私钥，假设sk=yoursk。

请求的url是：

http://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak&sn=7de5a22212ffaa9e326444c75a58f9a0

后面的sn就是要计算的，sk不需要在url里出现，但是在计算sn的时候需要sk(假设sk=yoursk)

下面提供java、PHP、C#、python 2.7的参考代码。

java参考代码如下：

package test;

import java.io.UnsupportedEncodingException;

import java.net.URLEncoder;

import java.security.NoSuchAlgorithmException;

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 {

SnCal snCal = new SnCal();

// 计算sn跟参数对出现顺序有关，get请求请使用LinkedHashMap保存，该方法根据key的插入顺序排序；post请使用TreeMap保存，该方法会自动将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请求中对应参数的出现顺序保持一致。

Map paramsMap = new LinkedHashMap();

paramsMap.put("address", "百度大厦");

paramsMap.put("output", "json");

paramsMap.put("ak", "yourak");

// 调用下面的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("/geocoder/v2/?" + paramsStr + "yoursk");

// 对上面wholeStr再作utf8编码

String tempStr = URLEncoder.encode(wholeStr, "UTF-8");

// 调用下面的MD5方法得到最后的sn签名7de5a22212ffaa9e326444c75a58f9a0

System.out.println(snCal.MD5(tempStr));

}

// 对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;

}

}

PHP参考代码如下：

//API控制台申请得到的ak(此处ak值仅供验证参考使用)

$ak = 'yourak';

//应用类型为for server, 请求校验方式为sn校验方式时，系统会自动生成sk，可以在应用配置-设置中选择Security Key显示进行查看(此处sk值仅供验证参考使用)

$sk = 'yoursk';

//以Geocoding服务为例，地理编码的请求url，参数待填

$url = "http://api.map.baidu.com/geocoder/v2/?address=%s&output=%s&ak=%s&sn=%s";

//get请求uri前缀

$uri = '/geocoder/v2/';

//地理编码的请求中address参数

$address = '百度大厦';

//地理编码的请求output参数

$output = 'json';

//构造请求串数组

$querystring_arrays = array (

'address' => $address,

'output' => $output,

'ak' => $ak

);

//调用sn计算函数，默认get请求

$sn = caculateAKSN($ak, $sk, $uri, $querystring_arrays);

//请求参数中有中文、特殊字符等需要进行urlencode，确保请求串与sn对应

$target = sprintf($url, urlencode($address), $output, $ak, $sn);

//输出计算得到的sn

echo "sn: $sn \n";

//输出完整请求的url(仅供参考验证，故不能正常访问服务)

echo "url: $target \n";

?>

其中，caculateAKSN的定义如下：

function caculateAKSN($ak, $sk, $url, $querystring_arrays, $method = 'GET')

{

if ($method === 'POST'){

ksort($querystring_arrays);

}

$querystring = http_build_query($querystring_arrays);

return md5(urlencode($url.'?'.$querystring.$sk));

}

C#参考代码如下：

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

public class AKSNCaculater

{

private static string MD5(string password)

{

byte[] textBytes = System.Text.Encoding.UTF8.GetBytes(password);

try

{

System.Security.Cryptography.MD5CryptoServiceProvider cryptHandler;

cryptHandler = new System.Security.Cryptography.MD5CryptoServiceProvider();

byte[] hash = cryptHandler.ComputeHash(textBytes);

string ret = "";

foreach (byte a in hash)

{

ret += a.ToString("x");

}

return ret;

}

catch

{

throw;

}

}

private static string UrlEncode(string str)

{

str = System.Web.HttpUtility.UrlEncode(str);

byte[] buf = Encoding.ASCII.GetBytes(str);//等同于Encoding.ASCII.GetBytes(str)

for (int i = 0; i < buf.Length; i++)

if (buf[i] == '%')

{

if (buf[i + 1] >= 'a') buf[i + 1] -= 32;

if (buf[i + 2] >= 'a') buf[i + 2] -= 32;

i += 2;

}

return Encoding.ASCII.GetString(buf);//同上，等同于Encoding.ASCII.GetString(buf)

}

private static string HttpBuildQuery(IDictionary querystring_arrays)

{

StringBuilder sb = new StringBuilder();

foreach (var item in querystring_arrays)

{

sb.Append(UrlEncode(item.Key));

sb.Append("=");

sb.Append(UrlEncode(item.Value));

sb.Append("&");

}

sb.Remove(sb.Length - 1, 1);

return sb.ToString();

}

public static string CaculateAKSN(string ak, string sk, string url, IDictionary querystring_arrays)

{

var queryString = HttpBuildQuery(querystring_arrays);

var str = UrlEncode(url + "?" + queryString + sk);

return MD5(str);

}

}

python 2.7参考代码如下：

# -*- coding: utf-8 -*-

# 第一行必须有，否则报中文字符非ascii码错误

import urllib

import hashlib

# 以get请求为例http://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak

queryStr = '/geocoder/v2/?address=百度大厦&output=json&ak=yourak'

# 对queryStr进行转码，safe内的保留字符不转换

encodedStr = urllib.quote(queryStr, safe="/:=&?#+!$,;'@()*[]")

# 在最后直接追加上yoursk

rawStr = encodedStr + 'yoursk'

# md5计算出的sn值7de5a22212ffaa9e326444c75a58f9a0

# 最终合法请求url是http://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak&sn=7de5a22212ffaa9e326444c75a58f9a0

print hashlib.md5(urllib.quote_plus(rawStr)).hexdigest()