Python自动下载影像?API接口怎么调?

别再手动点下载了！Python+API自动抓取遥感影像的实战指南

你是不是也经历过这种崩溃时刻：项目紧急，需要下载上百景Landsat影像，结果手动点击、登录、选范围、等队列……一整天就耗在浏览器前？更别说半夜服务器抽风，下载中断还得从头再来。别慌——今天我就手把手教你用Python调用API，把重复劳动交给代码，你只管喝咖啡看结果。

为什么API是遥感工程师的“外挂”？

API（Application Programming Interface）不是什么玄学，它就像你和卫星数据平台之间的“智能电话接线员”。你不用亲自跑数据中心，只需告诉它：“我要某地某时的Sentinel-2数据”，它就打包好发给你。我在参与全国生态红线评估项目时，靠这套方法一周内拉取了3000+景影像，效率提升20倍不止。

举个生活化类比：手动下载像去超市一件件挑商品结账；API调用则是打电话给超市经理：“老规矩，A区货架所有商品送到我家”，然后坐等快递上门。

主流遥感API哪家强？选对工具少踩坑

不同平台API设计风格迥异，新手容易在文档里迷路。根据我的踩坑经验，推荐这三个“开箱即用”的选择：

手把手教学：用Python三步拿下USGS Landsat数据

以USGS为例，展示如何用landsatxplore库实现自动化（其他平台逻辑类似）。先安装依赖：

pip install landsatxplore

接着三步走：

1. 登录认证：用你的EarthExplorer账号生成API密钥（非密码！）
2. 定义搜索条件：经纬度范围、时间窗口、云量阈值
3. 批量下载：自动跳过已存在文件，断点续传

完整代码如下（关键注释已标出）：

from landsatxplore.api import API
from landsatxplore.earthexplorer import EarthExplorer

# Step 1: 登录认证（替换你的账号密码）
api = API(username='YOUR_USGS_USERNAME', password='YOUR_PASSWORD')
ee = EarthExplorer(username='YOUR_USGS_USERNAME', password='YOUR_PASSWORD')

# Step 2: 搜索2023年北京海淀区云量<10%的Landsat 8数据
scenes = api.search(
    dataset='landsat_ot_c2_l2',  # 数据集ID
    latitude=39.99, 
    longitude=116.31,
    start_date='2023-01-01',
    end_date='2023-12-31',
    max_cloud_cover=10
)

print(f'找到{len(scenes)}景符合条件的数据')

# Step 3: 下载到本地目录（自动跳过已下载文件）
for scene in scenes:
    print(f'正在下载: {scene["display_id"]}')
    ee.download(scene_id=scene['entity_id'], output_dir='./LandsatData/')

api.logout()
ee.logout()

避坑指南：那些让我凌晨三点改代码的报错

• 报错“HTTP 429 Too Many Requests”：USGS限制每分钟5次请求。解决方案：在循环中加入time.sleep(15)。
• 下载速度慢如蜗牛：改用aria2多线程下载器，速度提升300%（文末评论区我分享配置脚本）。
• 文件名乱码：Windows用户务必在脚本开头加# -*- coding: utf-8 -*-。

进阶技巧：让代码更“聪明”的三个心法

真正的自动化不是写死参数，而是动态适应需求：

1. 用GeoJSON代替经纬度：复杂边界直接读取矢量文件，避免手动计算bbox。
2. 失败重试机制：网络波动时自动重试3次，避免半夜被报警电话吵醒。
3. 邮件通知完成：下载结束自动发邮件，躺着收成果（需配置SMTP）。

现在轮到你了！

看完这篇，你应该能独立搭建基础下载流水线。但真实项目远比示例复杂——比如如何处理哨兵数据的分块下载？怎样用GEE API直接导出NDVI而非原始影像？

在评论区留下你最想自动化的数据源（比如“高分六号”或“MODIS”），我会选出三个需求，在下期视频中演示定制化脚本！