用途:帮助用户通过 geoai 库从 Microsoft Planetary Computer 的 STAC 目录搜索并下载卫星影像。
主要能力:列出可用集合(支持关键词过滤);按集合名、bbox 和时间范围(YYYY-MM-DD/YYYY-MM-DD)搜索条目;查看某条目的资产/波段;将搜索结果下载到本地目录。
使用方式:输入 list 或 collections 可列出集合,命令为 python3 -c "import geoai; df = geoai.pc_collection_list(); print(df.to_string())",带过滤时传 filter_by。搜索时调用 geoai.pc_stac_search(collection=..., bbox=[MINX, MINY, MAXX, MAXY], time_range=..., limit=...),默认 limit=10,未指定时间范围可省略或传 None。查看资产用 geoai.pc_item_asset_list(item_id=..., collection=...)。下载用 geoai.pc_stac_download(items, output_dir=...),默认输出目录 ./stac_data/。
适用场景:需要获取卫星影像用于后续分析、裁剪或拼接时。
限制与错误处理:import geoai 失败时建议 pip install geoai-py;集合名无效时列出可用集合并提示最接近项;无结果时建议扩大 bbox、调整日期或换集合;下载失败时报告错误并建议减少条目重试。具体收费、平台支持范围等资料暂未提供。