vector tile academy (wip) / ベクトルタイル・アカデミー（作業中）

TODO
書けるところから書いていって姿を見せていく。

h2, h2, h3 の英語、日本語はそれぞれではなくて、/ 区切りで書くようにする。インデックスの見通しを良くするため。

The document will be in English. After initial completion, we may add internationalization. Before that, all sentences in different languages will be translated in English.

ここで私が作ろうとしているのは、昔の Linux の伝統で言う、HOWTO 文書かもしれない。

Purpose of this document/この文書の目的

Intended audience/想定読者

ベクトルタイルの生産、ホスト、スタイリング、最適化を一通り設計・実施したいエンジニア。

Principles to be introrduced in the beginning/最初に共有すべき原則

UNVT の基本的な考えは、100ドルで誰でも入手できる環境を提供することで最新のウェブ地図技術を誰でも使えるようにすることである。

UNVT は「自分の地図をウェブでも生き残らせたい」という人を支援することを目標に設計されている。

なぜ UNVT は汎用万能パッケージではないか。それは、ソースデータの特性が様々だからである。最良の効率を実現するためには、ソースデータの特性に合わせて UNVT を適切にデプロイする必要がある。

Preparing the hardware

Raspberry Pi 4B

Raspberry Pi 4B
PC
Power connection to Raspberry Pi
Ethernet connection between Raspberry Pi and the PC
MicroSD card

Installing Raspbian

TODO

Clone the work reposotory

Download the source data

Download the data and bring it to the session. The session venue does not nesessarily have an Internet connection.

https://download.geofabrik.de/europe/switzerland-latest.osm.pbf (caution! this is a direct link to the megabytes of data.)

Preparing the toolkit/ツールキットの準備

`nanban` for or Docker with Intel CPU/Intel CPUのDocker

docker run -ti --rm -v $(pwd):/root/work unvt/nanban

`equinox` for Raspbian on Raspberry Pi/Raspberry Pi の Raspbianfont>

curl -sL https://unvt.github.io/equinox/install.sh | bash -

It is always a good idea to know what the command is doing. You can check what you are doing by not piping to the shell:

https://unvt.github.io/equinox/install.sh

Designing vector tiles/ベクトルタイルの設計

ベクトルタイルの設計は、実際にはベクトルタイルの生産とスタイル付けをしながら反復的に行なっていくことになります。しかし、ベクトルタイルを設計するとはどういうことなのか、ということについて本節では解説します。

how does a vector tile specification look like?

source data layer	vector tile layer	minzoom	maxzoom	vector style layers
Building	building	15	15	buliding

Production of vector tiles /ベクトルタイルの生産

Hosting the vector tiles /ベクトルタイルのホスト

Tiles/タイル

Files other than tiles/タイル以外のファイル

Mapbox GL JS

Compile to latest Mapbox GL JS/最新の Mapbox GL JS をコンパイルする

to install for the first time

git clone https://github.com/mapbox/mapbox-gl-js

to get the latest version

cd mapbox-gl-js
yarn run build-prod-min
yarn run build-css

We will be using dist/mapbox-gl.js, dist/mapbox-gl.css, and dist/mapbox-gl.js.map. mapbox-gl.js.map is optional.

ベクトルタイルのスタイル付け

HOCON で

Mapbox Studio で

Maputnik で

Maputnik は Mapbox Style の Expression に対応していないため、ベクトルタイルの性能を最大限に発揮することができない状態になっていることから、Mapbox Studio よりも低い優先度で紹介することになる。

ジオポータルとベクトルタイルの関係

原則論

ベクトルタイルの設計は、ジオポータルのクラシカルなレイヤモデルと異なる。一つのスタイルファイル、一つの source で地図を表現するのがベクトルタイルにおいては最も効率的である。

既存のジオポータルにベクトルタイルを接続しても、ベクトルタイルの最大の性能を得られるわけではない。他方で、接続すれば既存の画像タイルよりは高い性能が得られる可能性が高い。

やむを得ず既存のジオポータルに接続せざるを得ない場合には、次の「相互運用手段」を用いる。

相互運用手段

知りうる限りは、Mapbox GL JS で構築されたジオポータルは存在しない。Mapbox GL JS 以外のライブラリでのベクトルタイル対応は性能が出ておらず、これを使えば画像タイルよりも低い性能になってしまう。

このため、

Contribution of UNVT to UN global agendas

SDGs

9

Goal 9. Build resilient infrastructure, promote inclusive and sustainable industrialization and foster innovation

9.a.

Facilitate sustainable and resilient infrastructure development in developing countries through enhanced financial, technological and technical support to African countries, least developed countries, landlocked developing countries and small island developing States.

17

Goal 17. Strengthen the means of implementation and revitalize the Global Partnership for Sustainable Development

17.16 - Systemic issues - Multi-stakeholder partnerships -

Enhance the Global Partnership for Sustainable Development, complemented by multi-stakeholder partnerships that mobilize and share knowledge, expertise, technology and financial resources, to support the achivement of the Sustainable Development Goals in all countries, in particular developing countries

17.9 - Capacity-building - (potentially)

Enhance international support for implementing effective and targeted capacity building in developing countries to support national plans to implement all the Sustainable Development Goals, including through North-South, South-South and triangular cooperation

SF

24. ©

To develop, periodically update and disseminate, as appropriate, location-based disaster risk information, including risk maps, to decision makers, the general public and communities at risk of exposure to disaster in an appropriate format by using, as applicable, geospatial information technology

25. (o)

To enhance collaboration among people at the local level to disseminate disaster risk information through the involvement of community-based organizations and non- governmental organizations

FAQ

UNVT を使ったサイトを運営するとき、attributionにはなんと入れた方がいいでしょうか？

ありがとうございます。UNVT はツールでしかないので、attribution は不要です。Microsoft Word で作ったファイルに Microsoft の attribution を入れる必要はない、それと同じだ、というイメージでお考えください。

その上で、UNVT への言及をご希望いただけるようであれば、例えば "Powered by the United Nations Vector Tile Toolkit" といった言葉を適宜入れていただけると嬉しいです。Apache で運用しているサイトに、任意で Powered by Apache といったバナーを入れていた昔の慣習のようなイメージでお考えください。

Appendix

対訳辞書

production/produce 生産（する）
hosting/host ホスト（する）
styling/style スタイル付け（する）
optimization/optimize 最適化（する）