# seekmapsubmit

**Repository Path**: project_study_all/submit-map-search-result

## Basic Information

- **Project Name**: seekmapsubmit
- **Description**: SeekMap——根据百度地图开放平台开发的15分钟生活圈设施分析工具
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-12
- **Last Updated**: 2026-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">SeekMap 智能空间体检</h1>
<p align="center">
  <strong>给社区做一次"体检"——15 分钟步行圈民生设施覆盖分析，一目了然</strong>
</p>
<p align="center"><img src="demo/logo.png" alt="logo" width="150"></p>

----------

## 功能概述

- **等时圈生成**：基于 OSM 路网数据， 使用坐标吸附确定中心点，结合 Dijkstra 算法计算 15 分钟步行可达范围。
- **POI 数据采集、清洗与过滤**：通过百度 Place API v2 多边形区域检索，异步并发获取 9 大类别设施（仅 15 min 范围）。UID 去重、城市边界校验、等时圈判定、名称过滤、步行距离矩阵过滤。
- **设施覆盖率评分**：多维加权评分（关键设施覆盖率、类别多样性、距离衰减覆盖率）。
- **自定义规则盲区检测**：LLM 结合用户自定义规则识别设施匮乏区域。
- **3D 可视化展示**：首页为提供搜索框的 3D 地图可视化页面，包含百度 JSAPI GL 3D 地图 + 多层等时圈 Polygon + POI 标记 + 评分图表。点击等时圈之后跳转详细分析页面，提供数据分析仪表盘：覆盖率热力图、功能区划图、行政区域划分、基尼系数分析。

## 技术栈

| 层次 | 技术                                                      |
|---|---------------------------------------------------------|
| 后端框架 | Django 5.x                                              |
| 路网数据 | OSMnx + OSM (OpenStreetMap)                             |
| 图算法 | NetworkX + heapq (Dijkstra)                             |
| 空间计算 | SciPy (KD-Tree) + Shapely + Alpha Shape                 |
| 地图服务 | 百度地图 API（Geocoding v3 / Place API v2 / Route Matrix v2） |
| 前端地图 | 百度 JSAPI GL（WebGL 2.5D，3D 建筑 + 倾斜视角）                    |
| 异常检测 | Qwen-turbo 大模型推理                                        |
| POI 缓存 | Redis（POI Hash + UID Set + 类别索引，TTL 1h）                 |
| 路网缓存 | SQLite（Django ORM，NetworkX 图序列化，TTL 7d）                 |
| 前端 | 原生 HTML/CSS/JS                                          |
| 部署 | Docker + Gunicorn                                       |
| 包管理 | uv                                                      |

## 设计文档

| 文档                                             | 内容               |
|------------------------------------------------|------------------|
| [DESIGN_Isochrone.md](DESIGN_Isochrone.md)     | 等时圈生成算法设计        |
| [DESIGN_poicleaning.md](DESIGN_poicleaning.md) | POI 数据采集、清洗与分类策略 |
| [DESIGN_analysis.md](DESIGN_analysis.md)       | 空间诊断评分算法         |
| [DESIGN_blindspotdetection.md](...)            | 盲点监测算法           |
| [DESIGN_cache.md](...)                         | 缓存策略             |
## Docker 部署

#### 配置环境变量 (.env)
- AK # 百度地图 Access Key
- BROWSER_AK # 百度地图 Browser Access Key
- BAIDU_MOCK=False        # 百度 API Mock 模式
- DJANGO_DEBUG=False      # 打印错误堆栈、SQL查询等
- DJANGO_ALLOWED_HOSTS   # 允许特定主机IP访问
- POI_MOCK=False        # POI Mock 模式
- TAIR_PRIMARY_HOST # 云数据库主节点URL
- TAIR_BACKUP_HOST # 云数据库备节点URL
- TAIR_PASSWORD # 云数据库密码
- LLM_API_KEY # 大语言模型供应商 API key
- DEV_MODE=False # 是否为开发模式

#### 生成镜像并运行
```bash
docker compose up --build
```

## LICENSE

Apache License 2.0