rio-viz 项目教程

rio-viz 项目教程

rio-vizVisualize Cloud Optimized GeoTIFF in browser项目地址:https://gitcode.com/gh_mirrors/ri/rio-viz

项目介绍

rio-viz 是一个由 developmentseed 开发的 Rasterio 插件，旨在浏览器中可视化 Cloud Optimized GeoTIFF（COG）。该项目允许用户通过简单的命令行接口（CLI）快速启动一个 Web 服务器，以便在浏览器中查看和探索 GeoTIFF 文件。rio-viz 支持多种自定义读取器，并且可以在 Jupyter Notebook 环境中使用。

项目快速启动

安装

首先，确保你已经安装了 pip，然后使用以下命令安装 rio-viz：

pip install rio-viz

启动服务器

安装完成后，你可以使用以下命令启动一个 Web 服务器来查看你的 GeoTIFF 文件：

rio viz path/to/your/file.tif

默认情况下，服务器会在 http://127.0.0.1:8080 上启动，并自动打开一个网页供你浏览文件。如果你只想启动服务器而不打开网页，可以使用 --server-only 选项：

rio viz path/to/your/file.tif --server-only

示例代码

以下是一个简单的示例，展示如何在 Jupyter Notebook 中使用 rio-viz：

import time
import httpx
from folium import Map, TileLayer
from rio_viz.app import Client

# 创建 rio-viz 客户端（使用 server-thread 启动后台任务）
client = Client("https://data.geo.admin.ch/ch.swisstopo.swissalti3d/swissalti3d_2019_2573-1085/swissalti3d_2019_2573-1085_0.5_2056_5728.tif")

# 给服务器一些时间来设置
time.sleep(1)

# 获取 tilejson
r = httpx.get(f"{client.endpoint}/tilejson.json", params={"rescale": "1600,2000", "colormap_name": "terrain"})
data = r.json()

# 获取边界
bounds = data["bounds"]

# 创建地图
m = Map(location=((bounds[1] + bounds[3]) / 2, (bounds[0] + bounds[2]) / 2), zoom_start=data["minzoom"])
aod_layer = TileLayer(tiles=data["tiles"][0], opacity=1, attr="Yo")
aod_layer.add_to(m)
m

应用案例和最佳实践

应用案例

rio-viz 可以用于多种场景，例如：

• 地理数据可视化：在浏览器中快速查看和分析 GeoTIFF 文件。
• 数据共享：通过 Web 服务器共享地理数据，便于团队成员或公众访问。
• 教学和演示：在教学或演示中展示地理数据，无需复杂的 GIS 软件。

最佳实践

• 使用 COG 格式：确保你的 GeoTIFF 文件是 Cloud Optimized GeoTIFF 格式，以获得最佳性能和兼容性。
• 配置选项：根据需要使用 --minzoom、--maxzoom 和 --port 等选项自定义服务器设置。
• 安全考虑：在公共网络中使用时，确保服务器的安全性，避免未授权访问。

典型生态项目

rio-viz 作为 Rasterio 生态系统的一部分，与其他相关项目协同工作，例如：

• Rasterio：一个用于读写栅格数据的 Python 库。
• rio-tiler：一个用于从 COG 文件中读取瓦片的库。
• Folium：一个用于在 Python 中创建交互式地图的库。

这些项目共同构成了一个强大的地理数据处理和可视化工具集，适用于各种地理信息系统（GIS）应用。

rio-vizVisualize Cloud Optimized GeoTIFF in browser项目地址:https://gitcode.com/gh_mirrors/ri/rio-viz