Spaces:
Running
Running
|
Download docs/running-environment.md from tkadkghdlf/CD: direct link, hf CLI and curl.
- Browser
- Download file 6.95 kB
-
https://huggingface.co/spaces/tkadkghdlf/CD/resolve/main/docs/running-environment.md
- Command line
-
hf download hf://spaces/tkadkghdlf/CD/docs/running-environment.md
-
curl -L -o running-environment.md https://huggingface.co/spaces/tkadkghdlf/CD/resolve/main/docs/running-environment.md
6.95 kB
| # ๋ฌ๋ ํ๊ฒฝ ์ ์ | |
| ์ถ์ฒ ๊ฒฐ๊ณผ์ 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 | |
| ``` | |