{"id":27345040,"url":"https://github.com/sijandh35/tileclipper","last_synced_at":"2025-04-12T17:54:40.463Z","repository":{"id":217454337,"uuid":"743842415","full_name":"sijandh35/tileclipper","owner":"sijandh35","description":"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.","archived":false,"fork":false,"pushed_at":"2024-06-04T07:57:48.000Z","size":51,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-12T17:54:36.137Z","etag":null,"topics":["cliptiles","geo","geolocation","gettilesbyboundary","python3","rastertile","tileclipper","tileclippers","tileserver"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/tileclipper/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sijandh35.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-16T05:24:32.000Z","updated_at":"2024-06-03T09:31:22.000Z","dependencies_parsed_at":"2024-01-16T15:46:08.444Z","dependency_job_id":"ffe7d4a2-9e75-49ea-8eb9-7dbfbc9feae1","html_url":"https://github.com/sijandh35/tileclipper","commit_stats":{"total_commits":15,"total_committers":3,"mean_commits":5.0,"dds":0.4666666666666667,"last_synced_commit":"09f77b94eca2b4a5c530f68c27fbf381e0d6b045"},"previous_names":["sijandh35/tileclipper"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sijandh35%2Ftileclipper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sijandh35%2Ftileclipper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sijandh35%2Ftileclipper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sijandh35%2Ftileclipper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sijandh35","download_url":"https://codeload.github.com/sijandh35/tileclipper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248610396,"owners_count":21132920,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cliptiles","geo","geolocation","gettilesbyboundary","python3","rastertile","tileclipper","tileclippers","tileserver"],"created_at":"2025-04-12T17:54:40.035Z","updated_at":"2025-04-12T17:54:40.445Z","avatar_url":"https://github.com/sijandh35.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"### TileClipper Package Usage Guide\n\n#### Introduction\n\nThe `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.\n\n#### Installation\n\nEnsure Python is installed on your system, then install the `TileClipper` package using `pip`:\n\n```sh\npip install tileclipper\n```\n\n\n```python\nfrom tileclipper import TileClipper\n```\n\n#### Instantiate TileClipper\n\nDefine the required parameters for the TileClipper class:\n\n    base_url (str): Base URL of the tile server.\n    bbox (list): Bounding box coordinates [minx, miny, maxx, maxy].\n    output_folder (str): Directory to save downloaded tiles.\n    max_workers (int, optional): Maximum number of concurrent workers for tile downloads (default is 10).\n\nCreate an instance of the TileClipper class:\n\n```python\n\nbase_url = \"https://example.com/tiles/\"  # Replace with your tile server URL\nbbox = [xmin, ymin, xmax, ymax]  # Replace with bounding box coordinates\noutput_folder = \"/path/to/output/folder/\"  # Replace with output folder path\nmax_workers = 10  # Optional: Set maximum workers for concurrent downloads\n\ntileclipper = TileClipper(base_url, bbox, output_folder, max_workers)\n\n```\n\nDownload Tiles\n\nUtilize the download_tiles(zoom_start, zoom_end) method to download tiles within a specified zoom level range:\n\n```python\n\n    # Download tiles within zoom level range 18 to 20\n    tileclipper.download_tiles(18, 20)\n\n```\n\nExample\n\nHere's an example demonstrating the usage of the TileClipper class:\n\n```python\n\nfrom tileclipper import TileClipper\n\nbase_url = \"https://example.com/tiles/\"\nbbox = [xmin, ymin, xmax, ymax]\noutput_folder = \"/path/to/output/folder/\"\nmax_workers = 10\n\ntileclipper = TileClipper(base_url, bbox, output_folder, max_workers)\ntileclipper.download_tiles(18, 20)\n    \n```\n\nReplace the placeholder values (base_url, bbox, output_folder, etc.) with your specific values according to your use case.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsijandh35%2Ftileclipper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsijandh35%2Ftileclipper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsijandh35%2Ftileclipper/lists"}