USGS LandsatXPlore API 初始化失败的解决方案-Python教程-PHP中文网

USGS LandsatXPlore API 初始化失败的解决方案

landsatxplore 库已停止维护，其基于用户名/密码的认证方式与 USGS 2025 年起启用的 Token 认证机制不兼容，导致初始化失败及“Invalid Endpoint”错误。

`landsatxplore` 库已停止维护，其基于用户名/密码的认证方式与 usgs 2025 年起启用的 token 认证机制不兼容，导致初始化失败及“invalid endpoint”错误。

USGS 自 2025 年 2 月起全面停用旧版基于账号密码的 API 认证流程，转而强制采用基于 OAuth 2.0 的 Token 认证机制（通过 Earth Explorer 或 API Key Portal 获取长期有效的 API Key）。而 landsatxplore（v0.15.0 及更早版本）仍尝试调用已下线的 /login 和 /dataset-catalogs 等 Legacy Endpoints，因此触发 NOT_FOUND: Invalid Endpoint 错误——该错误本质是服务端拒绝响应过时路径，而非客户端代码语法问题。

✅ 推荐替代方案：使用官方 usgs 客户端或直接调用 USGS EROS API

目前最稳定、官方支持的方式是使用 USGS 官方维护的 usgs Python 包（注意：非 landsatxplore），它已适配新版 Token 认证：

pip install usgs

from usgs import api

# 使用从 https://www.php.cn/link/0511a2f27352eb5e146e51b92758cd10 获取的 API Key（非密码！）
api_key = "YOUR_API_KEY_HERE"  # 长度约 64 位的十六进制字符串

# 初始化（无需用户名/密码）
api.login(api_key)

# 查询数据集目录（新版 endpoint）
response = api.dataset_list()
print("Available datasets:", [ds['datasetName'] for ds in response])

# 示例：搜索 Landsat Collection 2 场景
results = api.scene_search(
    dataset='LANDSAT_8_C2_L2',
    latitude=37.7749,
    longitude=-122.4194,
    start_date='2023-01-01',
    end_date='2023-12-31',
    max_results=5
)
print(f"Found {len(results)} scenes")

⚠️ 重要注意事项：

API Key 必须通过 USGS Earthdata Login Portal 注册并生成，不可复用旧密码；
landsatxplore 已归档（Archived），GitHub 仓库标记为 read-only，不再接受 PR 或修复（见 issue #126）；
若必须沿用 landsatxplore，可临时降级至 v0.14.0 并配合代理/缓存（不推荐，存在安全与稳定性风险）；
所有请求需遵守 USGS API 使用条款，包括速率限制（默认 10 req/sec）和引用要求。