ArchiMap 项目说明

1. 项目概述

ArchiMap 是一个专注于建筑文化遗产展示的交互式地图应用，旨在通过数字化手段呈现全球建筑地标，促进建筑文化的传播与交流。

项目名称： Archimap|建筑地图
访问地址： https://archmap.cn | https://archimap.cc
技术栈： Mapbox GL JS + PHP + MySQL + jQuery

2. 核心功能

2.1 现代建筑地图

• 功能特点：
  • 从数据库动态加载现代建筑点位
  • 自定义标记样式（蓝色背景 + 建筑图标）
  • 详细的弹窗信息展示
  • 侧边菜单加载不同类型建筑数据
  • 右下角数据统计功能
  • 搜索功能

2.2 古代建筑地图

• 功能特点：
  • 从数据库动态加载古代建筑点位
  • 自定义标记样式（红色背景 + 地标图标）
  • 详细的弹窗信息展示
  • 侧边菜单加载不同类型建筑数据
  • 右下角数据统计功能
  • 搜索功能（开发中）

2.3 GeoJSON 导入工具

• 功能特点：
  • 支持上传 GeoJSON 文件
  • 实时预览导入的点位
  • 选择保存到现代建筑或古代建筑地图
  • 详细的导入结果反馈
  • 错误处理和调试信息

2.4 侧边菜单

• 菜单项：
  • 古建 · 遗迹 - 加载历史建筑数据
  • 现代建筑 - 加载现代建筑数据
  • Artdeco Shanghai - 加载老建筑数据
  • 条状 - 链接到 cityline.html 页面

3. 技术实现

3.1 前端技术

• Mapbox GL JS： 用于交互式地图渲染和点位展示
• jQuery： 用于 DOM 操作和异步请求
• Font Awesome： 提供图标支持
• 响应式设计： 适配不同屏幕尺寸

3.2 后端技术

• PHP PDO： 用于数据库连接和操作
• MySQL： 存储建筑数据
• API 设计： RESTful 风格的 API 接口
• 错误处理： 完善的错误捕获和提示机制

4. 系统特性

4.1 数据管理

• 自动表创建： 如果数据库表不存在，API 会自动创建并插入示例数据
• 数据验证： 确保必填字段存在，提供默认值
• 批量导入： 支持通过 GeoJSON 文件批量导入数据
• 数据统计： 实时显示加载的建筑点位数量

4.2 用户体验

• 流畅的地图交互： 支持缩放、平移等操作
• 直观的弹窗信息： 展示建筑详细信息，包括图片、地址、建筑师等
• 响应式布局： 适配不同设备屏幕
• 加载状态提示： 显示数据加载进度和结果
• 错误提示： 友好的错误信息展示

4.3 安全与性能

• 输入验证： 防止恶意输入
• 错误处理： 完善的异常捕获机制
• 数据缓存： 优化数据加载性能
• API 限流： 防止过度请求

5. 使用说明

5.1 访问地图页面

1. 打开对应的地图页面
2. 使用侧边菜单加载不同类型的建筑数据
3. 点击地图上的标记，查看建筑详细信息
4. 使用搜索框查找特定建筑
5. 按照分类标签🏷️查找特定建筑（开发中……）

5.2 导入 GeoJSON 数据

1. 点击 “选择 GeoJSON 文件” 按钮，选择要导入的文件
2. 点击 “加载到地图” 按钮，预览导入的点位
3. 在 “保存到地图” 下拉菜单中选择目标地图
4. 点击 “保存到数据库” 按钮，完成导入

6. 未来规划

1. 搜索功能完善： 实现基于建筑名称、地址、建筑师的搜索
2. 用户系统： 添加用户注册、登录和个人收藏功能
3. 评论系统： 允许用户对建筑进行评论和评分
4. 多语言支持： 添加英文等其他语言版本
5. 移动应用： 开发配套的移动应用
6. 数据可视化： 添加建筑分布统计和可视化图表
7. AR 功能： 实现基于位置的增强现实展示

7. 技术支持

• Mapbox 文档： https://docs.mapbox.com/
• PHP PDO 文档： https://www.php.net/manual/en/book.pdo.php
• GeoJSON 规范： https://geojson.org/

8. 项目总结

ArchiMap 项目通过数字化手段，为用户提供了一个直观、互动的建筑文化遗产展示平台。系统采用现代化的技术栈，实现了建筑数据的高效管理和展示，为建筑文化的传播与交流做出了贡献。

未来，项目将继续完善功能，拓展数据覆盖范围，为用户提供更加丰富、全面的建筑文化体验。

