DotWalk

DotWalk 是一个基于微信原生小程序与云开发实现的个人足迹地图项目，面向“记录、回顾、统计个人旅行轨迹”的使用场景。

功能特性

• 主地图长按落点、地级市搜索定位
• 足迹记录新增、编辑、删除
• 足迹列表筛选与地图联动
• 静态中国填色图谱
• 足迹统计、照片展示、最长旅行计算
• 数据导出 JSON、剪贴板导入、示例数据导入

技术栈

• 微信原生小程序
• JavaScript / WXML / WXSS
• 微信云开发（云数据库、云存储、云函数）
• 腾讯地图 API
• Canvas 静态地图渲染

目录结构

cloudfunctions/         云函数
miniprogram/            小程序前端
  components/           业务组件
  pages/                页面
  services/             网络/媒体服务
  utils/                工具函数
project.config.json     小程序工程配置

本地运行前准备

1. 小程序前端私有配置

复制文件：

miniprogram/constants/private.example.js

为：

miniprogram/constants/private.js

并填写：

module.exports = {
  cloudEnvId: '你的云环境 ID',
  tencentMapKey: '你的腾讯地图 Key',
}

2. 云函数私有配置

复制文件：

cloudfunctions/resolveRegion/secrets.example.js

为：

cloudfunctions/resolveRegion/secrets.js

并填写：

module.exports = {
  TENCENT_MAP_KEY: '你的腾讯地图 Key',
  TENCENT_MAP_SK: '你的腾讯地图 SK',
}

也可以改为使用云函数环境变量，不建议把真实密钥直接提交到仓库。

云开发依赖

请在微信云开发中创建以下集合：

• marks
• illuminations
• user_profiles

并部署以下云函数：

• resolveRegion
• exportUserData
• importUserData
• getStatsSnapshot

上传到微信开发者工具

1. 使用微信开发者工具导入项目根目录
2. 填写小程序 AppID
3. 配置云开发环境
4. 上传并部署云函数
5. 真机测试地图定位、图谱展示、导入导出

当前版本说明

• 国内版为当前主版本
• 国际版暂为“开发中”占位
• 图谱页采用静态中国填色地图，不提供缩放拖拽

注意事项

• 本项目仓库中的配置均为示例占位，不包含真实云环境与地图密钥
• 导入备份为覆盖导入，操作前建议先导出当前数据
• 图谱颜色来源仅认现存足迹记录，删除记录后会同步熄灭