必须配置Web服务API Key并启用SSL验证，封装AmapClient处理GCJ-02坐标与鉴权，地理编码结果需经纠偏转WGS84方可用于GIS分析。
要在Yii2.0.48项目中稳定调用高德地图LBS服务（如地理编码、逆地理编码、POI搜索），必须绕过框架默认的HTTP客户端限制，正确处理高德要求的GCJ-02坐标系与鉴权参数传递逻辑。
配置高德API Key与基础参数
在config/params.php中新增高德配置项，避免硬编码泄露：
【key必须为Web服务API类型】——高德开放平台创建应用时，务必勾选「Web服务API」，否则请求将返回INVALID_USER_KEY错误；JS API Key不可用于后端HTTP调用。
添加以下内容：
'amap' => [ 'key' => 'your_web_service_api_key_here', 'base_url' => 'https://restapi.amap.com/v3/', ]
封装高德HTTP客户端
新建components/AmapClient.php，继承yii\httpclient\Client并强制启用SSL验证与超时控制：
这一步不能跳过：高德v5.0+已全面禁用HTTP明文请求，未启用enableSSLVerification = true会导致cURL error 35或空响应。
类中定义sendRequest()方法，自动拼接key参数并处理400/403/500级错误码，对infocode != 10000的情况抛出AmapException异常。
实现地理编码（地址→坐标）
在models/GeoCoder.php中编写方法：
第一步：接收原始中文地址字符串，例如"北京市朝阳区建国路87号"；
第二步：调用AmapClient::sendRequest('geocode/geo', ['address' => $address, 'city' => $city])；
高德地图 API 调用工具，返回原始 JSON 数据。Use when users ask about 天气、地址、坐标、周边、路线、导航、打车、行程 in China. Commands: weather, geo, regeo, search, around, detail, route, distance,...
第三步：解析返回JSON，提取geocodes[0].location字段（格式为"116.434307,39.90909"），【该坐标为GCJ-02火星坐标系，不可直接用于GPS设备或WGS84底图】；
第四步：若业务需WGS84坐标，必须额外调用自定义转换函数（见下节），严禁直接使用高德返回值做GIS分析。
GCJ-02转WGS84坐标纠偏
方法一：使用开源PHP库overtrue/geotools（推荐）
执行composer require overtrue/geotools，在转换方法中调用Geotools::gcj02ToWgs84($lng, $lat)；
方法二：手写纠偏函数（仅限测试环境）
直接复制GitHub上经大量实测验证的PHP版gcj02towgs84()函数，注意输入顺序为(lng, lat)，输出为[wgs84_lng, wgs84_lat]；
【切勿在生产环境使用未校准的手写算法】——高德2024年Q2起加密扰动策略升级，旧版纠偏公式误差可能达80米以上。
注册组件并注入容器
在config/web.php的components数组中注册：
'amapClient' => [ 'class' => 'app\components\AmapClient', 'transport' => 'yii\httpclient\CurlTransport', ],
在任意控制器中通过Yii::$app->amapClient即可调用，例如：
$result = Yii::$app->amapClient->sendRequest('geocode/geo', [...]);
