Method: projects.image.import

  • The document describes how to import an image into Earth Engine using a POST request to a specific API endpoint.

  • The request requires a project ID with the earthengine.imports.create permission.

  • The request body includes an imageManifest which details the image structure, as well as optional fields like description, overwrite, and requestId.

  • The ImageManifest contains crucial information such as asset name, properties, tilesets, bands, and spatial/temporal details.

  • Successful requests return an Operation object, and authorization requires specific OAuth scopes.

Imports an image.

HTTP request

POST https://earthengine.googleapis.com/v1beta/{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.