告别手动查找！如何使用GeocodioPHP库高效实现地址地理编码与逆地理编码

<code class="bash">composer require geocodio/geocodio-library-php</code>

<pre class="brush:php;toolbar:false;">use Geocodio\Geocodio;

$geocoder = new Geocodio\Geocodio();
$geocoder->setApiKey('YOUR_API_KEY'); // 设置你的API Key

$response = $geocoder->geocode('1109 N Highland St, Arlington, VA');
dump($response);
/*
输出示例：
array:2 [
  "input" => array:2 [...] // 输入地址的解析结果
  "results" => array:1 [
    0 => array:6 [
      "address_components" => array:10 [...] // 详细地址组成部分
      "formatted_address" => "1109 N Highland St, Arlington, VA 22201"
      "location" => array:2 [
        "lat" => 38.886672
        "lng" => -77.094735 // 目标经纬度
      ]
      "accuracy" => 1
      "accuracy_type" => "rooftop" // 精准度类型，rooftop 表示屋顶级精度
      "source" => "Arlington"
    ]
  ]
]
*/

<pre class="brush:php;toolbar:false;">$response = $geocoder->reverse('38.9002898,-76.9990361');
// 或者传入数组形式的坐标
$response = $geocoder->reverse([38.9002898, -76.9990361]);
dump($response);
// 输出结构与正向地理编码类似，但 input 和 results 的内容会是反向解析的地址信息。

<pre class="brush:php;toolbar:false;">$response = $geocoder->geocode([
    '1109 N Highland St, Arlington VA',
    '525 University Ave, Toronto, ON, Canada',
    '4410 S Highway 17 92, Casselberry FL'
]);

// 批量逆向地理编码
$response = $geocoder->reverse([
    '35.9746000,-77.9658000',
    '32.8793700,-96.6303900'
]);

// 你甚至可以为每个查询提供一个自定义的键，以便在结果中识别
$response = $geocoder->geocode([
    'OrderA123' => '1109 N Highland St, Arlington VA',
    'StoreB456' => '525 University Ave, Toronto, ON, Canada',
]);

<pre class="brush:php;toolbar:false;">$response = $geocoder->geocode(
    '1109 N Highland St, Arlington VA',
    ['cd', 'timezone'] // 请求国会选区和时区信息
);
dump($response);
// 结果中会包含一个 "fields" 键，其中有你请求的额外数据。

<pre class="brush:php;toolbar:false;">use Geocodio\GeocodeDirection;

// 从文件上传列表
$response = $geocoder->uploadList(
    file: 'path/to/your_addresses.csv',
    direction: GeocodeDirection::Forward, // 正向地理编码
    format: '{{B}} {{C}} {{D}} {{E}}', // 你的CSV文件格式，例如 B列是街道，C列是城市等
    callbackWebhook: 'https://example.com/callbacks/list-upload', // 处理完成后回调
);

// 查看列表处理状态
$status = $geocoder->listStatus($response['id']);

// 下载处理完成的列表
$geocoder->downloadList($response['id'], 'path/to/geocoded_results.csv');