Planetary Computer APIs 使用教程

1. 项目介绍

Planetary Computer APIs 是由 Microsoft 开发的一个开源项目，旨在通过提供地理空间数据的 STAC API 和 Tiler 功能，使得用户能够轻松地索引、搜索、访问和可视化大量的地理空间数据。本项目是基于开源的 stac-fastapi 和 titiler 项目，并通过 titiler-pgstac 连接了数据瓦片和数据库。

2. 项目快速启动

以下是一个快速启动 Planetary Computer APIs 的指南：

首先，确保您的系统已安装了 docker-compose v1.27 或更高版本。

环境设置和构建镜像

在设置本地环境之前，您需要设置 AZURITE_ACCOUNT_KEY 环境变量。这可以通过以下命令完成：

export AZURITE_ACCOUNT_KEY=$(curl -s https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azurite | grep "Account key:" | cut -b 24-111)

接着，运行以下脚本设置本地环境：

./scripts/setup

此脚本将构建容器、应用数据库迁移并加载开发数据。

之后，如果需要重新构建 docker 镜像，可以运行：

./scripts/update

运行服务

使用以下命令来启动服务：

./scripts/server

这将启动开发数据库、STAC API、Tiler、Azure Functions 以及其他服务。

服务启动后，您可以通过以下 URL 访问：

• STAC API (通过 nginx)：http://localhost:8080/stac/
• Tiler (通过 nginx)：http://localhost:8080/data/
• Funcs (通过 nginx)：http://localhost:8080/f/image

3. 应用案例和最佳实践

索引和搜索地理空间数据

使用 STAC API 可以索引 Microsoft 公开可用的地理空间数据，并提供搜索这些大数据集的 API。

数据可视化和访问

通过 Tiler，您可以实现对数据的可视化展示和数据访问。例如，您可以访问以下 URL 来获取一个图块信息：

http://localhost:8080/data/mosaic/info?collection=naip

请注意，由于缺乏授权头，这个请求可能会失败。

4. 典型生态项目

Planetary Computer APIs 的生态系统中，有一些典型的项目包括：

• Helm 图表：用于在 Kubernetes 上部署 Planetary Computer API 服务的 Helm 图表。
• Azure Functions：提供额外的端点，用于基于 STAC 搜索生成图像和动画。

以上是 Planetary Computer APIs 的基础使用教程，希望对您有所帮助。