Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Geodan/mapbox-3dtiles
3D Tiles implementation using Mapbox GL JS custom layers
https://github.com/Geodan/mapbox-3dtiles
Last synced: about 1 month ago
JSON representation
3D Tiles implementation using Mapbox GL JS custom layers
- Host: GitHub
- URL: https://github.com/Geodan/mapbox-3dtiles
- Owner: Geodan
- License: bsd-3-clause
- Created: 2019-01-17T15:47:06.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-06-17T18:51:48.000Z (over 2 years ago)
- Last Synced: 2024-11-09T12:17:11.203Z (about 1 month ago)
- Language: JavaScript
- Size: 41.8 MB
- Stars: 300
- Watchers: 41
- Forks: 62
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-3d-tiles - mapbox-3dtiles - Mapbox GL JS custom layer for 3D Tiles. (Viewers)
README
# mapbox-3dtiles
3D Tiles implementation using Mapbox GL JS custom layers
See [https://geodan.github.io/mapbox-3dtiles/](https://geodan.github.io/mapbox-3dtiles/) for a working demo.
This is a proof-of-concept implementation of a [3D Tiles](https://github.com/AnalyticalGraphicsInc/3d-tiles) viewer as a [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) custom layer. WebGL rendering is implemented using [three.js](https://github.com/mrdoob/three.js/). Only Web Mercator (EPSG:3857) tilesets are supported, as this is the projection mapbox uses. Earth-centered earth-fixed tilesets are explicitly not supported. Tilesets used for testing were generated using [pg2b3dm](https://github.com/Geodan/pg2b3dm), using a PostGIS database with EPSG:3857 geometries.
This is by no means a complete implementation of the 3D Tile specification. Currently the following features are supported:
* Geometric error based tile loading
* Replacement and additive refinement
* Only Box bounding volumes are supported
* Tile transforms
* External tilesets
* Tile types:
* Batched 3D Model (b3dm)
* Point Cloud (pnts): basic implementation
The following features are not supported at this time:
* Any coordinate system other than EPSG:3857
* Region and sphere bounding volumes
* Viewer request volumes
* Instanced 3D Model (i3dm) tiles
* Composite (cmpt) tiles
* [3D Tile Styles](https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification/Styling)
## Instructions
In a directory on your webserver run the folowing commands:
```
git clone https://github.com/Geodan/mapbox-3dtiles.git
cd mapbox-3dtiles
npm install
cd ./ahn
tar xvf ahn_points.tar.gz
cd ../rotterdam
tar xvf rotterdam_3dtiles_small.tar.gz
```
Next, copy file "apikeys.js.example" to "apikeys.js" and add your [mapbox token](https://docs.mapbox.com/help/how-mapbox-works/access-tokens/). Point your browser to the directory in question and you should see a basic viewer with 3d tiles content.
## Creating tilesets
Tilesets can be created using [pg2b3dm](https://github.com/Geodan/pg2b3dm), using a PostGIS database table as source. The PostGIS table should contain 3D geometries in EPSG:3857 projection.
Example query creating extruded 3D buildings in EPSG:3857:
```
DROP TABLE IF EXISTS .;
CREATE TABLE . AS (
WITH extent AS (
SELECT ST_MakeEnvelope(, , , , ) geom
),
footprints AS (
SELECT a.id AS id, a.height, a.geom
FROM . a, extent b
WHERE ST_Intersects(a.geom, b.geom)
)
SELECT id, ST_Force3D(ST_Extrude(ST_Transform(ST_MakeValid(geom), 3857), 0, 0, height)) AS geom
FROM footprints
);
DELETE FROM . WHERE geom IS NULL; -- cleanup
DELETE FROM . WHERE ST_GeometryType(geom) NOT LIKE 'ST_PolyhedralSurface'; -- cleanup
```
Creating tileset using pg2b3dm:
`pg2b3dm -h -U -d -p -c -t `
For more information, see the [pg2b3dm](https://github.com/Geodan/pg2b3dm) documentation.
Creating tileset from point cloud:
Pointcloud data is not yet supported by pg2b3dm and needs to be exporterd with an earlier tool called [py3dtiles](https://github.com/Oslandia/py3dtiles)
`py3dtiles convert --srs_in --srs_out 3857 --out pointcloud.las`
For more information, see the [py3dtiles](https://github.com/Oslandia/py3dtiles) documentation.