File size: 6,950 Bytes
d521a14
 
 
 
 
 
 
9bd155f
d521a14
 
 
 
 
 
 
 
 
9bd155f
 
 
 
 
 
d521a14
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9bd155f
 
d521a14
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
# ๋Ÿฌ๋‹ ํ™˜๊ฒฝ ์ ์ˆ˜

์ถ”์ฒœ ๊ฒฐ๊ณผ์™€ AI ์ƒ˜ํ”Œ์€ ์ ์ˆ˜๊ฐ€ ๋†’์€ ์ˆœ์œผ๋กœ ์ •๋ ฌํ•œ๋‹ค. ์›๋ž˜ ์ˆœ์„œ๋Š” ์ถ”์ฒœ ์ ์ˆ˜ ๋™๋ฅ ์—,
์ง€๋„ ์ค‘์‹ฌ๊นŒ์ง€์˜ ๊ฑฐ๋ฆฌ๋Š” ์ƒ˜ํ”Œ ์ ์ˆ˜ ๋™๋ฅ ์— ์‚ฌ์šฉํ•œ๋‹ค. ์ ์ˆ˜์™€ ์ถ”์ฒœ ์ˆœ์œ„๋Š” ๊ฒฝ๋กœ ID๋ฅผ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.

- ๋ณดํ–‰๋กœ ๊ตฌ์กฐ 25%, ์ง€์—ญ ์ธ๊ตฌ ํ˜ผ์žก๋„ 45%, ์•ฑ ํ™œ๋™ 30%. ๊ฒฝ๋กœ๋ฅผ ๊ฑฐ๋ฆฌ ๊ธฐ์ค€์œผ๋กœ ์ƒ˜ํ”Œ๋งํ•œ๋‹ค.
- ๋น„์–ด ์žˆ๋Š” ์‹ ํ˜ธ๋Š” ์ค‘๋ฆฝ๊ฐ’์ด๋ฉฐ ํ•œ์‚ฐํ•˜๋‹ค๋Š” ์ฆ๊ฑฐ๊ฐ€ ์•„๋‹ˆ๋‹ค. ์ „๋ถ€ ๋น„์–ด ์žˆ์œผ๋ฉด `์ž๋ฃŒ ๋ถ€์กฑ`.
- ํ™œ๋™ ์ง‘๊ณ„๊ฐ€ ์ •์ƒ ์‘๋‹ตํ–ˆ์„ ๋•Œ์˜ 0๋ช…์€ ์„œ๋น„์Šค ์ด์šฉ์ž ํ™œ๋™์—๋งŒ ๋ฐ˜์˜ํ•˜๋ฉฐ ์ผ๋ฐ˜ ๋ณดํ–‰ ์ธ๊ตฌ์—๋Š” ๋ฐ˜์˜ํ•˜์ง€ ์•Š๋Š”๋‹ค.
- ์‹ค์‹œ๊ฐ„ ์ธ๊ตฌ๋Š” ๊ณต์‹ POI ์˜์—ญ๊ณผ ๊ต์ฐจํ•˜๋Š” ๋ถ€๋ถ„๋งŒ ์‚ฌ์šฉํ•œ๋‹ค. ์„œ์šธ์‹œ API๊ฐ€ 20๋ถ„ ๋„˜๊ฒŒ
  ์˜ค๋ž˜๋๊ฑฐ๋‚˜, ๋Œ€์ฒด๊ฐ’์ด๊ฑฐ๋‚˜, ์‹คํŒจํ•˜๋ฉด ๋ฐ˜์˜ํ•˜์ง€ ์•Š๋Š”๋‹ค. ์‹œ๊ฐ„๋Œ€๋ณ„ ์ž๋ฃŒ๊ฐ€ ์žˆ๋Š” ๊ตฌ๊ฐ„์€ ๋ณ„๋„๋กœ ์ถ”์ •ํ•œ๋‹ค.
