map-print - GitLite

KO | EN

gitlite — search

#hacktoberfest #typescript #golang #go #deep-learning #linux #nodejs #macos #windows #awesome #cli #awesome-list #mcp #open-source

map-print

(★ 99)

Print a map on a mug

파일 탐색기

최종 버전 다운로드 (.zip)

- build.js
- check-versions.js
- utils.js
- vue-loader.conf.js
- webpack.base.conf.js
- webpack.dev.conf.js
- webpack.prod.conf.js
- dev.env.js
- index.js
- prod.env.js
- preview_large.png
- - .gitignore
- - getCorsDomain.js
  - index.js
  - options.js
  - package-lock.json
  - package.json
- template.yaml
- - About.vue
  - clickOutside.js
  - ColorPicker.vue
  - Loading.vue
- - bbox.js
  - constructGraph.js
  - createProjector.js
  - createWglScene.js
  - fileDrop.js
  - formatNumber.js
  - getZazzleLink.js
  - osm.js
  - parseKMLFile.js
  - postData.js
  - query-presets.js
  - request.js
- App.vue
- appState.js
- bus.js
- main.js
- vueApp.js
- .gitkeep
.babelrc
.editorconfig
.gitignore
.postcssrc.js
deploy.sh
index.html
index.js
LICENSE
package-lock.json
package.json
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/anvaka/map-print

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd map-print

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# [Map Print](https://anvaka.github.io/map-print/)

Print a map of roads on a mug.

![demo](https://i.imgur.com/lXBMVxV.gif)

Here is how the final product look like:

![Final product](https://i.imgur.com/chH2Tni.jpg)

## Why?

I love maps and travels. Every time I grab a Vancouver mug - not only it is filled with hot coffee,
it is also filled with warm memories.

![vancouver mug](https://i.imgur.com/XiISjy3.png)

Now you too can [make a mug from the roads network](https://anvaka.github.io/map-print/) of a city that you've visited (or planning to visit).
Or give it as a gift to those whom you care about. I hope you like what this project does.

I'm giving away the entire source code for free. Yet I think you should know: with every purchase 
coming from this project, Zazzle gives me a small revenue from the sale. 
So every purchase supports this project.

Your ideas and suggestions are more than welcomed!

## How?

The original map is rendered with [mapbox-gl](https://github.com/mapbox/mapbox-gl-js). When you find an 
area that you like and click the "Start" button - I send request to the [OpenStreet Map](https://www.openstreetmap.org/)
with [Overpass-Turbo](http://overpass-turbo.eu/) API to fetch all the roads in a given bounding box.

These roads are then rendered with my own tiny-toy WebGL rendering engine [w-gl](https://github.com/anvaka/w-gl).
The engine is not ready for production use, but it can render millions of roads very quickly.

Virtualization is a common technique used by mapping software to reduce amount of things rendered 
on the screen and focus user's attention on major facets of a map. `w-gl` gives unique opportunity to
see how road networks look without virtualization. I.e. every single road is rendered on the screen, regardless
of the zoom level.

Sometimes it's just a single large blob of ink, but more often you'd see [beautiful patterns](https://twitter.com/anvaka/status/1005527424757448704) on the screen.

That said, I wouldn't recommend zooming out too far. When I tried it - I had either OpenStreetMap failing my requests,
or my browser running out of memory. You will see a warning on the screen if you zoom out too far.

## Local Development

Get the package and its dependencies

```
git clone https://github.com/anvaka/map-print.git
npm install
cd map-print
```

And then start the local server:

```
npm start
```

This should open a server on http://localhost:8080

## License

MIT.

If you'd like to support the project - here is my Patreon page: https://www.patreon.com/anvaka 🧙