Archimap 点位添加系统操作文档

一、文档概述

1.1 文档目的

本文档详细说明 Archimap 点位添加系统（addpoint）的功能、操作流程及注意事项，帮助用户快速掌握点位添加、编辑、导入等核心操作，同时明确管理员专属功能的使用方式。

1.2 系统功能

二、前置准备

2.1 登录要求

• 所有操作需先完成账号登录（未登录时系统自动展示登录弹窗）；

• 登录账号为网站统一账号，管理员账号额外拥有「审核点位」权限。

2.2 环境要求

• 浏览器：推荐 Chrome、Firefox 最新版本；

• 网络：需正常访问 Mapbox 服务；

• 文件：导入点位时需准备符合规范的 .geojson 文件（可下载示例文件参考格式）。

三、核心操作流程

3.1 登录/登出操作

3.1.1 登录

1. 访问 addpoint 页面，未登录状态下自动弹出操作说明及登录面板；

2. 在登录表单中输入「用户名」和「密码」，点击「登录」按钮；

3. 登录成功后：

   • 普通用户：关闭登录弹窗，进入地图操作界面；

   • 管理员：界面额外显示「审核点位」按钮；

   • 登录失败：根据提示修正（如「用户不存在」「密码错误」等）。

3.1.2 登出

1. 已登录状态下，在页面操作说明弹窗的「登录信息」区域点击「退出登录」；

2. 系统自动销毁登录状态，跳转回未登录的 addpoint 页面。

3.2 点位基础操作

3.2.1 添加新点位

1. 点击页面控制面板中的「增加点标记」按钮，激活添加模式；

2. 将鼠标移至地图目标位置（页面左上角实时显示当前坐标），点击鼠标左键生成点位标记；

3. 弹出「添加点标记」模态框，填写必填/选填信息：

   • 必填项：点位名称（*）；

   • 选填项：点位描述、建筑师、建造年代、详情链接（URL 格式）、图片（支持所有图片格式）；

   • 图片上传后可在「image-preview」区域查看预览；

4. 点击「保存」按钮，完成点位添加（数据自动保存，刷新页面不丢失）。

3.2.2 编辑已有点位

1. 点击地图上已存在的点位标记，弹出「编辑点标记」模态框；

2. 修改需要更新的字段（如点位名称、描述、图片等）；

3. 如需删除该点位，点击模态框中的「删除」按钮（仅编辑模式显示）；

4. 点击「保存」按钮生效修改，或点击「取消」放弃编辑。

3.2.3 清空所有点位

1. 点击控制面板中的「清空所有」按钮（红色警示样式）；

2. 确认操作后，地图上所有点位标记及对应数据将被清除（操作不可逆，需谨慎）。

3.3 地图设置操作

3.3.1 全屏切换

点击控制面板中的「全屏」按钮，地图将切换至全屏模式；再次点击或按 ESC 键退出全屏。

3.3.2 地图风格切换

1. 点击控制面板中的「选择风格」按钮，展开风格下拉菜单；

2. 选择目标风格：

   • 浅色风格：简洁浅色底图，突出点位标记；

   • 暗色风格：深色底图，适合低光环境；

   • 街道风格：显示道路、建筑等基础地理信息；

   • 卫星风格：卫星影像底图，还原真实地理环境；

3. 选择后地图将自动加载并切换为对应风格。

3.4 批量导入点位

1. 点击控制面板中的「导入文件」按钮，弹出本地文件选择窗口；

2. 选择本地的 .geojson 或 .json 文件（仅支持该格式）；

3. 系统自动解析文件并在地图上渲染所有点位（解析失败将提示格式错误）；

4. 若需参考文件格式，可点击「示例文件」链接下载 eg01.geojson 参考。

3.5 管理员专属操作

1. 管理员账号登录后，控制面板将显示「审核点位」按钮；

2. 点击该按钮，系统跳转至点位审核页面，进行点位审核操作（审核页面操作见专属文档）。

四、操作提示与注意事项

4.1 操作提示

• 点位添加/编辑后数据自动保存，无需手动提交；

• 鼠标悬停在「导入文件」按钮上，可查看文件格式提示；

• 点击点位标记后，支持「拖拽调整位置」「回车快速保存」「点击弹窗背景关闭模态框」等快捷操作；

• 操作过程中可随时关闭「操作说明」弹窗（点击右上角 × 按钮），再次需要时可刷新页面重新调出。

4.2 注意事项

1. 图片上传需确保文件大小适中（建议单张 ≤5MB），避免加载缓慢；

