如何解决PHP应用中的地址定位难题？GeocoderOpenCageProvider助你轻松实现地理编码！

<code class="bash">composer require geocoder-php/open-cage-provider geocoder-php/php-geocoder php-http/guzzle7-adapter</code>

<pre class="brush:php;toolbar:false;"><?php

require 'vendor/autoload.php';

use Geocoder\Query\GeocodeQuery;
use Geocoder\Provider\OpenCage\OpenCage;
use Http\Adapter\Guzzle7\Client as GuzzleAdapter; // 使用Guzzle 7作为HTTP客户端

// 1. 创建HTTP客户端实例
$httpClient = new GuzzleAdapter();

// 2. 使用你的OpenCage API Key创建OpenCage Provider实例
// 你可以在 OpenCage 官网注册并获取 API Key: https://opencagedata.com/
$provider = new OpenCage($httpClient, 'YOUR_OPENCAGE_API_KEY');

// 3. 执行地理编码查询
$addressToGeocode = '1600 Amphitheatre Parkway, Mountain View, CA, USA';
try {
    $results = $provider->geocodeQuery(GeocodeQuery::create($addressToGeocode));

    if ($results->count() > 0) {
        $firstResult = $results->first();
        $latitude = $firstResult->getCoordinates()->getLatitude();
        $longitude = $firstResult->getCoordinates()->getLongitude();

        echo "地址: " . $addressToGeocode . "\n";
        echo "经度: " . $longitude . "\n";
        echo "纬度: " . $latitude . "\n";

        // 你还可以获取更多信息，比如国家、城市、邮编等
        echo "国家: " . $firstResult->getCountry()->getName() . "\n";
        echo "城市: " . $firstResult->getLocality() . "\n";
    } else {
        echo "未找到该地址的地理编码结果。\n";
    }
} catch (\Exception $e) {
    echo "地理编码失败: " . $e->getMessage() . "\n";
}

echo "\n--- 反向地理编码示例 ---\n";

// 反向地理编码（将经纬度转换为地址）
$latitude = 37.4224764;
$longitude = -122.0842499;
try {
    $reverseResults = $provider->reverseQuery(GeocodeQuery::createFromCoordinates($latitude, $longitude));

    if ($reverseResults->count() > 0) {
        $firstReverseResult = $reverseResults->first();
        echo "坐标 (" . $latitude . ", " . $longitude . ") 对应的地址是: " . $firstReverseResult->getFormattedAddress() . "\n";
    } else {
        echo "未找到该坐标的反向地理编码结果。\n";
    }
} catch (\Exception $e) {
    echo "反向地理编码失败: " . $e->getMessage() . "\n";
}