公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
Method: projects.video.export
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
启动一个批处理,用于计算视频并将结果写入多个目的地之一。
HTTP 请求
POST https://earthengine.googleapis.com/v1/{project=projects/*}/video:export
网址采用 gRPC 转码语法。
路径参数
参数 |
project |
string
应被视为此请求的服务使用方的 Google Cloud Platform 项目的项目 ID 或项目编号。格式为 projects/{project-id} 。
必须对指定的资源 project 具有以下 IAM 权限才能进行授权:
earthengine.exports.create
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"expression": {
object (Expression )
},
"description": string,
"videoOptions": {
object (VideoOptions )
},
"fileExportOptions": {
object (VideoFileExportOptions )
},
"requestId": string,
"workloadTag": string,
"priority": integer
} |
字段 |
expression |
object (Expression )
一个表达式,其求值为要计算和导出的视频,表示为图片集合。
|
description |
string
任务的直观易懂的名称。
|
videoOptions |
object (VideoOptions )
用于描述要生成的视频的基本选项。
|
fileExportOptions |
object (VideoFileExportOptions )
用于选择视频的导出位置和格式的选项。
|
requestId |
string
用于检测重复请求的唯一字符串。如果同一用户发出多个包含相同非空 requestId 的请求,则其中只有一个请求可以成功启动长时间运行的操作。requestId 可以包含字符 a..z、A..Z、0-9 或“-”。requestId 的长度不得超过 60 个字符。
|
workloadTag |
string
用户提供的用于跟踪此计算的标签。
|
priority |
integer
可选。项目中导出任务的优先级。系统会更早地安排优先级较高的任务。必须是介于 0 到 9999 之间的整数。如果未设置,则默认为 100。
|
响应正文
如果成功,则响应正文包含一个 Operation
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/devstorage.full_control
如需了解详情,请参阅 OAuth 2.0 Overview。
VideoFileExportOptions
用于将视频导出为 Earth Engine 外部文件的选项。
JSON 表示法 |
{
"fileFormat": enum (VideoFileFormat ),
// Union field destination can be only one of the following:
"driveDestination": {
object (DriveDestination )
},
"cloudStorageDestination": {
object (CloudStorageDestination )
}
// End of list of possible types for union field destination .
} |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eInitiates a batch process to compute and export a video based on an Earth Engine image collection.\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify the export destination, format (currently only MP4), and priority of the task.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific IAM permissions and OAuth scopes for authorization.\u003c/p\u003e\n"],["\u003cp\u003eThe API uses a POST request to \u003ccode\u003ehttps://earthengine.googleapis.com/v1/{project=projects/*}/video:export\u003c/code\u003e with defined request and response structures.\u003c/p\u003e\n"],["\u003cp\u003eProvides options to customize the video generation process through \u003ccode\u003evideoOptions\u003c/code\u003e and export parameters through \u003ccode\u003efileExportOptions\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: projects.video.export\n\nInitiates a batch process that computes a video and writes the result to one of several destinations.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1/{project=projects/*}/video:export`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `project` | `string` The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is `projects/{project-id}`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `project`: - `earthengine.exports.create` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"expression\": { object (/earth-engine/reference/rest/v1/Expression) }, \"description\": string, \"videoOptions\": { object (/earth-engine/reference/rest/v1/projects.locations.videoThumbnails#VideoThumbnail.VideoOptions) }, \"fileExportOptions\": { object (/earth-engine/reference/rest/v1/projects.video/export#VideoFileExportOptions) }, \"requestId\": string, \"workloadTag\": string, \"priority\": integer } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1/Expression)`)` An expression that evaluates to the video to compute and export, represented as an image collection. |\n| `description` | `string` A human-readable name of the task. |\n| `videoOptions` | `object (`[VideoOptions](/earth-engine/reference/rest/v1/projects.locations.videoThumbnails#VideoThumbnail.VideoOptions)`)` Basic options describing the video to generate. |\n| `fileExportOptions` | `object (`[VideoFileExportOptions](/earth-engine/reference/rest/v1/projects.video/export#VideoFileExportOptions)`)` Options for where and in what form to export the video. |\n| `requestId` | `string` A unique string used to detect duplicated requests. If more than one request is made by the same user with the same non-empty `requestId`, only one of those requests may successfully start a long-running operation. `requestId` may contain the characters a..z, A..Z, 0-9, or '-'. `requestId` may be at most 60 characters long. |\n| `workloadTag` | `string` User supplied label to track this computation. |\n| `priority` | `integer` Optional. The priority of the export task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100 if not set. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/earth-engine/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/devstorage.full_control`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nVideoFileExportOptions\n----------------------\n\nOptions for exporting videos as files outside Earth Engine.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"fileFormat\": enum (/earth-engine/reference/rest/v1/projects.locations.videoThumbnails#VideoThumbnail.VideoFileFormat), // Union field `destination` can be only one of the following: \"driveDestination\": { object (/earth-engine/reference/rest/v1/DriveDestination) }, \"cloudStorageDestination\": { object (/earth-engine/reference/rest/v1/CloudStorageDestination) } // End of list of possible types for union field `destination`. } ``` |\n\n| Fields ||\n|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileFormat` | `enum (`[VideoFileFormat](/earth-engine/reference/rest/v1/projects.locations.videoThumbnails#VideoThumbnail.VideoFileFormat)`)` The file format in which to export the video(s). Currently only MP4 is supported. |\n| Union field `destination`. Where to write the results. `destination` can be only one of the following: ||\n| `driveDestination` | `object (`[DriveDestination](/earth-engine/reference/rest/v1/DriveDestination)`)` If specified, configures export to Google Drive. |\n| `cloudStorageDestination` | `object (`[CloudStorageDestination](/earth-engine/reference/rest/v1/CloudStorageDestination)`)` If specified, configures export to Google Cloud Storage. |"]]