- ์•ฑ ํ™œ๋™์€ ์ตœ๊ทผ 2๋ถ„ ์ด๋‚ด์— ์ €์žฅ๋˜๊ณ  GPS ๊ฒฝ๋กœ๊ฐ€ ์žˆ๋Š” ์ง„ํ–‰ ์ค‘ ์‹ค์ œ ๋Ÿฌ๋‹๋งŒ ํฌํ•จํ•œ๋‹ค.
  ์‹œ๋ฎฌ๋ ˆ์ด์…˜, ์ผ์‹œ์ •์ง€, ์ข…๋ฃŒ๋Š” ์ œ์™ธํ•œ๋‹ค. ์ฃผ๋ณ€ ๊ตฌ์—ญ์— ์†Œ์ˆ˜ ์ธ์›์ด ์žˆ์œผ๋ฉด ์กด์žฌ ์—ฌ๋ถ€๋งŒ ํ‘œ์‹œํ•˜๊ณ ,
  ์ธ์›์ˆ˜๋Š” ๊ตฌ์—ญ๋‹น 3๋ช… ์ด์ƒ์ธ ์ง‘๊ณ„๋งŒ ํ•ฉ์‚ฐํ•œ๋‹ค. ๋ธŒ๋ผ์šฐ์ €์—๋Š” ์œ„์น˜๋‚˜ ๊ตฌ์—ญ ๋ชฉ๋ก์„ ๋ฐ˜ํ™˜ํ•˜์ง€ ์•Š๋Š”๋‹ค.
- ์ด ์ ์ˆ˜๋Š” ์ถ”์ฒœ ์ˆœ์œ„์šฉ์ด๋ฉฐ ํ†ตํ–‰ ๊ฐ€๋Šฅ ์—ฌ๋ถ€๋‚˜ ์•ˆ์ „์„ ์ธ์ฆํ•˜์ง€ ์•Š๋Š”๋‹ค.

## Hugging Face ๋ฐฐํฌ

GitHub์˜ `DemoService` ๋ธŒ๋žœ์น˜ ํ‘ธ์‹œ๋Š” Space ๋™๊ธฐํ™”๋ฅผ ์‹œ์ž‘ํ•œ๋‹ค. Docker ๋นŒ๋“œ๋Š” Geofabrik์˜
๋Œ€ํ•œ๋ฏผ๊ตญ OSM์—์„œ ๋„๋กœ ์ธ๋ฑ์Šค๋ฅผ ๋งŒ๋“ ๋‹ค. ๊ธฐ๋ณธ๊ฐ’์€ `/app/running-environment`์ด๋ฉฐ
`RUN_ENV_DATA_DIR`๋กœ ๋‹ค๋ฅธ ์ธ๋ฑ์Šค๋ฅผ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๋‹ค. ํ˜ผ์žก๋„ ํ”„๋กœํ•„์€ ์•”ํ˜ธํ™”๋œ ๋ฌถ์Œ์œผ๋กœ๋งŒ
๋ฐฐํฌํ•˜๋ฉฐ GitHub Secrets์˜ `RUN_ENV_PROFILE_KEY`, `RUN_ENV_SEOUL_API_KEY`๋Š” Space Secret์œผ๋กœ ์ „๋‹ฌ๋œ๋‹ค.
๋‚ด๋ถ€ ํ™œ๋™ ์ง‘๊ณ„ ํ‚ค๋Š” ์ปจํ…Œ์ด๋„ˆ ์‹œ์ž‘ ์‹œ ์ƒ์„ฑํ•˜๋ฉฐ ์ธ์ฆ ์„œ๋ฒ„์™€ Next๊ฐ€ ๊ณต์œ ํ•œ๋‹ค.
์ธ๋ฑ์Šค๋‚˜ ํ‚ค๊ฐ€ ์—†์œผ๋ฉด ํ•ด๋‹น ์‹ ํ˜ธ๋งŒ ์ž๋ฃŒ ๋ถ€์กฑ์œผ๋กœ ์ฒ˜๋ฆฌํ•œ๋‹ค.

## ๊ฐ€์ ธ์˜ค๊ธฐ