2. 详情链接需填写完整 URL（如 https://xxx.com），否则可能无法正常跳转；

3. GeoJSON 文件导入前需检查格式规范，避免因字段缺失导致解析失败；

4. 「清空所有」操作不可逆，执行前请确认无需保留现有点位数据；

5. 管理员退出登录后，「审核点位」按钮将自动隐藏，需重新登录管理员账号方可使用。

五、常见问题排查

路线绘制工具（citydraw.html）操作说明

一、工具概述

本工具基于 Mapbox 地图引擎开发，支持在地图上交互式绘制自定义路线，可配置路线样式（线型、颜色、线宽等），自动计算路线长度，并支持 GeoJSON/GPX/KML 多格式导出/导入路线数据，适用于城市路线规划、户外轨迹绘制等场景。

二、操作步骤

（一）基础准备

1. 打开 citydraw.html，等待页面加载完成后，会自动显示地图界面和左侧控制栏；

2. 控制栏默认展开，可通过顶部“折叠/展开”开关（圆形滑块）切换显示状态。

（二）路线绘制

1. 命名路线（可选）：在“路线名称”输入框中填写自定义名称（如“城市滨江步道”），方便后续识别；

2. 启动绘制：点击「开始绘制」按钮，鼠标指针移至地图区域，点击鼠标左键添加点位，连续点击可绘制连续路线；

   • 绘制过程中，「撤销上一点」「重新绘制」「清空所有」「保存路线」按钮自动激活；

   • 页面实时显示“已添加点位数量”和“路线总长度（公里）”，长度随点位添加自动计算更新。

（三）路线样式配置

可在绘制前/绘制中/绘制完成后调整样式，修改后地图上的路线会实时刷新：

1. 路径线型：默认选中“虚线”，可点击“实线”单选框切换为实线样式；

2. 路径颜色：点击颜色预览块（默认#FF6F61），在弹出的颜色选择器中选择自定义颜色，右侧会同步显示对应的十六进制色值；

3. 线宽调整：拖动“线宽”滑块（范围1~5px），右侧数值实时显示当前线宽，地图路线宽度同步变化；

4. 虚线间隔（仅虚线生效）：拖动“虚线间隔”滑块（范围1~5px），右侧数值实时显示当前间隔，地图虚线样式同步变化。

（四）绘制操作调整

1. 撤销上一点：点击「撤销上一点」按钮，可删除最后添加的一个点位，路线长度和点位数量自动更新；

2. 重新绘制：点击「重新绘制」按钮，清空当前绘制的所有点位，可重新开始绘制新路线；

3. 清空所有：点击「清空所有」按钮，删除当前所有绘制内容（包括路线、点位），恢复初始状态。

（五）路线数据导出

1. 绘制完成后，确认「保存路线」按钮已激活；

2. 点击下拉选择框，选择导出格式（默认 GeoJSON，可选 GPX/KML）；

3. 点击「保存路线」按钮，浏览器自动下载对应格式的路线文件，文件名称关联填写的“路线名称”（未填写则为默认名称）。

（六）路线数据导入

仅支持导入 GeoJSON 格式的路线文件：

1. 点击「加载 GeoJSON」按钮，弹出文件选择窗口；

2. 选择本地已保存的 GeoJSON 格式路线文件，点击“确认”；

3. 地图自动加载并显示该路线，控制栏同步显示路线的点位数量和总长度，可在此基础上调整样式或重新编辑。

三、注意事项

1. 绘制时需连续点击地图添加点位，单次点击仅添加一个点位，双击不会自动结束绘制；

2. 撤销操作仅支持“从后往前”逐点撤销，无法撤销已导出的路线数据；

3. 导入功能仅兼容标准 GeoJSON 格式的路线文件，非该格式文件可能加载失败；

4. 若页面加载后地图未显示，需检查网络连接（依赖 Mapbox 在线资源）。

分享绘制好的路线的方法

绘制好的路线分享方法

你可以通过文件分享和在线链接（进阶） 两种方式分享绘制好的路线，以下是具体操作步骤，适配你当前的工具功能：

一、基础方式：导出文件后分享（最直接）

这是适配你现有工具的核心分享方式，操作简单且兼容性强：

1. 导出路线文件：按照操作说明完成路线绘制后，在工具中选择导出格式（推荐 GeoJSON 通用格式，或根据对方需求选 GPX/KML），点击「保存路线」下载文件到本地；

   • ✅ 格式适配场景：

     • GeoJSON：适合开发者/其他地图工具（如 QGIS、Mapbox）使用；

     • GPX：适合户外导航设备（如佳明手表）、徒步/骑行类APP（如行者、两步路）；

     • KML：适合谷歌地球（Google Earth）、高德/百度地图导入。

