Method: projects.image.importExternal

  • The image:importExternal method imports an external image into Earth Engine.

  • It uses a POST request to a URL with gRPC Transcoding syntax.

  • The request requires specifying a Google Cloud Platform project ID with the earthengine.imports.create IAM permission.

  • The request body contains an imageManifest object and an optional overwrite boolean.

  • Successful requests return an empty response body and require either the https://www.googleapis.com/auth/earthengine or https://www.googleapis.com/auth/cloud-platform OAuth scope for authorization.

Imports an external image.

HTTP request

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

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)
  },
  "overwrite": boolean
}
Fields
imageManifest

object (ImageManifest)

The image manifest.
overwrite

boolean

Whether to allow overwriting an existing asset.

Response body

If successful, the response body is empty.

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.