<img src="https://raw.githubusercontent.com/altair-viz/altair_tiles/main/doc/logo.svg" height="110"></img>
This package is in an early development stage. You should expect things to break unannounced until we release a version `1.0.0`.
You can use altair_tiles to add tiles from any xyz tile provider such as OpenStreetMap to your Altair chart. It is a counterpart to the amazing [contextily](https://github.com/geopandas/contextily) package which provides this functionality for [matplotlib](https://matplotlib.org/).
You can find the documentation [here](https://vega.github.io/altair_tiles).
For a general introduction to plotting geographic data with Altair, see [Geoshape - Vega-Altair](https://altair-viz.github.io/user_guide/marks/geoshape.html) and [Specifying Data - Vega-Altair](https://altair-viz.github.io/user_guide/data.html#spatial-data).
## Installation
```bash
pip install altair_tiles
```
or
```bash
conda install -c conda-forge altair_tiles
```
altair-tiles requires at least Vega version `5.26.0`. If you use an IDE such as a Jupyter Notebook or VS Code, you usually don't have to worry about this.
## Development
```bash
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
```
Run linters and tests with
```bash
hatch run test
```
Build and view the documentation with
```bash
hatch run doc:clean
hatch run doc:build
hatch run doc:serve
```
To run a clean build and publish, run
```bash
hatch run doc:build-and-publish
```
Raw data
{
"_id": null,
"home_page": null,
"name": "altair_tiles",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "altair, basemaps, tiles",
"author": "altair_tiles contributors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/bc/02/f08b6d605e514226204505487ad139583e1ea858aad563fd9fbd8d617349/altair_tiles-0.4.0.tar.gz",
"platform": null,
"description": "<img src=\"https://raw.githubusercontent.com/altair-viz/altair_tiles/main/doc/logo.svg\" height=\"110\"></img>\n\nThis package is in an early development stage. You should expect things to break unannounced until we release a version `1.0.0`.\n\nYou can use altair_tiles to add tiles from any xyz tile provider such as OpenStreetMap to your Altair chart. It is a counterpart to the amazing [contextily](https://github.com/geopandas/contextily) package which provides this functionality for [matplotlib](https://matplotlib.org/).\n\nYou can find the documentation [here](https://vega.github.io/altair_tiles). \n\nFor a general introduction to plotting geographic data with Altair, see [Geoshape - Vega-Altair](https://altair-viz.github.io/user_guide/marks/geoshape.html) and [Specifying Data - Vega-Altair](https://altair-viz.github.io/user_guide/data.html#spatial-data).\n\n## Installation\n```bash\npip install altair_tiles\n```\nor\n```bash\nconda install -c conda-forge altair_tiles\n```\n\naltair-tiles requires at least Vega version `5.26.0`. If you use an IDE such as a Jupyter Notebook or VS Code, you usually don't have to worry about this.\n\n## Development\n```bash\npython -m venv .venv\nsource .venv/bin/activate\npip install -e '.[dev]'\n```\n\nRun linters and tests with\n```bash\nhatch run test\n```\n\nBuild and view the documentation with\n```bash\nhatch run doc:clean\nhatch run doc:build\nhatch run doc:serve\n```\n\nTo run a clean build and publish, run\n```bash\nhatch run doc:build-and-publish\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "altair_tiles",
"version": "0.4.0",
"project_urls": {
"Source": "https://github.com/altair-viz/altair_tiles"
},
"split_keywords": [
"altair",
" basemaps",
" tiles"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c8a7a597ff7dd1e1603abd94991ce242f93979d5f10b0d45ed23976dfb22bf64",
"md5": "a68614f40daa139c4c52b8763780b379",
"sha256": "eeed1a6d89800f6cf5aafa6a59ee735bc7c243cd133acebccabfdbf69cc7e33c"
},
"downloads": -1,
"filename": "altair_tiles-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a68614f40daa139c4c52b8763780b379",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 9054,
"upload_time": "2025-02-06T18:35:30",
"upload_time_iso_8601": "2025-02-06T18:35:30.998757Z",
"url": "https://files.pythonhosted.org/packages/c8/a7/a597ff7dd1e1603abd94991ce242f93979d5f10b0d45ed23976dfb22bf64/altair_tiles-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bc02f08b6d605e514226204505487ad139583e1ea858aad563fd9fbd8d617349",
"md5": "e3101c43594dac48c527bb2fb6636245",
"sha256": "c262a00baad4f37966be9490fc014db0dd7c15c6e98c7cf3cfa5492abb867961"
},
"downloads": -1,
"filename": "altair_tiles-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "e3101c43594dac48c527bb2fb6636245",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 9537,
"upload_time": "2025-02-06T18:35:28",
"upload_time_iso_8601": "2025-02-06T18:35:28.030568Z",
"url": "https://files.pythonhosted.org/packages/bc/02/f08b6d605e514226204505487ad139583e1ea858aad563fd9fbd8d617349/altair_tiles-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-06 18:35:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "altair-viz",
"github_project": "altair_tiles",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "altair_tiles"
}
JSON
