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