百度开放平台-地理编码服务

 地理编码服务

地理编码服务（又名Geocoder）是一类Web API接口服务；
正地理编码服务提供将结构化地址数据（如：北京市海淀区上地十街十号）转换为对应坐标点（经纬度）功能；
地理编码服务当前未推出国际化服务，解析地址仅限国内；

功能介绍

地理编码服务

用户可通过该功能，将结构化地址（省/市/区/街道/门牌号）解析为对应的位置坐标。地址结构越完整，地址内容越准确，解析的坐标精度越高。

URL：http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding

以下是开发的代码，主要调取 getMap(); 方法：

<?php

/**
 * 百度地图-根据详细地址获取经纬度
 * 文档URL:http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding
 *
 * @since 20190117
 */
class Baidu_geocoderLib
{
    /**
     * 访问应用（AK）
     * API控制台申请得到的ak
     */
    const REQ_AK = '写你的AK'; 

    /**
     * 请求校验方式为sn校验方式时，系统会自动生成sk
     * 可以在应用配置-设置中选择Security Key显示进行查看
     * 文档URL:http://lbsyun.baidu.com/index.php?title=webapi/appendix
     */
    const SECURITY_KEY = '写你的SK';

    /**
     * 请求地址，GET
     * @var string
     * ?address=北京市海淀区上地十街10号&output=json&ak=您的ak&callback=showLocation //GET请求
     */
    const REQ_URL = 'http://api.map.baidu.com/geocoder/v2/';
    const REQ_URI = '/geocoder/v2/';

    /**
     * 错误信息
     * @var string|array
     */
    private $errMsg = null;

    /**
     * 是否使用sn签名的验证方式
     * @var bool
     */
    private $isSn = false;

    /**
     * sk码
     * @var null|string
     */
    private $sk = self::SECURITY_KEY;

    /**
     * 请求参数，默认值
     * @var array
     */
    private $reqParam = array(
        'address' => '', // 待解析的地址，最多支持84个字节，（必须）
        'output' => 'json', // 输出格式为json或者xml
        'ak' => self::REQ_AK, // 用户申请注册的key，（必须）
        'callback' => '', // 将json格式的返回值通过callback函数返回以实现jsonp功能，（我们不需要）
        'city' => '', // 地址所在的城市名
        'ret_coordtype' => 'gcj02ll', // 添加后返回国测局经纬度坐标或百度米制坐标，（gcj02ll:国测局坐标、bd09mc:百度墨卡托坐标）
        'sn' => '', // 若用户所用ak的校验方式为sn校验时该参数必须
    );

    public function __construct()
    {
    }

    /**
     * 重置所有请求参数
     * @param array $config 请求参数
     * @param bool $isSn 是否使用sn校验
     * @param string $sk
     */
    public function setReqParam($config, $isSn = false, $sk = null)
    {
        if (is_array($config) && !empty($config)) {
            foreach ($config as $key => $val) {
                !empty($val) && $this->reqParam[$key] = $val;
            }
        }

        if ($isSn) {
            $this->isSn = true;
            !empty($sk) && $this->sk = $sk;
        }
    }

    /**
     * 获取经纬度信息
     * @param null|string $address 详细地址
     * @param null|string $city 详细地址所属城市名，有利于精确返回信息
     * @return bool|mixed 经纬度坐标：[... "location":{"lat":"纬度值","lng":"经度值"} ...]
     */
    public function getMap($address = null, $city = null)
    {
        // 设置地址信息
        !empty($address) && $this->reqParam['address'] = $address;
        !empty($city) && $this->reqParam['city'] = $city;

        if ($this->isSn) {
            // 调用sn计算函数，默认get请求
            $queryStringArrays = $this->reqParam;
            unset($queryStringArrays['sn']);
            $this->reqParam['sn'] = self::caculateAKSN($this->reqParam['ak'], $this->sk, self::REQ_URI, $queryStringArrays);
        }

        // 请求数据
        $data = $this->send(self::REQ_URL, $this->reqParam);

        // 处理请求数据
        $data = str_replace('renderOption&&renderOption(', '', $data);
        $data = str_replace(')', '', $data);
        $data = json_decode($data, true);

        // 返回数据
        if (!empty($data)) {
            if ($data['status'] == 0) {
                return $data;
            } else {
                $this->errMsg = $data;
            }
        } else {
            $this->errMsg = '请求出错了';
        }
        return false;
    }

    /**
     * 返回错误信息
     * @return array|string
     */
    public function errMsg()
    {
        return $this->errMsg;
    }

    /**
     * 发送请求
     * @param $url
     * @param $params
     * @return mixed
     */
    private function send($url, $params = null)
    {
        if (!empty($params)) {
            if (is_array($params)) {
                $paramStr = '';

                foreach ($params as $k => $val) {

                    // 请求参数中有中文、特殊字符等需要进行urlencode，确保请求串与sn对应
                    if ($this->isSn && $k != 'sn') {
                        if (preg_match('/[\x{4e00}-\x{9fa5}]/u', $val) > 0) {
                            $val = urlencode($val);
                        }
                    }
                    $paramStr .= "{$k}={$val}&";
                }
                $paramStr = rtrim($paramStr,'&');
            } else {
                $paramStr = $params;
            }
            $url .= (strpos($url, "?") === false ? '?' : '&');
            $url .= $paramStr;
        }

        // 记录一下url
        $this->errMsg = $url;

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_HEADER, 0);
        curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']);
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

        // 执行并获取HTML文档内容
        $result = curl_exec($ch);

        // 释放curl句柄
        curl_close($ch);

        return $result;
    }

    /**
     * sn计算函数，默认get请求
     * 百度地图提供
     * 文档URL:http://lbsyun.baidu.com/index.php?title=webapi/appendix
     * @param $ak
     * @param $sk
     * @param $url
     * @param $querystring_arrays
     * @param string $method
     * @return string
     */
    private static 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));
    }
}

相关参数说明看文档：http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding