图新位置共享
帮助中心 · v1.0

位置共享使用手册

所有常见问题、操作步骤、离线部署说明都在这里。帮助内容随产品更新,无需重启应用即可生效。

返回控制台

遇到问题?先在这里搜索

创建房间 邀请成员 实时位置 导出 KML 启停 / 删除 套餐 离线部署

创建和管理房间

点击控制台右上角的 新建房间 或卡片网格末尾的 + 新建房间 入口,输入房间名称(不超过 30 字符)即可。系统会自动生成 Room ID(格式 RM-A001)和加入秘钥,创建完成后会立即弹出分享面板。

Room ID 由系统生成(字母 + 序号 + 3 位随机码),创建后不可修改,确保跨房间唯一。房间名称可以修改且允许同名。

当前套餐用量超过 80% 时,顶部用量胶囊会变橙色;达到 100% 时变红,并阻止新建。可选择删除暂不使用的房间,或前往 套餐管理 升级。

成员加入方式

两种方式:

1. 扫码加入:点击房间卡片的 加入 按钮,把弹出的 180×180 二维码贴在工作群或现场打印,外业 APP 扫码即加入。

2. 秘钥加入:复制 Base64 秘钥(包含服务器 URL、房间名、GUID)通过文字消息发送,外业 APP 粘贴即加入,适合远程分发。

秘钥末段含房间 GUID,APP 端校验时使用 GUID 而非名称,所以同名房间不会串号。Web 端列表也会显示 Room ID 帮助区分。

查看成员位置

默认每 5 秒轮询一次。Web 端不会重置你当前的视野(不会重新 fitBounds),只平滑迁移标记的位置。轮询失败 3 次后才显示 "数据更新中断" 提示。

右侧成员清单中悬停成员行,地图会自动平移并弹出该成员的信息窗(含经纬度、海拔、最后上报时间);点击则保持信息窗常驻,再次点击或点地图空白处关闭。

颜色按成员加入顺序循环分配(共 8 色),仅用于区分个体,与状态无关。在线成员外圈带绿色呼吸光环(pulse),离线成员显示为灰色实心点、无光环。

启用 / 禁用 / 删除

不会。禁用后服务端拒绝新坐标上报,且新成员无法加入,但所有历史轨迹、成员清单都保留,可以正常查看与导出。可随时重新启用。

不可恢复。删除会清除房间、成员列表和所有轨迹,所以删除前必须二次确认。建议先 导出 KML 留底,再删除。

导出 KML 轨迹

标准 KML:包含房间名称、Room ID、完整轨迹线(LineString),每个轨迹点带经纬度、海拔、时间戳、速度。可直接在 Google Earth、QGIS、ArcGIS 中打开。

系统自动分批请求并显示进度(如 "12,340 / 24,680"),前端合并后再触发下载,避免单次请求过载。

套餐说明

核心区别在房间数、每房间成员上限、历史轨迹保留时长、API 接入与支持等级。完整对比见 套餐管理页

不会立即丢失。超出配额的房间进入只读状态(可查看、可导出),并有 30 天宽限期供升级或导出。宽限期后才停止接收新位置上报。

离线部署

面向政府、军工、涉密、内网等不能连互联网的场景。Web 静态资源、地图瓦片、服务端都内置在一个文件中,启动即提供页面服务,无需外网依赖。

许可文件绑定机器硬件指纹(不可拷贝)。首次启动自动生成 30 天临时许可,过期后历史数据仍可查看、导出,但不再接收新坐标。续期请联系商务。

最低 4 GB RAM,推荐 8 GB+。系统支持 Windows 10/11 x64 或 Windows Server 2016+。性能指标:1,000 QPS、P99 200ms(十万级轨迹)。

常见故障

Web 端使用浏览器 Navigator.onLine + 心跳双重检测。断网时地图和列表保留最近一次成功获取的数据;网络恢复后 Banner 自动消失,并立即触发一次刷新。

通常发生在套餐降级 / 过期,且原房间数超出新配额。系统会自动把超额房间标记为 "只读",并提示 30 天宽限期。前往 套餐管理 续费即可恢复。

桌面客户端发起的免登 Token 有效期仅 5 分钟。如超时,请回到客户端重新发起跳转;URL 中的 Token 是一次性的,请勿手动转发链接。

没找到想要的答案?