如何使用PHP对接百度智能车载ATP接口进行车辆数据上传与查询

gitbox 2025-06-12

什么是百度智能车载ATP接口

ATP（Automotive Telematics Platform）是一个车载电子服务平台，旨在为汽车提供全面的智能车联网服务。百度智能车载ATP接口通过API技术实现车辆数据与互联网的连接，提供实时数据上传、车辆状态查询及数据存储等功能，帮助开发者集成智能车载服务。

准备工作

在开始使用百度智能车载ATP接口前，需要在百度AI控制台创建汽车云账户、应用和API Key。创建完成后，请妥善保存获取的App ID、API Key和Secret Key。

安装PHP SDK包

使用百度智能车载ATP接口的PHP SDK包可以通过composer进行安装。composer是PHP的依赖管理工具，能够帮助管理项目中的第三方库。

确保已经安装了composer工具，然后使用以下命令安装PHP SDK包：

composer require baidu/carlife-php-sdk

实现车辆数据上传

获取到App ID、API Key和Secret Key后，即可使用百度智能车载ATP提供的API接口进行车辆数据上传。以下是上传车辆数据的具体步骤：

1. 准备数据

在上传车辆数据之前，必须按照ATP接口规范将数据整理为JSON格式。数据格式参考如下：


$data = array(
    "carId" => "TEST001",  // 车辆编号
    "time" => time(),  // 数据产生时间
    "gps" => array(
        "longitude" => "116.403408",  // 经度
        "latitude" => "39.923201",   // 纬度
        "satellite" => 12,  // 卫星数
        "speed" => 60  // 车速
    ),
    "obd" => array(
        "vehicle_speed" => 50,  // 车辆速度
        "engine_speed" => 3000,  // 引擎转速
        "coolant_temp" => 50,  // 冷却液温度
        "air_flow_rate" => 100,  // 空气流量
        "throttle_position" => 50,  // 节气门位置
        "intake_air_temp" => 30,  // 进气温度
        "mileage" => 100  // 行驶里程
    )
);

以上数据是上传车辆数据的典型格式，可根据实际情况修改。

2. 生成Token

为了进行身份验证，上传数据时需要生成Token。使用App ID和Secret Key生成Token：


$appid = "YOUR_APPID_HERE";
$secret_key = "YOUR_APP_SECRET_KEY_HERE";
$token = \Baidu\CarLife\Token::getToken($appid, $secret_key);

3. 使用API接口上传数据

上传数据时，使用ATP提供的API接口，调用PHP SDK的`sendData`方法进行数据传输：


$client = new \Baidu\CarLife\Client($app_key, $secret_key, $token);
$client->sendData($data, "ATP_DEMO");

此时，`sendData`方法接收两个参数：上传的数据`$data`和车辆编号`ATP_DEMO`。

实现车辆状态查询

ATP接口还提供了查询车辆状态的功能，允许实时监控和查询车辆状态。以下是实现查询功能的步骤：

1. 准备查询数据

查询车辆状态时，需要提供车辆编号。查询请求的数据格式如下：


$data = array(
    "carId" => "TEST001",  // 车辆编号
    "time" => time()  // 查询时间
);

此数据格式为查询车辆状态的标准格式，需根据实际情况进行修改。

2. 生成Token

查询车辆状态时，同样需要使用App ID和Secret Key生成Token：


$appid = "YOUR_APPID_HERE";
$secret_key = "YOUR_APP_SECRET_KEY_HERE";
$token = \Baidu\CarLife\Token::getToken($appid, $secret_key);

3. 使用API接口查询数据

查询车辆状态时，使用ATP提供的API接口，调用PHP SDK的`getVehicleStatus`方法：


$client = new \Baidu\CarLife\Client($app_key, $secret_key, $token);
$result = $client->getVehicleStatus($data);

`getVehicleStatus`方法接收查询数据`$data`作为参数。

总结

本文介绍了如何使用PHP对接百度智能车载ATP接口，涵盖了准备工作、数据上传及状态查询等操作。通过使用百度提供的PHP SDK包，开发者可以轻松实现与ATP接口的集成，为车辆提供智能化的数据服务。