https://github.com/satsuma22/maptiles
A real-time 3D environment visualizer
https://github.com/satsuma22/maptiles
cpp geographical-information-system opengl openstreetmap-api openstreetmap-data openstreetmaps
Last synced: 7 months ago
JSON representation
A real-time 3D environment visualizer
- Host: GitHub
- URL: https://github.com/satsuma22/maptiles
- Owner: satsuma22
- License: gpl-3.0
- Created: 2024-11-15T15:34:01.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-14T10:06:57.000Z (7 months ago)
- Last Synced: 2025-03-14T11:23:23.098Z (7 months ago)
- Topics: cpp, geographical-information-system, opengl, openstreetmap-api, openstreetmap-data, openstreetmaps
- Language: C++
- Homepage:
- Size: 7.52 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/satsuma22/MapTiles/actions/workflows/cmake-single-platform.yml)
# MapTiles
## Table of Contents
- [About the Project](#about-the-project)
- [Dependencies](#dependencies)
- [Building](#building)
- [Usage](#usage)
- [Configuration](#configuration)
- [Input](#input)
## About the Project
MapTiles is a real-time 3D enviornment visualizer. It fetches geographical data from OpenStreetMap and constructs and renders a 3D scene in real-time.
## Dependencies
The project has a few dependencies but the only ones that you need to manually install are:
* `GLFW`
* `GLEW`
* `OpenGL`
On Ubuntu you can install these dependencies by running the following command:
```bash
sudo apt-get update
sudo apt-get install libgl1-mesa-dev libglew-dev libglfw3-dev
```
On Windows it is recommended that you install these dependencies using `vcpkg`. After installing `vckpg`, run the following command:
```cmd
vcpkg.exe install glfw
vcpkg.exe install glew
```
Every other dependency is either present in the repo or is available as a submodule.
## Building
First clone the repo and it's submodules by running the command:
```cmd
git clone --recurse-submodules https://github.com/satsuma22/MapTiles.git
```
To build, create a build folder in the root directory and run the CMake script. This can be done using the following commands:
```cmd
mkdir build
cd build
cmake ..
```
On Windows, you will have to provide the path to the directory containing `vcpkg`:
```cmd
cmake .. -DPATH_TO_VCPKG=
```
replace `` with the path containing the `vcpkg` directory.
Once the build is configured, you can build the project by running:
```cmd
cmake --build .
```
or by compiling the project using the selected build system (for example, visual studios on windows).
## Usage
The application can be used for any city for which geographical data are available in the OpenStreetMap database. To render the 3D map of a city, run the following command:
```cmd
MapTiles.exe
```
Replace "latitude" and "longitude" (and the angular brackets) with the latitude and longitude of the city. When no arguments are provided, the application defaults to the city of Dresden, Germany.
## Configuration
Certain settings for the application be configured via the `Config.h` file.
* `Tile3DSize`
* Controls the size of individual `Tile3Ds`. Specified in degrees.
* `NeighbourhoodFetchSizeRasterTile`
* Controls the grid size for the `RasterTiles`. A grid size of `n` results in a `(2*n+1)x(2*n+1)` grid.
* `NeighbourhoodFetchSizeTile3D`
* Controls the grid size for the `Tile3Ds`. A grid size of `n` results in a `(2*n+1)x(2*n+1)` grid.
* `FrustumBasedTileGeneration`
* Enables frustum based tile generation which will fetch and render all the tiles inside the view frustum.
* `FrustumRasterTilesCount`
* Limits the maximum number of `RasterTiles` along any one axis when `FrustumBasedTileGeneration` is enabled.
* `FrustumTile3DMaxDistance`
* Limits the number of `Tile3Ds` generated along any one axis based on distance from the camera when `FrustumBasedTileGeneration` is enabled. The distance is measured in degrees.
* `VSync`
* Sets the number of screen updates required before a buffer swap.
* `MaxRasterTileRequestThreads`
* Sets the maximum number of threads that can be active at once for fetching Raster Tiles.
* `MaxTile3DRequestThreads`
* Sets the maximum number of threads that can be active at once for fetching Tile3Ds.
* `RasterTileRenderCacheTrimDistance`
* Sets the distance limit for Raster Tiles that is checked while trimming the cache. Tiles outside the limit get cleared.
* `Tile3DRenderCacheTrimDistance`
* Sets the distance limit for Tile3Ds that is checked while trimming the cache. Tiles outside the limit get cleared.
## Inputs
* `w` `s` `a` `d`
* changes the position of the agent.
* `Up` `Down` `Left` `Right`
* changes the orientation of the agent.
* `f`
* toggles tile generation mode between grid-based and frustum-based.