PHP 使用高德接口获取地理编码和逆地理编码

产品介绍

地理编码/逆地理编码 API 是通过 HTTP/HTTPS 协议访问远程服务的接口，提供结构化地址与经纬度之间的相互转化的能力。

适用场景

地理编码：将详细的结构化地址转换为高德经纬度坐标。且支持对地标性名胜景区、建筑物名称解析为高德经纬度坐标。结构化地址举例：北京市朝阳区阜通东大街6号转换后经纬度：116.480881,39.989410 地标性建筑举例：天安门转换后经纬度：116.397499,39.908722
逆地理编码：将经纬度转换为详细结构化的地址，且返回附近周边的POI、AOI信息。例如：116.480881,39.989410 转换地址描述后：北京市朝阳区阜通东大街6号
使用说明

第一步，申请Web服务API类型Key；

第二步，参考接口参数文档发起HTTP/HTTPS请求，第一步申请的 Key 需作为必填参数一同发送；

第三步，接收请求返回的数据（JSON或XML格式），参考返回参数文档解析数据。

如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。

以上内容来自高德开放平台地理逆地理编码

基础配置

项目需要使用请求高德接口，因此选择来使用 guzzle/guzzle 来作为 http client

composer require guzzlehttp/guzzle

获取地理编码

use GuzzleHttp\Client;

public function getGeo($address, $city, $batch = false, $format = 'json')
{
    $url = 'https://restapi.amap.com/v3/geocode/geo';
    if (!\in_array(\strtolower($format), ['xml', 'json'])) {
        return 'Invalid response format: '.$format;
    }
    $query = array_filter([
        'key' => $this->key,
        'address' => $address,
        'city' => $city,
        'batch' => $batch,
        'output' => $format,
    ]);
    try {
        $client = new Client();
        $response = $client->get($url, [
            'query' => $query,
        ])->getBody()->getContents();
        return 'json' === $format ? \json_decode($response, true) : $response;
    } catch (\Exception $e) {
        return $e->getCode();
    }
}

具体参数请参考地理/逆地理编码

获取逆地理编码

use GuzzleHttp\Client;

public function getRegeo($location, $poitype, $radius = 1000, $type = 'all', $batch = false, $roadlevel = 0, $format = 'json')
{
    $url = 'https://restapi.amap.com/v3/geocode/regeo';
    if (!\in_array(\strtolower($format), ['xml', 'json'])) {
        return 'Invalid response format: '.$format;
    }
    $radius = intval($radius);
    if ($radius < 0 || $radius > 3000) {
        return 'Invalid radius value(0~3000): '.$radius;
    }
    $query = array_filter([
        'key' => $this->key,
        'location' => $location,
        'poitype' => $poitype,
        'radius' => $radius,
        'extensions' => $type,
        'batch' => $batch,
        'roadlevel' => $roadlevel,
        'output' => $format,
    ]);
    try {
        $client = new Client();
        $response = $client->get($url, [
            'query' => $query,
        ])->getBody()->getContents();
        return 'json' === $format ? \json_decode($response, true) : $response;
    } catch (\Exception $e) {
        return $e->getCode(;
    }
}

具体参数请参考地理/逆地理编码