Note: This repository has been renamed from mbtiles-util
to tiles-util
. Please update your references accordingly.
-
Using pip install (Windows/ Linux):
pip install tiles-util
-
Show information of installed mbtiles-util:
pip show tiles-util
-
Install the latest vertion of mbtiles-util:
pip install tiles-util --upgrade
-
Visit tiles-util on PyPI
- Display MBTiles metadata info:
Ex:
> mbtilesinfo <file_path>
> mbtilesinfo tiles.mbtiles
-
Convert MBTiles file to folder: (support raster MBTiles (.png, .jpg, .webp) and vector MBTiles (.pbf))
> mbtiles2folder -i <file_name.mbtiles> -o [output_folder (optional)] -tms [TMS scheme (optional 0 or 1, default is 0)]
Ex:
> mbtiles2folder -i tiles.mbtiles -o tiles_folder -tms 0
Without -o parameter: output_folder has the same name with MBTiles file name at current directory
-
Convert a tiles folder to MBTiles file: (support raster tile (.png, .jpg, .webp) and vector tile (.pbf))
> folder2mbtiles -i <input_folder> -o [file_name.mbtiles (optional)] -tms [TMS scheme (optional 0 or 1, default is 0)]
Ex:
> folder2mbtiles -i tiles_folder -o tiles.mbtiles -tms 0
Without -o parameter: file_name.mbtiles has the same name with input_folder name at current directory
-
Uplpad a vector tiles folder to Amazon S3 Bucket:
> vectorfolder2s3 <input_folder>
Ex:
> vectorfolder2s3 vectortiles_folder
Input S3 parameters:
> S3 Bucket name: <Your S3 Bucket name (required)> > S3 Prefix: [Your S3 prefix (Optional. Press Enter to upload to the bucket root folder)] > AWS Access Key ID: <Your_Access_Key_ID (required)> > AWS Secret Access Key: <Your_Secrect_Access_Key (required)> > AWS Region: <AWS region (Optional. Press Enter to choose default region)>
-
Uplpad a raster tiles folder to Amazon S3 Bucket:
> rasterfolder2s3 <input_folder>
Ex:
> rasterfolder2s3 rastertiles_folder
Input S3 parameters:
> S3 Bucket name: <Your S3 Bucket name (required)> > S3 Prefix: [Your S3 prefix (Optional. Press Enter to upload to the bucket root folder)] > AWS Access Key ID: <Your_Access_Key_ID (required)> > AWS Secret Access Key: <Your_Secrect_Access_Key (required)> > AWS Region: <AWS region (Optional. Press Enter to choose default region)>