1. [๋Œ€ํ•œ๋ฏผ๊ตญ OSM PBF](https://tiles.osm.kr/download/)๋ฅผ ๋‹ค์šด๋กœ๋“œํ•œ๋‹ค.
2. [๊ตญํ† ์ •๋ณดํ”Œ๋žซํผ](https://map.ngii.go.kr/)์—์„œ ์ˆ˜์น˜์ง€ํ˜•๋„ ๋„์—ฝ์„ ๋ฐ›์•„ ํ•„์š”ํ•œ ๋ ˆ์ด์–ด๋ฅผ
   SHP ๋˜๋Š” WGS84 GeoJSON์œผ๋กœ ์ค€๋น„ํ•œ๋‹ค. `sidewalk-1000`, `sidewalk-5000`,
   `road-width`, `carriageway`์— ๊ฐ๊ฐ ๋Œ€์‘ํ•œ๋‹ค. ์•„๋ž˜ ํ•„๋“œ๋ช…์€ ์˜ˆ์‹œ๋‹ค.
   ๋„์—ฝ์˜ ์กฐ์‚ฌ์—ฐ๋„์™€ ์ด์šฉ์กฐ๊ฑด์„ ํ™•์ธํ•œ ํ›„ ๋„ฃ๊ณ , ๊ฐ™์€ ์ง€์—ญ์˜ ๊ตฌ๋ฒ„์ „๊ณผ ์‹ ๋ฒ„์ „์€ ์ค‘๋ณต ํˆฌ์ž…ํ•˜์ง€ ์•Š๋Š”๋‹ค.
3. [์„œ์šธ ์‹ค์‹œ๊ฐ„ ๋„์‹œ๋ฐ์ดํ„ฐ](https://data.seoul.go.kr/dataList/OA-21285/A/1/datasetView.do)์˜
   ์ฃผ์š” 121์žฅ์†Œ ์˜์—ญ ZIP์„ ํ’€๊ณ  SHP์˜ `AREA_CD` ํ•„๋“œ๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค.

```powershell
python -m pip install osmium geopandas
python tools/import_running_environment.py --out D:/data/run-env-v1 --osm D:/data/south-korea.osm.pbf --roads sidewalk-1000 D:/data/sidewalk.shp WIDTH SURFACE --seoul-areas D:/data/seoul-areas.shp AREA_CD
```

`--roads`๋Š” ์—ฌ๋Ÿฌ ๋ฒˆ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๊ณ  `--seoul-areas`๋„ ์„ ํƒ ์‚ฌํ•ญ์ด๋‹ค.
OSM๋งŒ ๋จผ์ € ๊ฐ€์ ธ์˜ฌ ์ˆ˜ ์žˆ๋‹ค. ์ฐจ๋„๋‚˜ ๋„๋กœ ์ „์ฒด์˜ ํญ์„ ๋ณด๋„ ํญ์œผ๋กœ ์ฝ์ง€ ์•Š๋Š”๋‹ค.
์ƒˆ ๋ฒ„์ „์„ ๋นˆ ํด๋”์— ์ƒ์„ฑํ•œ ๋’ค ๊ฒฝ๋กœ๋ฅผ ๋ฐ”๊ฟ” Next ์„œ๋ฒ„๋ฅผ ์žฌ์‹œ์ž‘ํ•œ๋‹ค.

## ๋กœ์ปฌ ์‹คํ–‰

Next ํ”„๋กœ์„ธ์Šค์— ๋‹ค์Œ ๋ณ€์ˆ˜๋ฅผ ์„ค์ •ํ•œ ํ›„ `main`์—์„œ `npm run dev`๋ฅผ ์‹คํ–‰ํ•œ๋‹ค.

- `RUN_ENV_DATA_DIR`: ์ƒ์„ฑ๋œ ์ธ๋ฑ์Šค์˜ ์ ˆ๋Œ€ ๊ฒฝ๋กœ.
- `RUN_ENV_SEOUL_API_KEY`: ๋ฐœ๊ธ‰๋ฐ›์€ ์„œ๋ฒ„์šฉ ์„œ์šธ์‹œ API ํ‚ค. `sample`์€ ๊ด‘ํ™”๋ฌธยท๋•์ˆ˜๊ถ ํ•œ ๊ณณ๋งŒ ๊ฒ€์ฆ ๊ฐ€๋Šฅ.
- `RUN_ENV_INTERNAL_KEY`: Next์™€ ๋กœ์ปฌ auth-service์— ๊ฐ™์€ ์ž„์˜์˜ ๊ธด ๋น„๋ฐ€๊ฐ’์„ ์„ค์ •ํ•œ๋‹ค.
  Docker Compose๋กœ auth-service๋ฅผ ๋„์šฐ๋Š” ๊ฒฝ์šฐ Compose ์‹คํ–‰ ํ™˜๊ฒฝ์—๋„ ๊ฐ™์€ ๊ฐ’์„ ์ œ๊ณตํ•œ๋‹ค.
- `NEXT_INTERNAL_API_PROXY_TARGET`: ๋กœ์ปฌ API Gateway ์ฃผ์†Œ (๊ธฐ๋ณธ `http://localhost:8000`).

๋น„๋ฐ€๊ฐ’๊ณผ ์›๋ณธ ์ธ๋ฑ์Šค๋Š” ์ €์žฅ์†Œ์— ์ปค๋ฐ‹ํ•˜์ง€ ์•Š๋Š”๋‹ค. ์„œ์šธ์‹œ API๋Š” ๊ณต์‹ ์˜ˆ์ œ์™€ ๊ฐ™์€
HTTP ํฌํŠธ 8088์„ ์‚ฌ์šฉํ•œ๋‹ค. ํ‚ค๋Š” ์„œ๋ฒ„์—์„œ๋งŒ ์‚ฌ์šฉํ•˜๋ฉฐ, ์ด ์™ธ๋ถ€ ์—ฐ๊ฒฐ์—๋Š” TLS๊ฐ€ ์ ์šฉ๋˜์ง€ ์•Š๋Š”๋‹ค.
์ „๊ตญ OSM์„ ์“ด๋‹ค๋Š” ๊ฒƒ์€ ์ „๊ตญ์— ๋™์ผํ•œ ํญ/๋ณด๋„ ๋ฐ์ดํ„ฐ๊ฐ€ ์žˆ๋‹ค๋Š” ๋œป์ด ์•„๋‹ˆ๋‹ค.
OpenStreetMap ยฉ OpenStreetMap contributors (ODbL).

## ์ง€์—ญ๋ณ„ ๊ณผ๊ฑฐ ํ˜ผ์žก๋„

์‹ค์‹œ๊ฐ„ ๊ฐ’์ด ์—†๋Š” ๊ฒฝ๋กœ ์ง€์ ์€ ํ•œ๊ตญ ์‹œ๊ฐ„ ๊ธฐ์ค€ ํ‰์ผ/์ฃผ๋ง ์‹œ๊ฐ„๋Œ€ ํŒจํ„ด์„ ์‚ฌ์šฉํ•œ๋‹ค.
๊ฐ ์žฅ์†Œ์˜ ์ž์ฒด ์ผํ‰๊ท  ๋Œ€๋น„ ๋น„์œจ์ด๋ฉฐ, ๋‹ค๋ฅธ ๋„์‹œ์™€ ์ธ๊ตฌ์ˆ˜๋ฅผ ์ง์ ‘ ๋น„๊ตํ•˜์ง€ ์•Š๋Š”๋‹ค.
์‹ค์‹œ๊ฐ„๊ณผ ๊ณผ๊ฑฐ ๊ฐ’์„ ๊ฐ™์€ ์ง€์ ์— ์ค‘๋ณต ๋ฐ˜์˜ํ•˜์ง€ ์•Š๊ณ , ๊ณผ๊ฑฐ ์ž๋ฃŒ์˜ ๋ฐ˜์˜ ๊ฐ•๋„๋Š” ์‹ค์‹œ๊ฐ„์˜ 65%๋‹ค.

- [์„œ์šธ 250m ๊ฒฉ์ž ์ƒํ™œ์ธ๊ตฌ](https://data.seoul.go.kr/dataList/OA-22784/S/1/datasetView.do): ๋‚ด๊ตญ์ธ ์ถ”์ •์น˜, ์‹œ๊ฐ„๋ณ„. [๊ณต์‹ ๊ฒฉ์ž SHP](https://data.seoul.go.kr/dataVisual/seoul/seoulLivingPopulation.do)์™€ ๊ฒฐํ•ฉํ•œ๋‹ค.
- [์ธ์ฒœ ๋ถ€ํ‰๊ตฌ ์ฃผ์š”์ง€์—ญ ์œ ๋™์ธ๊ตฌ](https://www.data.go.kr/data/15167608/fileData.do): 4์‹œ๊ฐ„ ๋‹จ์œ„.
  [์ธ์ฒœ๊ด€๊ด‘ํ˜‘์˜ํšŒ ์‹œ์žฅยท๋ฌธํ™”์˜๊ฑฐ๋ฆฌ ์ขŒํ‘œ](https://www.incheontour.or.kr/place-bupyeong_market) ์ฃผ๋ณ€ 150m๋งŒ ๊ทผ์‚ฌ ์ ์šฉํ•œ๋‹ค.
  ์ด๋Š” ์กฐ์‚ฌ ๊ฒฝ๊ณ„๊ฐ€ ์•„๋‹ˆ๋‹ค. ๊ณต๊ฐ„ ๋ฒ”์œ„๋ฅผ ํ™•์ธํ•˜์ง€ ๋ชปํ•œ ์ถ•์ œ์ง€์—ญ๊ณผ ๋ถ€ํ‰4๋™์€ ์ œ์™ธํ•œ๋‹ค.

```powershell
python tools/import_regional_crowd.py --seoul ์„œ์šธ์ƒํ™œ์ธ๊ตฌ.zip ๊ฒฉ์ž.shp --bupyeong ๋ถ€ํ‰๊ตฌ.csv --out D:/data/run-env-v1/regional-crowd.json
```

์ธ๋ฑ์Šค ์ƒ์„ฑ ํ›„ Next ์„œ๋ฒ„๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•œ๋‹ค. ๋ถ€์‚ฐ API๋Š” ํ‚ค์™€ ์›๋ณธ ์‘๋‹ต ํ™•์ธ, ๊ฒฝ๊ธฐ ๋ฐ์ดํ„ฐ๋Š”
์›๋ณธ ๋ฐ ๊ฒฝ๊ณ„ยท์ด์šฉ ์กฐ๊ฑด ํ™•์ธ, ์ œ์ฃผ ์‹ค์‹œ๊ฐ„์€ ๊ณต์‹ ์—ฐ๋™ ๊ฒฝ๋กœ ํ™•์ธ ํ›„ ์ถ”๊ฐ€ํ•œ๋‹ค.

### ๋ณดํ–‰์ž ์„ผ์„œ ๋ฐ ๊ฒฝ๊ธฐ ๊ฒฉ์ž

- [์„œ์šธ ์—ด๋ฆฐ๋ฐ์ดํ„ฐ๊ด‘์žฅ S-DoT](https://data.seoul.go.kr/dataList/OA-22832/S/1/datasetView.do)์˜
  ์นด๋ฉ”๋ผ ์‹๋ณ„ ๋ฒ”์œ„ 4001~4050๋งŒ ์‚ฌ์šฉํ•œ๋‹ค. [๋ถ„๋ฅ˜ ๊ทผ๊ฑฐ](https://kpaj.or.kr/_PR/view/?aidx=34568&bidx=3103).
  45m๋Š” ์ถ”์ฒœ ์ ์šฉ ๋ฐ˜๊ฒฝ์ด๋ฉฐ ๊ด€์ธก ์‹œ์•ผ๊ฐ€ ์•„๋‹ˆ๋‹ค. ์‹ค์‹œ๊ฐ„ ์žฅ์†Œ ๊ด€์ธก์ด ์—†์„ ๋•Œ ์„ผ์„œ์˜ ๊ณผ๊ฑฐ
  ์‹œ๊ฐ„๋Œ€ ํŒจํ„ด์„ ๊ธฐ์กด ๊ด‘์—ญ ์ถ”์ •๋ณด๋‹ค ์šฐ์„ ํ•œ๋‹ค. ์ตœ์‹  ๊ด€์ธก์ผ์ด 90์ผ์„ ๋„˜์œผ๋ฉด ๋ฐ˜์˜ํ•˜์ง€ ์•Š๋Š”๋‹ค.
- `--gyeonggi-verified-grid HOURLY_CSV GRID_FILE`๋กœ ๊ฒฝ๊ธฐ๋„ 50m ๊ฒฉ์ž ์ž๋ฃŒ๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ๋‹ค.
  CSV๋Š” `grid_id,date,hour,count` (๋‚ ์งœ YYYY-MM-DD), ๊ฒฝ๊ณ„ ํŒŒ์ผ์€ ๊ฐ™์€ `grid_id`๋ฅผ ๊ฐ€์ง„
  ์ขŒํ‘œ๊ณ„๊ฐ€ ๋ช…์‹œ๋œ ๊ฒฉ์ž์—ฌ์•ผ ํ•œ๋‹ค. ๋ฌด๋ฃŒ ์„œ๋น„์Šค ์ด์šฉ์ด ํ™•์ธ๋œ ์‹œ๊ฐ„๋ณ„ ์›๋ณธ๋งŒ ์‚ฌ์šฉํ•œ๋‹ค.
  8์›” ํ–‰์ •๋™ ์œ ์ž… ZIP๊ณผ ํ‰์ผ/์ฃผ๋ง ์ฃผ๊ฐ„ ํ‰๊ท ๋งŒ ์žˆ๋Š” ๋ฐ์ดํ„ฐ๋Š” ์ด ์ž…๋ ฅ์œผ๋กœ ์“ฐ์ง€ ์•Š๋Š”๋‹ค.

```powershell
python -m pip install openpyxl
python tools/import_regional_crowd.py --sdot ์œ„์น˜.xlsx ์ฒซ์ฃผ.csv ๋‘˜์งธ์ฃผ.csv --out D:/data/run-env-v1/pedestrian-crowd.json
python tools/import_regional_crowd.py --gyeonggi-verified-grid ์‹œ๊ฐ„๋ณ„.csv ๊ฒฉ์ž.shp --out D:/data/run-env-v1/gyeonggi-crowd.json
```