{"id":28957204,"url":"https://github.com/developmentseed/aiopmtiles","last_synced_at":"2025-06-23T21:41:46.697Z","repository":{"id":153645419,"uuid":"626922054","full_name":"developmentseed/aiopmtiles","owner":"developmentseed","description":"[WIP] PMTiles Async reader in python","archived":false,"fork":false,"pushed_at":"2024-01-10T17:24:15.000Z","size":7023,"stargazers_count":23,"open_issues_count":2,"forks_count":3,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-04-10T03:11:32.074Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://developmentseed.org/aiopmtiles/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/developmentseed.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-04-12T12:32:55.000Z","updated_at":"2024-04-08T01:38:57.000Z","dependencies_parsed_at":"2023-05-29T01:00:29.242Z","dependency_job_id":null,"html_url":"https://github.com/developmentseed/aiopmtiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/developmentseed/aiopmtiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Faiopmtiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Faiopmtiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Faiopmtiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Faiopmtiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/developmentseed","download_url":"https://codeload.github.com/developmentseed/aiopmtiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2Faiopmtiles/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261561491,"owners_count":23177616,"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":[],"created_at":"2025-06-23T21:41:46.146Z","updated_at":"2025-06-23T21:41:46.677Z","avatar_url":"https://github.com/developmentseed.png","language":"Python","readme":"# aiopmtiles\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eAsync Version of Python PMTiles Reader.\u003c/em\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/developmentseed/aiopmtiles/actions?query=workflow%3ACI\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://github.com/developmentseed/aiopmtiles/workflows/CI/badge.svg\" alt=\"Test\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/developmentseed/aiopmtiles\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://codecov.io/gh/developmentseed/aiopmtiles/branch/main/graph/badge.svg\" alt=\"Coverage\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/aiopmtiles\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/v/aiopmtiles?color=%2334D058\u0026label=pypi%20package\" alt=\"Package version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypistats.org/packages/aiopmtiles\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/pypi/dm/aiopmtiles.svg\" alt=\"Downloads\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/developmentseed/aiopmtiles/blob/main/LICENSE\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/developmentseed/aiopmtiles.svg\" alt=\"Downloads\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n**Documentation**: \u003ca href=\"https://developmentseed.org/aiopmtiles/\" target=\"_blank\"\u003ehttps://developmentseed.org/aiopmtiles/\u003c/a\u003e\n\n**Source Code**: \u003ca href=\"https://github.com/developmentseed/aiopmtiles\" target=\"_blank\"\u003ehttps://github.com/developmentseed/aiopmtiles\u003c/a\u003e\n\n---\n\n`aiopmtiles` is a python `Async I/O` version of the great [PMTiles](https://github.com/protomaps/PMTiles) python reader.\n\nThe [**PMTiles**](https://github.com/protomaps/PMTiles) format is a *Cloud-optimized + compressed single-file tile archives for vector and raster maps*.\n\n## Installation\n\n```bash\n$ python -m pip install pip -U\n\n# From Pypi\n$ python -m pip install aiopmtiles\n\n# Or from source\n$ python -m pip install git+http://github.com/developmentseed/aiopmtiles\n```\n\n## Example\n\n```python\n\nfrom aiopmtiles import Reader\n\nasync with Reader(\"https://r2-public.protomaps.com/protomaps-sample-datasets/cb_2018_us_zcta510_500k.pmtiles\") as src:\n    # PMTiles Metadata\n    meta = src.metadata\n\n    # Spatial Metadata\n    bounds = src.bounds\n    minzoom, maxzoom = src.minzoom, src.maxzoom\n\n    # Is the data a Vector Tile Archive\n    assert src.is_vector\n\n    # PMTiles tiles type\n    tile_type = src._header[\"tile_type\"]\n\n    # Tile Compression\n    comp = src.tile_compression\n\n    # Get Tile\n    data = await src.get_tile(0, 0, 0)\n```\n\n## Contribution \u0026 Development\n\nSee [CONTRIBUTING.md](https://github.com/developmentseed/aiopmtiles/blob/main/CONTRIBUTING.md)\n\n## Authors\n\nSee [contributors](https://github.com/developmentseed/aiopmtiles/graphs/contributors)\n\n## Changes\n\nSee [CHANGES.md](https://github.com/developmentseed/aiopmtiles/blob/main/CHANGES.md).\n\n## License\n\nSee [LICENSE](https://github.com/developmentseed/aiopmtiles/blob/main/LICENSE)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Faiopmtiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevelopmentseed%2Faiopmtiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Faiopmtiles/lists"}