Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/openaddresses/TileBase
Range based Single File MBTiles like Store
https://github.com/openaddresses/TileBase
mbtiles vector-tiles
Last synced: 18 days ago
JSON representation
Range based Single File MBTiles like Store
- Host: GitHub
- URL: https://github.com/openaddresses/TileBase
- Owner: openaddresses
- License: mit
- Created: 2021-04-11T20:47:02.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-11-23T19:28:10.000Z (almost 2 years ago)
- Last Synced: 2024-04-14T08:32:50.174Z (7 months ago)
- Topics: mbtiles, vector-tiles
- Language: JavaScript
- Homepage: https://openaddresses.github.io/TileBase/
- Size: 3.35 MB
- Stars: 16
- Watchers: 4
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
TileBase
Range Based Single File MBTiles-like Tile Store
## Usage
TileBase can be accessed in several ways through the following client libraries
| Language | Link |
| -------- | ---- |
| NodeJS | [USAGE](https://openaddresses.github.io/TileBase/)
## Command Line Library
The default command line requires that node be installed. The easiest way to do this
is usually via [NVM](https://github.com/nvm-sh/nvm)
Once node is installed, from the git repository, run the following to install
dependencies.
```sh
npm install
```
```sh
npm link
```
The TileBase cli should now be able to be used from your command line via
```sh
tilebase --help
```
## Format Spec (v1)
A TileBase file is designed as a single file tile store. It is functionally similiar to a MBTiles file,
except it is optimized for Cloud Storage based serving and does not allow dynamic updates.
TileBase files allow Ranged requests from Cloud Storage providers, avoiding the generally expensive
operation of pushing individual tiles to the store.
__TileBase File__
```
```
### File Header
Every TileBase file will begin with `74 62` (`tb` in ASCII) followed by an 8-bit unsigned integer
representing the TileBase spec version number.
Since there is currently only one version of the spec, all TileBase files will start with the following:
```
74 62 01
```
Following the Magic Bytes is a single 32 bit unsigned Little Endian Integer containing the number of following bytes
that make up the JSON file config.
```
74
62 tb Magic Bytes
01 1
D3
04
00
00 1234 bytes
```
This means that the max number of bytes in the JSON config is 4294967295 bytes (~4gb)
### File Config
After the header, a stringified JSON object contains the config necessary to read the
TileBase file. The length of the binary JSON config MUST be equal to the length
specifier preceding the config.
```
{
"min": ,
"max": ,
"ranges": {
"": [, , , ]
...
}
}
```
### Tile Addresses
After the JSON config is a block of Tile Addresses. There will be one tile
address for every tile that would fall within the rectangular `ranges` array.
Should a vector tile be empty, it will have a `Byte Address` to where the tile
would have been in the file, however with a `Vector Tile Size` of 0.
Byte addresses reference the number of bytes to the initial byte from the end
of the TileAddresses Block.
IE: the first byte address of any TileBase file will be 0, as it will be the
first byte after the Tile Addresses block.
_Example: Single Tile Address_
```
```
### Tile Data
Tile Data is simply a blob of continuous gzipped Mapbox Vector Tiles. Their order
is determined simply by the order in which they are reference by the Tile
Address blob.
### Error Handling
Errors returned via the TileBase library will return a TBError, an extension to the default
JS `Error` class with the addition of a `status` field. The status field will contain a suggested
HTTP Status code to return to a user in a server setting.