Method: projects.image.import

  • Imports an image into Earth Engine using an HTTP POST request.

  • Requires specifying an image manifest, description, overwrite option, and optional request ID.

  • Users need earthengine.imports.create permission on the specified Google Cloud project.

  • The response includes an Operation object to track the import progress.

  • Authentication requires specific OAuth scopes like https://www.googleapis.com/auth/earthengine or https://www.googleapis.com/auth/cloud-platform.

Imports an image.

HTTP request

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:import

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
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 permission on the specified resource project:

  • earthengine.imports.create

Request body

The request body contains data with the following structure:

JSON representation 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Fields
imageManifest

object (ImageManifest)

The image manifest.
description

string

A human-readable name of the task.
overwrite

boolean

Whether to allow overwriting an existing asset.
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.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the OAuth 2.0 Overview.