NUAA Library Flow

Crawling and visualization of human flow information in NUAA Library

图书馆人流量信息爬取与可视化

数据来自图书馆预约系统

TODO list

Under construction...

Welcome your issues and PRs!

---

从2020年10月12日起，图书馆暂停入馆预约，进入图书馆凭校园卡刷卡即可入馆。

由于无法从预约系统获取数据，本项目暂停。

20201012: This project is suspended due to the library's suspension of booking system.

---

File info

• crawler.py 图书馆预约系统爬虫 NUAA Library Flow Crawler
• flow.py 后端接口 backend API
• save_data.py 保存数据到本地 （最新数据 ./data/latest/<date>.json 及全部数据 ./data/all/<date>.json） Save data to the local storage
• .github/workflows/update_flow.yml GitHub Action 配置文件

---

Usage

For local use 本地使用

首先把代码拉到本地，安装依赖。
请注意只需要拉取 master 分支的即可。

git clone -b master --depth=1 https://github.com/miaotony/NUAA_LibraryFlow.git
cd NUAA_LibraryFlow
pip3 install -r requirements.txt

而后执行相应的程序即可，例如，想要把当前的数据保存到本地：

python3 save_data.py

运行环境：Python >= 3.6

For remote use 远程使用

目前已经基于 GitHub Action 实现了图书馆预约系统数据的定时自动爬取，并搭建了一个获取数据的接口。

API:

均为 GET 方法。

date 为日期，格式如 2020-10-07。(%Y-%m-%d)

某一天的最新数据：

https://libflow.miaotony.xyz/data/latest/date.json

某一天的全部数据：

https://libflow.miaotony.xyz/data/all/date.json

例如，获取2020年10月7日的数据，对应接口为

https://libflow.miaotony.xyz/data/latest/2020-10-07.json

https://libflow.miaotony.xyz/data/all/2020-10-07.json

Data format 数据格式：

{
  "time": "2020-10-07 01:00:11",
  "data": [
    {
      "area": "MGG4F",
      "now": "1",
      "all": "140"
    },
    {
      "area": "JJL3F",
      "now": "8",
      "all": "280"
    },
    {
      "area": "JJL6F",
      "now": "3",
      "all": "150"
    },
    {
      "area": "TMH",
      "now": "1",
      "all": "70"
    },
    {
      "area": "JJL5F",
      "now": "3",
      "all": "255"
    },
    {
      "area": "MGG2F",
      "now": "0",
      "all": "186"
    },
    {
      "area": "MGG3F",
      "now": "0",
      "all": "205"
    },
    {
      "area": "JJL2F",
      "now": "5",
      "all": "180"
    },
    {
      "area": "JJL4F",
      "now": "9",
      "all": "260"
    }
  ]
}

• time 当前时间
• area 区域名称（明故宫，将军路，天目湖）
• now 当前预约人数
• all 最大预约人数

---

Copyright

网络非法外之地，本项目相关技术内容仅供学习研究，请在合理合法范围内使用！
The relevant technical content of this project is only for study and research, please use within the reasonable and legal scope!

License:
GNU Affero General Public License v3.0

未经允许不得商用！
Non-commercial use!

最终解释权归本项目开发者所有。
The final interpretation right belongs to the developer of the project.

Copyright © 2020 MiaoTony.