The `TileClipper` package enables users to download map tiles within a specified bounding box from a tile server
Project description
TileClipper Package Usage Guide
Introduction
The TileClipper
package enables users to download map tiles within a specified bounding box from a tile server. This guide illustrates the installation process, instantiation of the TileClipper
class, and downloading map tiles using the package.
Installation
Ensure Python is installed on your system, then install the TileClipper
package using pip
:
pip install tileclipper
from tileclipper import TileClipper
Instantiate TileClipper
Define the required parameters for the TileClipper class:
base_url (str): Base URL of the tile server.
bbox (list): Bounding box coordinates [minx, miny, maxx, maxy].
output_folder (str): Directory to save downloaded tiles.
max_workers (int, optional): Maximum number of concurrent workers for tile downloads (default is 10).
Create an instance of the TileClipper class:
base_url = "https://example.com/tiles/" # Replace with your tile server URL
bbox = [xmin, ymin, xmax, ymax] # Replace with bounding box coordinates
output_folder = "/path/to/output/folder/" # Replace with output folder path
max_workers = 10 # Optional: Set maximum workers for concurrent downloads
tileclipper = TileClipper(base_url, bbox, output_folder, max_workers)
Download Tiles
Utilize the download_tiles(zoom_start, zoom_end) method to download tiles within a specified zoom level range:
# Download tiles within zoom level range 18 to 20
tileclipper.download_tiles(18, 20)
Example
Here's an example demonstrating the usage of the TileClipper class:
from tileclipper import TileClipper
base_url = "https://example.com/tiles/"
bbox = [xmin, ymin, xmax, ymax]
output_folder = "/path/to/output/folder/"
max_workers = 10
tileclipper = TileClipper(base_url, bbox, output_folder, max_workers)
tileclipper.download_tiles(18, 20)
Replace the placeholder values (base_url, bbox, output_folder, etc.) with your specific values according to your use case.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tileclipper-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 86c4c7a84e668e6f8db2a49c365b91e77e16188163d769d127253db315942c84 |
|
MD5 | e88bd628f89808a4a95217b6db57bcb4 |
|
BLAKE2b-256 | b98c296b71353ec457177e84ba8fb3294d2e55dcecfba0ec288183571c3a7d1f |