PLMosaic（行星实验室马赛克API）

司机简称

PLMosaic

生成依赖项

利勃曲尔

这个驱动程序可以连接到Planet Labs马赛克API。为了编译PLMosaic驱动程序，必须使用Curl支持构建GDAL/OGR。

驱动程序支持列出马赛克并读取它们。马赛克是以最高分辨率访问的。马赛克通常由4096x4096像素的四边形组成。

对于Byte类型的马赛克，可以使用tile API查看概述。对于其他数据类型，不支持概述，因此涉及降采样的请求可能需要很长时间才能完成。

驱动程序功能

Supports Georeferencing

This driver supports georeferencing

数据集名称语法

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

PLMosaic:[options]

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

api_key =value：指定Planet API密钥。它是必需的，除非通过打开选项API_密钥或配置选项PL_API_密钥提供。
镶嵌图 =马赛克名称：指定马赛克名称。
cache_path =path：指定存储缓存四元（和平铺）的目录的路径。将在该路径下创建plmosaic_cache/{mosaic_name}子目录。空字符串可用于禁用任何磁盘缓存。
trust_cache =是/否：是否应直接重用已缓存的四元文件，而不必事先检查服务器是否具有较新版本。注意：这只适用于四边形，而不适用于平铺。默认为否。
use_tiles =是/否：是否使用tile API来访问全分辨率数据，而不是下载quad。只适用于字节马赛克。默认为否。

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

如果没有提供马赛克参数，可用马赛克列表将作为子数据集返回。如果只有一个马赛克可用，它将直接打开。

打开选项

以下打开选项可用：API_KEY、MOSAIC、CACHE_PATH、TRUST_CACHE和USE_TILES。它们的语义与上述描述同名参数的语义相同。

配置选项

以下配置选项可用：

PL_API_KEY =value：指定Planet API密钥。

位置信息

特殊 Pixel_{{x}}_{{y}} 的元数据项 LocationInfo 可以查询元数据域，其中x是列，y是马赛克中的行，以获取有关组成下面四元图的场景的信息。这是gdallocationinfo实用程序使用的语法（请参见 RFC 32:gdallocationinfo实用程序）

下面是返回的示例：

<LocationInfo>
  <Scenes>
    <Scene>
      <link>https://api.planet.com/data/v1/item-types/PSScene3Band/items/20161025_000336_0e19</link>
    </Scene>
    <Scene>
      <link>https://api.planet.com/data/v1/item-types/PSScene3Band/items/20161119_000453_0e14</link>
    </Scene>
    <Scene>
      <link>https://api.planet.com/data/v1/item-types/PSScene3Band/items/20161010_000309_0e26</link>
    </Scene>
    <Scene>
      <link>https://api.planet.com/data/v1/item-types/PSScene3Band/items/20161119_000452_0e14</link>
    </Scene>
  </Scenes>
</LocationInfo>

实例

列出所有可用的马赛克（具有帐户权限）：

gdalinfo "PLMosaic:" -oo API_KEY=some_value

或

gdalinfo "PLMosaic:api_key=some_value"

或

gdalinfo "PLMosaic:" --config PL_API_KEY some_value

返回（如果是多个马赛克）：

Driver: PLMOSAIC/Planet Labs Mosaics API
Files: none associated
Size is 512, 512
Coordinate System is `'
Image Structure Metadata:
  INTERLEAVE=PIXEL
Subdatasets:
  SUBDATASET_1_NAME=PLMOSAIC:mosaic=global_quarterly_2017q1_mosaic
  SUBDATASET_1_DESC=Mosaic global_quarterly_2017q1_mosaic
  ...
Corner Coordinates:
Upper Left  (    0.0,    0.0)
Lower Left  (    0.0,  512.0)
Upper Right (  512.0,    0.0)
Lower Right (  512.0,  512.0)
Center      (  256.0,  256.0)

打开一个特殊的马赛克：

gdalinfo "PLMosaic:mosaic=global_quarterly_2017q1_mosaic" -oo API_KEY=some_value

返回：

Driver: PLMOSAIC/Planet Labs Mosaics API
Files: none associated
Size is 8388608, 4427776
Coordinate System is:
PROJCS["WGS 84 / Pseudo-Mercator",
    GEOGCS["WGS 84",
        DATUM["WGS_1984",
            SPHEROID["WGS 84",6378137,298.257223563,
                AUTHORITY["EPSG","7030"]],
            AUTHORITY["EPSG","6326"]],
        PRIMEM["Greenwich",0,
            AUTHORITY["EPSG","8901"]],
        UNIT["degree",0.0174532925199433,
            AUTHORITY["EPSG","9122"]],
        AUTHORITY["EPSG","4326"]],
    PROJECTION["Mercator_1SP"],
    PARAMETER["central_meridian",0],
    PARAMETER["scale_factor",1],
    PARAMETER["false_easting",0],
    PARAMETER["false_northing",0],
    UNIT["metre",1,
        AUTHORITY["EPSG","9001"]],
    AXIS["X",EAST],
    AXIS["Y",NORTH],
    EXTENSION["PROJ4","+proj=merc +a=6378137 +b=6378137 +lat_ts=0.0 +lon_0=0.0 +x_0=0.0 +y_0=0 +k=1.0 +units=m +nadgrids=@null +wktext +no_defs"],
    AUTHORITY["EPSG","3857"]]
Origin = (-20037508.342789243906736,13384429.400847502052784)
Pixel Size = (4.777314267823516,-4.777314267823516)
Metadata:
  FIRST_ACQUIRED=2017-01-01T00:00:00.000Z
  LAST_ACQUIRED=2017-04-01T00:00:00.000Z
  NAME=global_quarterly_2017q1_mosaic
Image Structure Metadata:
  INTERLEAVE=PIXEL
Corner Coordinates:
Upper Left  (-20037508.343,13384429.401) (180d 0' 0.00"W, 76d 0'57.94"N)
Lower Left  (-20037508.343,-7768448.059) (180d 0' 0.00"W, 57d 2'26.63"S)
Upper Right (20037508.343,13384429.401) (180d 0' 0.00"E, 76d 0'57.94"N)
Lower Right (20037508.343,-7768448.059) (180d 0' 0.00"E, 57d 2'26.63"S)
Center      (       0.000, 2807990.671) (  0d 0' 0.01"E, 24d26'49.74"N)
Band 1 Block=256x256 Type=Byte, ColorInterp=Red
  Overviews: 4194304x4194304, ..., 256x256
  Mask Flags: PER_DATASET ALPHA
  Overviews of mask band: Overviews: 4194304x4194304, ..., 256x256
Band 2 Block=256x256 Type=Byte, ColorInterp=Green
  Overviews: 4194304x4194304, ..., 256x256
  Mask Flags: PER_DATASET ALPHA
  Overviews of mask band: Overviews: 4194304x4194304, ..., 256x256
Band 3 Block=256x256 Type=Byte, ColorInterp=Blue
  Overviews: 4194304x4194304, ..., 256x256
  Mask Flags: PER_DATASET ALPHA
  Overviews of mask band: Overviews: 4194304x4194304, ..., 256x256
Band 4 Block=256x256 Type=Byte, ColorInterp=Alpha
  Overviews: 4194304x4194304, ..., 256x256