跳转到主要内容

XYZ瓦片提供商的来源

项目描述

xyzservices - XYZ瓦片提供商的来源

xyzservices是一个轻量级库,提供了一个提供可用的XYZ服务的仓库,这些服务提供栅格底图瓦片。仓库通过Python API以及压缩的JSON文件提供。

XYZ瓦片可以用作地图的背景,提供必要的空间上下文。xyzservices提供了许多瓦片服务的规范,并提供了易于使用的工具将它们连接到您的工作中,无论是交互式还是静态的。

Tests codecov PyPi

快速入门

使用xyzservices很简单,在大多数情况下不需要超过一行代码。

安装

您可以从condapip安装xyzservices

conda install xyzservices -c conda-forge
pip install xyzservices

此软件包不依赖于Python内置之外的其他任何软件。

提供商API

xyzservices的关键部分是提供商

>>> import xyzservices.providers as xyz

xyzservices.providers 或简称 xyz,是一个提供者集合,一个增强的 dict。如果你在 Jupyter 类的环境中,xyz 会提供可折叠的 XYZ 瓦片来源目录。你也可以使用 xyz.keys() 作为标准 dict 来探索它。一旦你选择了提供者,你将获得一个包含所有所需信息的 TileProvider 对象。

>>> xyz.CartoDB.Positron.url
'https://{s}.basemaps.cartocdn.com/{variant}/{z}/{x}/{y}{r}.png'

>>> xyz.CartoDB.Positron.attribution
'(C) OpenStreetMap contributors (C) CARTO'

你还可以检查 TileProvider 是否需要 API 令牌,并在需要时将其传递给对象。

>>> xyz.MapBox.requires_token()
True

>>> xyz.MapBox["accessToken"] = "my_personal_token"
>>> xyz.MapBox.requires_token()
False

提供者 JSON

安装后,你可以在 share/xyzservices/providers.json 中找到用作提供者数据库的 JSON,如果你想在 Python 生态系统之外使用它。

贡献者

xyzservices 由一群热情的志愿者开发,并位于 geopandas GitHub 组织下。你可以在这里查看贡献者完整列表 这里

主要提供者组来自包含公开可访问提供者和需要注册的提供者的 leaflet-providers 项目。所有这些都被认为是 免费

如果你想为项目做出贡献,请查看 开放问题 列表,特别是那些标记为 良好初学者问题 的。

许可协议

BSD 3-Clause License

来自 leaflet-providers 项目 的资源根据 BSD 2-Clause License 许可(© 2013 Leaflet Providers)。

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码分发

xyzservices-2024.9.0.tar.gz (1.1 MB 查看哈希值)

上传时间 源代码

构建分发

xyzservices-2024.9.0-py3-none-any.whl (85.1 kB 查看哈希值)

上传时间 Python 3

由以下支持