PLScenes（星球实验室场景），数据V1 API

2.2 新版功能.

驱动程序支持只读操作，将场景及其元数据作为矢量层按项目类型列出：“PSOrthoTile”、“reothotile”、“PSScene3Band”、“PSScene4Band”、“REScene”、“Landsat8L1G”、“Sentinel2L1C”。它还可以访问栅格场景。

驱动程序功能

Supports Georeferencing

This driver supports georeferencing

数据集名称语法

打开数据源的最低语法是：

PLScenes:[options]

可以在“：”符号后指定其他可选参数。目前支持以下功能：

版本 =data_v1：指定要请求的API版本。
api_key=value: To specify the Planet API KEY. It is mandatory, unless it is supplied through the open option API_KEY, or the configuration option PL_API_KEY.
follow_links =是/否：是否应为每个场景（向量）遵循资源链接。获取资产链接需要每个场景都有一个HTTP请求，这在枚举大量产品时可能代价高昂。默认为否。
场景 =场景id：在访问栅格数据时指定场景id。矢量层访问可选。
项目类型 =name：指定项类型名称。矢量层访问可选。栅格访问是必需的。
资产 =值：指定资源类型（用于栅格提取）。默认为“可视”。矢量层访问可选。如果未指定该选项，并且场景的“可视”资源类别不存在（或者如果该值设置为“列表”），则返回的数据集将具有可用资源类别的子数据集。
棉田 =是/否：（仅栅格）是否应从API提取场景元数据并附加到栅格数据集。默认为“是”。

如果指定了多个参数，则它们必须用逗号分隔。

打开选项

以下打开选项可用：

VERSION =data_v1：指定要请求的API版本。
API_KEY =value：指定Planet API密钥。
FOLLOW_LINKS =是/否：是否应为每个场景（向量）遵循资源链接。获取资产链接需要每个场景都有一个HTTP请求，这在枚举大量产品时可能代价高昂。默认为否。
SCENE =场景id：在访问栅格数据时指定场景id。矢量层访问可选。
ITEMTYPES =name：指定项类型名称。矢量层访问可选。栅格访问是必需的。
ASSET =值：指定资源类型（用于栅格提取）。默认为“可视”。矢量层访问可选。如果未指定该选项，并且场景的“可视”资源类别不存在（或者如果该值设置为“列表”），则返回的数据集将具有可用资源类别的子数据集。
RANDOM_ACCESS =是/否：是否应以随机访问模式访问栅格（但可能不是最佳吞吐量）。如果没有，则执行内存摄取。默认为“是”。
ACTIVATION_TIMEOUT =int：等待资源激活的秒数（栅格）。默认值为3600。
METADATA =是/否：（仅限栅格）是否应从API获取场景元数据并附加到栅格数据集。默认为“是”。

配置选项

The following configuration options are available:

PL_API_KEY =value: To specify the Planet API KEY.

属性

层字段定义是从GDAL配置中的“plscensconf.json”文件构建的。可下载产品的链接位于 asset_XXXXX_location 属性，其中当它们处于活动状态时，XXXXX是资产类别id。否则，应该通过将POST请求发送到 asset_XXXXX_activate_link 属性（栅格驱动程序自动执行的操作）

几何图形

每个场景的足迹报告为具有经纬度WGS84坐标系（EPSG:4326）的多多边形。

过滤

驱动程序将使用SetSpatialFilter（）将任何空间筛选器集转发到服务器。它还使使用SetAttributeFilter（）设置的简单属性过滤器具有相同的功能。请注意，并非所有属性都支持所有比较运算符。请参阅中的比较器列 Metadata properties

分页

Features are retrieved from the server by chunks of 250 by default (and this is the maximum value accepted by the server). This number can be altered with the PLSCENES_PAGE_SIZE configuration option.

矢量层（场景元数据）示例

列出所有可用场景（具有帐户权限）：

ogrinfo -ro -al "PLScenes:" -oo API_KEY=some_value

或

ogrinfo -ro -al "PLScenes:api_key=some_value"

或

ogrinfo -ro -al "PLScenes:" --config PL_API_KEY some_value

在（lat，lon）=（40，-100）点下列出PSOrthoTile项类型上可用的所有场景：

ogrinfo -ro -al "PLScenes:" -oo API_KEY=some_value PSOrthoTile -spat -100 40 -100 40

列出边界框中可用的所有场景（lat，lon）=（40，-100）到（lat，lon）=（39，-99）

ogrinfo -ro -al "PLScenes:" -oo API_KEY=some_value -spat -100 40 -99 39

列出所有可用的匹配条件：

ogrinfo -ro -al "PLScenes:" -oo API_KEY=some_value PSOrthoTile -where "acquired >= '2015/03/26 00:00:00' AND cloud_cover < 10"

列出所有可下载的场景：

ogrinfo -ro -al -q "PLScenes:" -oo API_KEY=some_value PSOrthoTile -where "permissions='assets:download'"

栅格访问

如果使用“scene”参数/scene open选项指定场景ID，则可以将场景作为栅格数据集访问。还必须指定“itemtypes”参数/itemtypes open选项。可以使用“asset”参数/asset open选项指定资产类型（可视、分析…）。场景id是特征的“id”字段值的内容。

如果该产品尚未在服务器上生成，它将被激活，驱动程序将等待它可用。可以使用激活超时打开选项配置此重试的长度。

栅格访问示例

显示栅格元数据：

gdalinfo "PLScenes:scene=scene_id,itemtypes=itemypes,asset=analytic" -oo API_KEY=some_value

或

gdalinfo "PLScenes:" -oo API_KEY=some_value -oo ITEMTYPES=itemtypes -oo SCENE=scene_id -oo ASSET=analytic

转换/下载整个文件：

gdal_translate "PLScenes:" -oo API_KEY=some_value -oo SCENE=scene_id \
                -oo ITEMTYPES=itemtypes -oo ASSET=analytic -oo RANDOM_ACCESS=NO out.tif