2. 分享文件：将下载的文件通过微信、QQ、邮箱、网盘（百度网盘/阿里云盘）等方式发送给需要分享的人；

3. 对方使用：接收方在你的路线绘制工具中点击「加载 GeoJSON」（若导入 GPX/KML，需额外适配，见下方补充），选择收到的文件即可在地图上查看完整路线，还能调整样式。

二、进阶方式：生成在线分享链接

若想实现“点击链接直接查看路线”（无需对方下载文件），可基于现有工具扩展，步骤如下：

1. 分享操作

1. 绘制完成后，工具新增「生成分享链接」按钮，点击后自动上传当前路线文件到服务器，并生成链接；

2. 复制该链接分享给他人，对方打开链接即可在浏览器中直接查看路线（无需下载工具/文件）。

三、补充：让接收方快速查看路线的小技巧

1. 若对方没有你的绘制工具，可推荐免费在线查看工具：

   • GeoJSON/KML：使用 GeoJSON.io（在线打开文件，直接显示地图路线）；

   • GPX：使用 GPX Viewer（专门解析GPX轨迹）；

2. 分享时可附带简单说明：“文件格式为XXX，用XX工具打开即可查看路线”，降低对方操作成本。

总结

1. 基础分享：通过工具导出 GeoJSON/GPX/KML 文件，直接发送给对方，对方用你的工具导入即可查看；

2. 进阶分享：开发文件上传+链接生成功能，实现“一键分享链接，免下载查看”；

3. 兼容提示：优先推荐导出 GeoJSON 格式，适配绝大多数地图工具，分享兼容性最高。

怎样打入官方？

— 建筑地图官方加入指南

所有热爱建筑地图并加入会员的伙伴们，为了方便沟通，增强社区粘度，我们把会员统一称为“小麦” 啦！ ～

小麦们看过来！经常有小伙伴问，怎么才能加入建筑地图官方团队，和我们一起解锁各地建筑之美、玩转地图与旅行？今天就用最接地气的话，把加入攻略说清楚，门槛不高，但诚意一定要足哦～

首先，核心门槛就4个，主打一个“双向奔赴”：一是热爱地图，喜欢研究点位、梳理路线，哪怕是对着一张地图就能琢磨半天，这份热忱最珍贵；二是热爱旅游，愿意走出家门，去探访不同城市的古建筑、特色建筑，不畏惧奔波，享受发现的快乐；三是热爱摄影，能用镜头捕捉建筑的细节与韵味，不管是专业设备还是手机，愿意用心记录、分享美好就好；最后也是最重要的，乐于奉献，愿意花时间整理点位、分享攻略、协助运营，和大家一起共建更棒的建筑地图。

其实很多已经加入我们的小麦，和大家一样都是普通人，全靠热爱和付出脱颖而出～ 比如@BEAR，本职是建筑师，却痴迷地图和建筑摄影，周末总背着相机打卡各地老建筑，经常在小红书上发布建筑打卡攻略，还有亲手整理的本地古建筑点位笔记，加入后每周都会更新点位攻略，协助我们完善地图内容，现在已经成为官方核心运营成员；还有@胖丁，喜欢小众旅行，擅长用手机记录建筑之美，在小红书和小宇博客上分享自己走过的30+座城市的建筑旅行路线，加入后主动组织线上线下打卡活动，带动大家一起挖掘小众建筑点位，用热情感染了很多小伙伴，就像那些长期深耕地图共建的爱好者一样，用坚持和付出实现了自己的价值。

加入步骤超简单，3步就能搞定！第一步，找到建筑地图官方报名入口，填写个人基础信息，重点说说你和地图、旅游、摄影的小故事，不用华丽辞藻，真诚就好；第二步，附上你的“小证明”，比如拍过的建筑美照、整理的旅行路线图，或是自己做的建筑点位笔记，让我们快速get你的优势；第三步，耐心等待通知，我们会认真查看每一份申请，符合要求的小麦，很快就能收到入群邀请，解锁官方专属身份。

加入之后，我们一起并肩前行：挖掘小众建筑点位、打磨优质地图内容、组织线上线下打卡活动，既能解锁专属福利，又能认识一群志同道合的小麦。

没有复杂的要求，只要你满含热爱、乐于付出，建筑地图官方的大门就永远为你敞开！快来加入我们，用热爱点亮每一处建筑，用行动共建专属我们的建筑地图吧～