TeslaMate项目官方API使用指南：Fleet API与Telemetry API详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00256/article/details/148465762

TeslaMate项目官方API使用指南：Fleet API与Telemetry API详解

teslamate teslamate-org/teslamate: TeslaMate 是一个开源项目，用于收集特斯拉电动汽车的实时数据，并存储在数据库中以便进一步分析和可视化。该项目支持监控车辆状态、行驶里程、充电详情等信息。项目地址: https://gitcode.com/gh_mirrors/te/teslamate

前言

TeslaMate作为一款优秀的特斯拉车辆数据记录与分析工具，其核心功能依赖于特斯拉提供的API接口。随着特斯拉官方API策略的调整，用户需要了解不同API的使用场景和限制。本文将深入解析TeslaMate项目中涉及的两种官方API：Fleet API和Telemetry API，帮助用户做出正确选择。

官方API类型与适用场景

1. 传统Owner API与新版Fleet API对比

传统上，TeslaMate使用非官方的Owner API和流式传输接口。而现在特斯拉提供了两套官方API替代方案：

Fleet API：替代原有的Owner API
Telemetry API：替代原有的流式传输接口

2. 用户类型与API选择

根据用户账户类型不同，API使用策略也有所区别：

企业车队用户

必须迁移至Fleet API，因为Owner API将逐步关闭
迁移时间取决于特斯拉的升级计划
当出现API错误时，表明必须使用新版API

个人用户

目前仍可继续使用Owner API
建议保持现状，直到Owner API完全关闭

新版API的限制与影响

Fleet API的主要限制

数据获取频率受限：
- 车辆数据(vehicle_data)获取频率有严格限制
- 命令发送次数受限
- 历史记录分辨率低于Owner API
功能完整性：
- 虽然API设计更全面，但某些功能可能受限
- 预计未来这些限制也会应用到Owner API

Telemetry API的差异

数据传输机制：
- 使用消息队列而非WebSocket
- 默认发送至特斯拉指定端点
数据频率：
- 最低每分钟发送一次数据
- 远低于原有流式传输的秒级更新

第三方服务提供商方案

对于希望简化配置的用户，可以考虑以下第三方服务：

MyTeslaMate方案(免费)

Fleet API配置步骤

使用特斯拉账户登录MyTeslaMate网站
获取专属TOKEN
配置环境变量：

- TOKEN=?token=您的专属TOKEN
- TESLA_API_HOST=https://api.myteslamate.com
- TESLA_AUTH_HOST=https://api.myteslamate.com
- TESLA_AUTH_PATH=/api/oauth2/v3

流式传输配置

在Fleet页面配对车辆
添加流式传输环境变量：

- TESLA_WSS_HOST=wss://streaming.myteslamate.com
- TESLA_WSS_TLS_ACCEPT_INVALID_CERTS=true
- TESLA_WSS_USE_VIN=true

重启TeslaMate实例

Teslemetry方案(付费)

Fleet API配置

创建Teslemetry账户并获取TOKEN
配置环境变量：

- TOKEN=?token=您的专属TOKEN
- TESLA_API_HOST=https://api.teslemetry.com
- TESLA_AUTH_HOST=https://api.teslemetry.com
- TESLA_AUTH_PATH=/api/oauth2/v3

注意：Teslemetry不提供流式传输服务，需在TeslaMate设置中手动禁用。

直接使用官方API方案(高级)

前置要求

具备IT基础设施管理能力
拥有公网可访问的服务器
申请特斯拉开发者账户和免费Fleet API计划

Fleet API配置指南

在特斯拉开发者平台创建第三方账户
根据所在区域配置API_HOST：
- 北美/亚太(除中国)：https://fleet-api.prd.na.vn.cloud.tesla.com
- 欧洲/中东/非洲：https://fleet-api.prd.eu.vn.cloud.tesla.com
- 中国：https://fleet-api.prd.cn.vn.cloud.tesla.cn
完整环境变量配置：

- TESLA_API_HOST=对应区域URL
- TESLA_AUTH_HOST=https://auth.tesla.com
- TESLA_AUTH_PATH=/oauth2/v3
- TESLA_AUTH_CLIENT_ID=您的应用客户端ID

从Owner API迁移到Fleet API

在TeslaMate设置页面登出当前Owner API
完成上述Fleet API配置
重启Docker实例使更改生效
正确配置后，TeslaMate将自动使用新的客户端ID登录

自建Telemetry流式传输方案

部署Tesla Fleet Telemetry实例
配置Google PubSub分发器
部署流式传输服务器
创建PubSub订阅指向您的流式传输服务器
更新环境变量：

- TESLA_WSS_HOST=wss://您的流式传输域名
- TESLA_WSS_TLS_ACCEPT_INVALID_CERTS=true
- TESLA_WSS_USE_VIN=true

重启实例

总结与建议

企业用户应立即迁移至Fleet API方案
个人用户可暂缓迁移，继续使用Owner API
根据技术能力选择第三方服务或自建方案
流式传输配置较为复杂，需谨慎操作
定期关注特斯拉API政策变化，及时调整配置

通过本文的详细指南，希望TeslaMate用户能够顺利完成API的迁移和配置工作，确保车辆数据记录的连续性。对于技术细节仍有疑问的用户，建议寻求专业技术支持或选择可靠的第三方服务方案。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考