https://github.com/kanahiro/tileget
Tile download utility - easily download xyz-tile data.
https://github.com/kanahiro/tileget
gis python raster-tiles vector-tiles xyz-tiles
Last synced: 2 months ago
JSON representation
Tile download utility - easily download xyz-tile data.
- Host: GitHub
- URL: https://github.com/kanahiro/tileget
- Owner: Kanahiro
- License: mit
- Created: 2022-02-04T11:03:17.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-11T12:04:01.000Z (about 2 years ago)
- Last Synced: 2025-06-24T08:02:04.737Z (12 months ago)
- Topics: gis, python, raster-tiles, vector-tiles, xyz-tiles
- Language: Python
- Homepage: https://pypi.org/project/tileget/
- Size: 38.1 KB
- Stars: 31
- Watchers: 1
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tileget
Tile download utility - easily download xyz-tile data.
## Requirements
- Python >= 3.14
## Installation
```sh
pip install tileget
```
## Usage
```plaintext
usage: tileget [-h] [-e OUTPUT_DIR] [-o OUTPUT_FILE] [--extent EXTENT EXTENT EXTENT EXTENT]
[--geojson GEOJSON] [--minzoom MINZOOM] [--maxzoom MAXZOOM] [--rps RPS] [--overwrite]
[--timeout TIMEOUT] [--tms] [--retries RETRIES] [--retry-delay RETRY_DELAY]
[--format FORMAT]
tileurl
xyz-tile download tool
positional arguments:
tileurl xyz-tile url in {z}/{x}/{y} template
options:
-h, --help show this help message and exit
-e, --output_dir OUTPUT_DIR
output dir
-o, --output_file OUTPUT_FILE
output mbtiles file
--extent EXTENT EXTENT EXTENT EXTENT
min_lon min_lat max_lon max_lat, whitespace delimited
--geojson GEOJSON path to geojson file of Feature or FeatureCollection
--minzoom MINZOOM default to 0
--maxzoom MAXZOOM default to 16
--rps RPS requests per second, must be positive, default to 1
--overwrite overwrite existing files
--timeout TIMEOUT wait response until this value in seconds, default to 5.0
--tms if set, parse z/x/y as TMS
--retries RETRIES max retry count on error, default to 3
--retry-delay RETRY_DELAY
base delay in seconds for exponential backoff, default to 1.0
--format FORMAT tile format for mbtiles metadata (e.g. png, jpg, pbf). used when url has no extension
```
### Examples
```sh
# basic usage
tileget http://path/to/tile/{z}/{x}/{y}.jpg -e output_dir --extent 141.23 40.56 142.45 43.78
tileget http://path/to/tile/{z}/{x}/{y}.jpg -o output.mbtiles --geojson input.geojson
# with rate limiting and retry options
tileget http://path/to/tile/{z}/{x}/{y}.jpg -e output_dir --extent 141.23 40.56 142.45 43.78 --minzoom 0 --maxzoom 16 --rps 5 --retries 5 --retry-delay 2.0 --timeout 10 --overwrite
```