Planetary Computer APIs 安装与配置指南

1. 项目基础介绍

Planetary Computer APIs 是由 Microsoft 开发的一个开源项目，旨在通过提供地理空间数据索引和访问的API，帮助用户轻松地搜索、访问和可视化大规模的地理空间数据。该项目主要使用 Python 编程语言实现。

2. 项目使用的关键技术和框架

• STAC API: SpatioTemporal Asset Catalog (STAC) API 是一个用于索引和搜索地理空间数据的标准。
• FastAPI: 一个现代、快速（高性能）的 Web 框架，用于构建 API，具有 Python 3.6+ 类型提示。
• Titiler: 一个基于 STAC API 的瓦片生成库。
• PostgreSQL: 一个功能强大的开源关系型数据库系统。
• Docker: 容器化平台，用于打包和运行应用。
• Helm: Kubernetes 的包管理工具，用于打包和配置应用。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统满足以下要求：

• Python 3.6 或更高版本
• Docker 和 Docker Compose
• Kubernetes 集群（推荐使用 Azure Kubernetes Service）

安装步骤

步骤 1: 克隆项目仓库

首先，您需要在本地克隆项目仓库：

git clone https://github.com/microsoft/planetary-computer-apis.git
cd planetary-computer-apis

步骤 2: 设置环境变量

在开始之前，您需要设置一些环境变量，比如 AZURITE_ACCOUNT_KEY。这个变量可以在项目的 README.md 文件中找到获取方式。

export AZURITE_ACCOUNT_KEY=<your_azurite_account_key>

步骤 3: 构建开发环境

使用以下命令构建开发环境：

./scripts/setup

这个命令会构建所需的 Docker 容器，应用数据库迁移，并加载开发数据。

步骤 4: 运行服务

当开发环境准备好后，您可以使用以下命令启动服务：

./scripts/server

这将启动开发数据库、STAC API、Titiler 和其他服务。

步骤 5: 访问服务

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

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

您也可以直接访问：

• STAC API：http://localhost:8081
• Tiler：http://localhost:8082
• Funcs：http://localhost:8083

请按照上述步骤进行操作，您应该能够成功安装和配置 Planetary Computer APIs。如果您在安装过程中遇到任何问题，请检查项目文档或向维护者寻求帮助。