高德鹰眼支持批量导入终端设备：先下载并按规范填写UTF-8无BOM的CSV模板，上传后解析校验，再批量启用设备，最后通过轨迹查询验证ID一致性和数据同步有效性。
如果您需要在高德鹰眼轨迹管理平台中一次性注册并管理大量终端设备（如车载定位器、移动终端等），手动逐条添加将耗费大量时间。以下是实现设备数据批量导入的具体操作步骤：
一、准备标准格式的设备信息CSV文件
批量导入依赖结构化数据文件，系统仅识别符合字段规范的CSV文件，缺失或错位字段将导致整行记录被跳过。必须确保文件编码为UTF-8，且不含BOM头。
1、访问高德开放平台鹰眼控制台，进入「终端管理」页面。
2、点击「批量导入」旁的「下载模板」按钮，获取官方标准CSV模板。
3、使用Excel或文本编辑器打开模板，在“device_id”列填写每个设备的唯一标识（如IMEI、MAC地址或自定义ID）；“name”列为设备显示名称；“desc”列可选填备注说明。
4、保存文件时选择「CSV（逗号分隔）」格式，并确认编码为UTF-8无BOM。
二、上传CSV文件并触发后台解析
上传过程由平台自动校验基础格式与必填字段完整性，不支持实时预览或单行修正，需确保文件一次性达标。
1、在「终端管理」页面点击「批量导入」按钮，弹出文件选择窗口。
2、选中已准备好的UTF-8编码CSV文件，点击「确定」开始上传。
3、上传完成后，系统显示「解析中」状态，等待约10–30秒，随后列出成功解析的行数及失败原因摘要（如device_id重复、字段为空等）。
4、若存在失败记录，需根据提示修改原文件后重新上传，不可在界面内编辑。
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
三、确认设备绑定并启用在线状态
成功导入仅完成设备元数据注册，设备实际在线并上报位置需满足硬件端已配置对应服务地址与认证参数，否则仍显示“离线”。
1、导入完成后，返回「终端列表」页，勾选全部新设备，点击「批量启用」。
2、在弹出的确认框中，检查「启用状态」开关为开启，点击「确定」提交。
3、设备上线后，其「最后上报时间」字段将从“-”变为具体时间戳，且状态图标由灰色转为绿色。
4、若持续显示离线，请核查设备端是否已设置正确的鹰眼服务域名（如track.amap.com）及对应的sid与key参数。
四、验证设备数据同步有效性
导入结果需通过真实轨迹上报验证，避免因设备ID格式不一致或服务未激活导致“静默注册”——即列表可见但无数据回传。
1、选取一台已导入设备，启动其定位上报功能（如运行SDK示例程序或开启车载终端）。
2、在鹰眼控制台「轨迹查询」页面，选择该设备ID，设置时间范围为最近5分钟。
3、点击「查询」，若返回有效轨迹点列表（含经纬度、时间、速度字段），则表明设备已成功接入并同步数据。
4、关键提示：设备ID必须与上报SDK中init()方法传入的device_id完全一致，大小写敏感，不可含空格或特殊符号。
