EEDAI-谷歌地球引擎数据API图片

司机简称

EEDAI

2.4 新版功能.

生成依赖项

利勃曲尔

该驱动程序支持使用Google Earth引擎REST API访问图像内容的只读操作。

驱动程序功能

Supports Georeferencing

This driver supports georeferencing

数据集名称语法

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

EEDAI:[asset][:band_names]

其中asset类似于projects/earthingine public/assets/COPERNICUS/S2/20170430T190351_20170430T190351_T10SEG,band_命名一个逗号分隔的波段名称列表(通常由主图像上的子数据集指示)

打开选项

以下打开选项可用:

  • ASSET =string:如果未在连接字符串中指定,则指定资源。

  • BANDS =波段名称1 [,带宽] *:以逗号分隔的标注栏名称列表。

  • PIXEL_ENCODING =AUTO/PNG/JPEG/AUTO_JPEG_PNG/GEO_TIFF/NPY:请求像素的格式。

  • BLOCK_SIZE =integer:GDAL块的大小,是查询像素的最小单位。默认值为256。

身份验证方法

可以使用以下身份验证方法:

  • 身份验证承载头通过EEDA承载或EEDA承载文件配置选项传递。

  • 服务帐户私钥文件,通过GOOGLE_APPLICATION_CREDENTIALS配置选项。

  • OAuth2通过EEDA_PRIVATE_KEY/EEDA_PRIVATE_KEY_FILE+EEDA_CLIENT_电子邮件配置选项进行服务帐户身份验证。

  • 最后,如果上述方法均未成功,代码将检查当前计算机是否是Google计算引擎实例,如果是,则使用与其关联的权限(使用与VM关联的默认服务帐户)。要强制将计算机检测为GCE实例(例如,在无法访问引导日志的容器中运行的代码),可以将CPL_machine_IS_GCE设置为YES。

配置选项

以下配置选项可用:

  • EEDA_BEARER =value:要传递给API的身份验证承载值。此选项仅在令牌由外部代码计算时才有用。持票人的有效期通常为自被请求之时起一小时。

  • EEDA_BEARER_FILE =filename:与EEDA_BEARER选项类似,除了不是直接传递值,而是应该读取值的文件名。

  • GOOGLE_APPLICATION_CREDENTIALS =file.json:包含私钥和客户端电子邮件的服务帐户私钥文件

  • EEDA_PRIVATE_KEY =string:RSA私钥,编码为PKCS#8pem文件,带有页眉和页脚。与EEDA_CLIENT_电子邮件一起使用OAuth2服务帐户身份验证。需要针对libcrypto++或libssl构建GDAL。

  • EEDA_PRIVATE_KEY_FILE =filename:与EEDA_PRIVATE_KEY选项类似,除了不是直接传递值,而是应该读取密钥的文件名。

  • EEDA_CLIENT_EMAIL =字符串:要与EEDA_PRIVATE_KEY/EEDA_PRIVATE_KEY_文件一起指定电子邮件以使用OAuth2服务帐户身份验证。

概览

驱动程序按照2个因子的幂递减逻辑公开概览,直到最小概览的两个维度都低于256像素。

子数据集

当所有波段没有相同的地理参考、分辨率、CRS或图像尺寸时,驱动程序将公开子数据集。每个子数据集将具有相同维度、范围、分辨率和CRS的频带组合在一起。

元数据

驱动程序将“属性”中报告的元数据公开为数据集级或带级元数据。

像素编码

默认情况下(PIXEL_ENCODING=AUTO),驱动程序将以与频带数和数据类型兼容的格式请求像素。PNG、JPEG和AUTO-JPEG-PNG只能与Byte类型的频带一起使用。

实例

获取图像的元数据:

gdalinfo "EEDAI:" -oo ASSET=projects/earthengine-public/assets/COPERNICUS/S2/20170430T190351_20170430T190351_T10SEG --config EEDA_CLIENT_EMAIL "my@email" --config EEDA_PRIVATE_KEY_FILE my.pem

gdalinfo "EEDAI:projects/earthengine-public/assets/COPERNICUS/S2/20170430T190351_20170430T190351_T10SEG" --config EEDA_CLIENT_EMAIL "my@email" --config EEDA_PRIVATE_KEY_FILE my.pem

也见