Laravel 9中如何通过TomTom将地址转坐标并存储到数据库？

一、准备工作 #

• 注册TomTom开发者账号，获取有效的API Key
• 确保Laravel项目已安装Guzzle（Laravel 9默认已集成，若缺失可执行：composer require guzzlehttp/guzzle）

二、配置API密钥 #

1. 在项目根目录的.env文件中添加TomTom配置：

TOMTOM_API_KEY=你的TomTom API密钥

2. 在config/services.php中新增TomTom服务配置：

return [
    // 其他服务配置...
    'tomtom' => [
        'api_key' => env('TOMTOM_API_KEY'),
        'geocode_url' => 'https://api.tomtom.com/search/2/geocode/{address}.json',
    ],
];

三、修正并完善地址转坐标方法 #

原代码存在URL拼接语法错误、无错误处理等问题，以下是修正后的完整实现：

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
use Illuminate\Support\Facades\Config;

public static function getCoordinatesFromAddress(string $address): array
{
    $client = new Client();
    $apiKey = Config::get('services.tomtom.api_key');
    $baseUrl = Config::get('services.tomtom.geocode_url');

    // 对地址进行URL编码并替换URL占位符
    $encodedAddress = urlencode($address);
    $url = str_replace('{address}', $encodedAddress, $baseUrl);

    try {
        $response = $client->get($url, [
            'query' => [
                'key' => $apiKey,
                'limit' => 1 // 只返回最匹配的1条结果
            ]
        ]);

        $data = json_decode($response->getBody(), true);

        // 校验返回结果的有效性
        if (empty($data['results']) || !isset($data['results'][0]['position'])) {
            throw new \Exception('未找到该地址对应的坐标信息');
        }

        $latitude = $data['results'][0]['position']['lat'];
        $longitude = $data['results'][0]['position']['lon'];

        return compact('latitude', 'longitude');
    } catch (RequestException $e) {
        // 处理HTTP请求异常（如密钥无效、请求超时、API配额耗尽等）
        throw new \Exception('TomTom API请求失败: ' . $e->getMessage());
    } catch (\Exception $e) {
        throw new \Exception($e->getMessage());
    }
}

四、调用示例 #

在控制器或业务逻辑中调用该方法：

try {
    $coordinates = YourModel::getCoordinatesFromAddress('上海市浦东新区张江高科技园区');
    // 处理坐标数据
    dd($coordinates);
} catch (\Exception $e) {
    // 处理错误信息
    dd($e->getMessage());
}

五、注意事项 #

• 确保你的TomTom API Key已开通地理编码（Geocoding）权限
• 注意TomTom API的调用配额限制，避免超出免费额度导致请求失败
• 地址参数尽量详细（如包含城市、区域、街道），可提升坐标匹配的准确率

内容的提问来源于stack exchange，提问作者aBarl