How to publish OSM maps locally and customize the mapping

1、 origin

1. OpenStreetMap（ abbreviation OSM） Not only can you use it online for free , And it's free download Raw data , The data format is .osm.pbf and shp.
2. We will OSM Download the raw data , Treat it as a vector tile , Publish as a service , Can be realized OSM Local map publishing and custom mapping .
3. OSM How data is organized , It's a click 、 Line 、 Face to face , It's not the way we usually follow the road 、 building 、 The way rivers divide layers , But it can be extracted according to the attributes .
4. openmaptiles A set of OSM A complete solution to data usage , Can achieve OSM Data download 、 Put in storage 、 analysis 、 Generating vector tiles 、 Adjust the map style 、 The full range of map preview features , also Open source .
5. Next, let's introduce in detail openmaptiles How to install and get started with open source libraries .

2、 Prepare the environment

1. install linux System （openmaptiles Open source libraries can only be found in linux Running on the system ）
2. install docker
3. install Docker Compose
4. install git

2.1、 install linux System

1. I installed it on a virtual machine , Virtual machine and linux System installation tutorial reference ：https://blog.csdn.net/null_of_error/article/details/108133241
2. Virtual machine version I used VM14, Baidu online disk download address ：https://pan.baidu.com/s/1BTjByB6oTz8cTxOv_GzGWw, Extraction code ：kshr, Including license .
3. linux The system I use is centOS7.9, Alicloud official image download address ：http://mirrors.aliyun.com/centos/7.9.2009/isos/x86_64/CentOS-7-x86_64-Everything-2009.iso

2.2、 install docker

1. Installation tutorial reference ：https://www.runoob.com/docker/centos-docker-install.html

2. I use manual installation , Installation steps ：

   1. install docker

      yum install -y yum-utils device-mapper-persistent-data lvm2
      

   2. Set the image source of domestic Alibaba cloud , It's going to be faster than the official

      yum-config-manager --add-repo  http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
      

   3. install Docker Engine-Community

      yum install docker-ce docker-ce-cli containerd.io
      

   4. start-up docker

      systemctl start docker
      

   5. Test for correct installation

      docker run hello-world
      

2.3、 install Docker Compose

1. Installation tutorial reference ：https://www.runoob.com/docker/docker-compose.html

2. Installation steps ：

   1. install docker compose

      curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
      

   2. Set the permissions

   chmod +x /usr/local/bin/docker-compose
   

   3. Test for correct installation

   docker-compose --version
   

2.4、 install git

1. Installation tutorial reference ：https://www.jianshu.com/p/e6ecd86397fb

2. Installation steps ：

   1. install

      yum install git
      

   2. Test for correct installation

      git --version
      

3、 Publish maps

openmaptiles Open source library

1. github Address ：https://github.com/openmaptiles/openmaptiles
2. Quick start documentation ：https://github.com/openmaptiles/openmaptiles/blob/master/QUICKSTART.md

3.1、 Pull the code

1. Pull openmaptiles Code

   git clone https://github.com/openmaptiles/openmaptiles.git
   

2. After pulling , Entry directory

   cd openmaptiles
   

3. perform make command

make 

3.2、 Test network

1. First test whether your computer can open this website ：https://www.wikidata.org/,openmaptiles You need to download it from this website poi data , If you can't access , Just follow the steps below to set up , Let the program skip this step . The follow-up wants poi Data. , You can go over the wall by yourself .

2. How to skip downloading poi data ：

   1. Use vi open quickstart.sh file ,vi For usage, please refer to ：https://zhuanlan.zhihu.com/p/37704677

      vi quickstart.sh
      

   2. find make import-wikidata That's ok
      

   3. Input i Enter insertion mode

   4. stay make import-wikidata Enter before the command # Number , Then press esc key

   5. Input :wq Save and exit

3.3、 Processing data

Execute the following quick start command , The program will run automatically OSM Data download 、 Put in storage 、 analysis 、 The work of generating vector tiles . The default is the region of Albania , The level of tile generation is 0-7 level . We'll talk about how to set up regions and levels later . This command will take a little longer to execute , Wait patiently .

./quickstart.sh 

3.4、 Publishing vector tile service

After data processing , Publish the generated vector tiles to map service , step ：

1. Start the service

   make start-tileserver
   

2. Enter the virtual machine in your computer browser ip Address plus port 8080, My computer address is

   http://192.168.50.8:8080/
   

3. Click on view Button , See the effect

   

   

3.5、 Custom map style

1. start-up maputnik

   make start-maputnik
   

2. Enter the virtual machine in your computer browser ip Address plus port 8088, My computer address is

   http://192.168.50.8:8088/
   

   

3. Just started TileServer-GL In the web page , Click TileJSON link , Then copy the address

   

   

4. go back to maputnik Webpage , Click the button in the blue box below Data Sources, Paste the above address into the green box , Then click the delete button in the red box , Close other maps . Close the pop-up , You can see the map we've released .

   

5. Then you can freely customize the map style
   

3.6、 Be careful

1. This is the map of China , See all supported regions

   ./quickstart.sh china 
   

2. It is suggested to use the default Albania area for the first time to see the effect , Get familiar with the process , Because its data is small , It's fast . China will be a long time , There's no progress bar , The first test used this big , It's very easy to lose patience .

3. The factors that determine data processing time ： Computer network speed 、 Computer performance 、 The size of the processing data 、 The level of tile generation .

4. The virtual machine configuration of my computer is relatively low , Dealing with the region of Albania ,0-7 Level data , Probably used 10 About minutes , Processing Taiwan data , Etc. 1 I haven't finished for an hour , Finally gave up , Wait for a good computer and try again .

5. People who want a national map need to pay attention to , The data for China and Taiwan are separate , It needs to be downloaded and processed separately .

6. The cut map level is in .env Configuration in file

4、 summary

1. This article introduces in detail openmaptiles Open source library installation and quick start use

2. Enter the following help command , You can see openmaptiles More features supported , We will write a detailed introduction to

   make help
   

   

---

Original address ：http://gisarmory.xyz/blog/index.html?blog=OSMVectorTiles

Focus on 《GIS Zeughaus 》 official account , The first time to get more high quality GIS article .

This article adopts   Creative Commons signature - Noncommercial use - Share in the same way 4.0 International licensing agreement   Licensing . Welcome to reprint 、 Use 、 Re release , But be sure to keep the signature of the article 《GIS Zeughaus 》（ Include links ：  http://gisarmory.xyz/blog/）, Not for commercial purposes , Based on this revised work must be released with the same license .