Google Earth Engine API

  • Earth Engine is a platform designed for geospatial data storage, analysis, and visualization.

  • The service earthengine.googleapis.com is the endpoint for interacting with the Earth Engine platform, and using Google-provided client libraries is recommended for calling this service.

  • Discovery Documents in multiple versions (v1, v1beta, v1alpha) are available to describe the REST APIs for Earth Engine.

  • The Earth Engine API provides various REST resources, such as projects.assets, projects.image, and projects.tables, with methods for managing and processing geospatial data.

  • Many resources offer methods like create, delete, get, and export for interacting with assets, images, tables, maps, and other data types within Earth Engine projects.

Earth Engine is a platform for geospatial data storage, analysis, and visualization.

Service: earthengine.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://earthengine.googleapis.com

REST Resource: v1beta.projects

Methods
getConfig GET /v1beta/{name=projects/*/config}
Gets the config state of a project.
listAssets GET /v1beta/{parent=projects/*}:listAssets
Lists any container asset, such as a folder or collection.
updateConfig PATCH /v1beta/{projectConfig.name=projects/*/config}
Updates the config state of a project.

REST Resource: v1beta.projects.algorithms

Methods
list GET /v1beta/{parent=projects/*}/algorithms
Gets the list of all the algorithms available for use in Expressions.

REST Resource: v1beta.projects.assets

Methods
copy POST /v1beta/{sourceName=projects/*/assets/**}:copy
Copies an asset.
create POST /v1beta/{parent=projects/*}/assets
Creates an asset.
delete DELETE /v1beta/{name=projects/*/assets/**}
Deletes an asset.
get GET /v1beta/{name=projects/*/assets/**}
Gets detailed information about an asset.
getIamPolicy POST /v1beta/{resource=projects/*/assets/**}:getIamPolicy
Gets the access control policy for a resource.
getPixels POST /v1beta/{name=projects/*/assets/**}:getPixels
Fetches pixels from an image asset.
listAssets GET /v1beta/{parent=projects/*/assets/**}:listAssets
Lists any container asset, such as a folder or collection.
listFeatures GET /v1beta/{asset=projects/*/assets/**}:listFeatures
Lists the features in a table asset.
move POST /v1beta/{sourceName=projects/*/assets/**}:move
Moves an asset.
patch PATCH /v1beta/{asset.name=projects/*/assets/**}
Updates an asset.
setIamPolicy POST /v1beta/{resource=projects/*/assets/**}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1beta/{resource=projects/*/assets/**}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1beta.projects.classifier

Methods
export POST /v1beta/{project=projects/*}/classifier:export
Initiates a batch process that computes a classifier and saves it as an Earth Engine asset.

REST Resource: v1beta.projects.featureView

Methods
create POST /v1beta/{parent=projects/*}/featureView
Create a FeatureView.

REST Resource: v1beta.projects.featureViews

Methods
create POST /v1beta/{parent=projects/*}/featureViews
Create a FeatureView.

REST Resource: v1beta.projects.featureViews.tiles

Methods
get GET /v1beta/{parent=projects/*/featureViews/*}/tiles/{zoom}/{x}/{y}
Computes a map tile image showing a portion of a FeatureView.

REST Resource: v1beta.projects.filmstripThumbnails

Methods
create POST /v1beta/{parent=projects/*}/filmstripThumbnails
Creates an ID that can be used to render an image containing multiple images from a collection.
getPixels GET /v1beta/{name=projects/*/filmstripThumbnails/*}:getPixels
Computes an image showing the result of a computation.

REST Resource: v1beta.projects.image

Methods
computePixels POST /v1beta/{project=projects/*}/image:computePixels
Computes a tile of pixels by performing an arbitrary computation on image data.
export POST /v1beta/{project=projects/*}/image:export
Initiates a batch process that computes an image and writes the result to one of several destinations.
import POST /v1beta/{project=projects/*}/image:import
Imports an image.

REST Resource: v1beta.projects.imageCollection

Methods
computeImages POST /v1beta/{project=projects/*}/imageCollection:computeImages
Computes a set of features by applying an arbitrary computation to features in one or more tables.

REST Resource: v1beta.projects.locations.assets

Methods
create POST /v1beta/{parent=projects/*/locations/*}/assets
Creates an asset.

REST Resource: v1beta.projects.locations.filmstripThumbnails

Methods
create POST /v1beta/{parent=projects/*/locations/*}/filmstripThumbnails
Creates an ID that can be used to render an image containing multiple images from a collection.

REST Resource: v1beta.projects.locations.maps

Methods
create POST /v1beta/{parent=projects/*/locations/*}/maps
Creates an ID that can be used to render map tiles showing the results of a computation.

REST Resource: v1beta.projects.locations.tables

Methods
create POST /v1beta/{parent=projects/*/locations/*}/tables
Creates an ID that can be used to render "table" data.

REST Resource: v1beta.projects.locations.thumbnails

Methods
create POST /v1beta/{parent=projects/*/locations/*}/thumbnails
Creates an ID that can be used to render a "thumbnail" image.

REST Resource: v1beta.projects.locations.videoThumbnails

Methods
create POST /v1beta/{parent=projects/*/locations/*}/videoThumbnails
Creates an ID that can be used to render an image containing an animation of multiple images from a collection.

REST Resource: v1beta.projects.map

Methods
export POST /v1beta/{project=projects/*}/map:export
Initiates a batch process that computes a tiled map and writes the result to Google Cloud Storage.

REST Resource: v1beta.projects.maps

Methods
create POST /v1beta/{parent=projects/*}/maps
Creates an ID that can be used to render map tiles showing the results of a computation.

REST Resource: v1beta.projects.maps.tiles

Methods
get GET /v1beta/{parent=projects/*/maps/*}/tiles/{zoom}/{x}/{y}
Computes a map tile image showing a portion of a computation.

REST Resource: v1beta.projects.operations

Methods
cancel POST /v1beta/{name=projects/*/operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1beta/{name=projects/*/operations/**}
Deletes a long-running operation.
get GET /v1beta/{name=projects/*/operations/**}
Gets the latest state of a long-running operation.
list GET /v1beta/{name=projects/*}/operations
Lists operations that match the specified filter in the request.
wait POST /v1beta/{name=projects/*/operations/**}:wait
Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state.

REST Resource: v1beta.projects.table

Methods
computeFeatures POST /v1beta/{project=projects/*}/table:computeFeatures
Computes a set of features by applying an arbitrary computation to features in one or more tables.
export POST /v1beta/{project=projects/*}/table:export
Initiates a batch process that computes a table and writes the result to one of several destinations.
import POST /v1beta/{project=projects/*}/table:import
Imports a table.

REST Resource: v1beta.projects.tables

Methods
create POST /v1beta/{parent=projects/*}/tables
Creates an ID that can be used to render "table" data.
getFeatures GET /v1beta/{name=projects/*/tables/*}:getFeatures
Fetches Table features, the request includes the name of the Table to download from a previous CreateTable request.

REST Resource: v1beta.projects.thumbnails

Methods
create POST /v1beta/{parent=projects/*}/thumbnails
Creates an ID that can be used to render a "thumbnail" image.
getPixels GET /v1beta/{name=projects/*/thumbnails/*}:getPixels
Computes an image showing the result of a computation.

REST Resource: v1beta.projects.value

Methods
compute POST /v1beta/{project=projects/*}/value:compute
Computes an arbitrary value.

REST Resource: v1beta.projects.video

Methods
export POST /v1beta/{project=projects/*}/video:export
Initiates a batch process that computes a video and writes the result to one of several destinations.

REST Resource: v1beta.projects.videoThumbnails

Methods
create POST /v1beta/{parent=projects/*}/videoThumbnails
Creates an ID that can be used to render an image containing an animation of multiple images from a collection.
getPixels GET /v1beta/{name=projects/*/videoThumbnails/*}:getPixels
Computes an image showing the result of a computation.

REST Resource: v1alpha.projects

Methods
getConfig GET /v1alpha/{name=projects/*/config}
Gets the config state of a project.
listAssets GET /v1alpha/{parent=projects/*}:listAssets
Lists any container asset, such as a folder or collection.
updateConfig PATCH /v1alpha/{projectConfig.name=projects/*/config}
Updates the config state of a project.

REST Resource: v1alpha.projects.algorithms

Methods
list GET /v1alpha/{parent=projects/*}/algorithms
Gets the list of all the algorithms available for use in Expressions.

REST Resource: v1alpha.projects.assets

Methods
copy POST /v1alpha/{sourceName=projects/*/assets/**}:copy
Copies an asset.
create POST /v1alpha/{parent=projects/*}/assets
Creates an asset.
delete DELETE /v1alpha/{name=projects/*/assets/**}
Deletes an asset.
get GET /v1alpha/{name=projects/*/assets/**}
Gets detailed information about an asset.
getIamPolicy POST /v1alpha/{resource=projects/*/assets/**}:getIamPolicy
Gets the access control policy for a resource.
getPixels POST /v1alpha/{name=projects/*/assets/**}:getPixels
Fetches pixels from an image asset.
listAssets GET /v1alpha/{parent=projects/*/assets/**}:listAssets
Lists any container asset, such as a folder or collection.
listFeatures GET /v1alpha/{asset=projects/*/assets/**}:listFeatures
Lists the features in a table asset.
listImages GET /v1alpha/{parent=projects/*/assets/**}:listImages
Lists the images in an image collection asset.
move POST /v1alpha/{sourceName=projects/*/assets/**}:move
Moves an asset.
patch PATCH /v1alpha/{asset.name=projects/*/assets/**}
Updates an asset.
setIamPolicy POST /v1alpha/{resource=projects/*/assets/**}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1alpha/{resource=projects/*/assets/**}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1alpha.projects.classifier

Methods
export POST /v1alpha/{project=projects/*}/classifier:export
Initiates a batch process that computes a classifier and saves it as an Earth Engine asset.

REST Resource: v1alpha.projects.featureView

Methods
create POST /v1alpha/{parent=projects/*}/featureView
Create a FeatureView.

REST Resource: v1alpha.projects.featureViews

Methods
create POST /v1alpha/{parent=projects/*}/featureViews
Create a FeatureView.

REST Resource: v1alpha.projects.featureViews.tiles

Methods
get GET /v1alpha/{parent=projects/*/featureViews/*}/tiles/{zoom}/{x}/{y}
Computes a map tile image showing a portion of a FeatureView.

REST Resource: v1alpha.projects.filmstripThumbnails

Methods
create POST /v1alpha/{parent=projects/*}/filmstripThumbnails
Creates an ID that can be used to render an image containing multiple images from a collection.
getPixels GET /v1alpha/{name=projects/*/filmstripThumbnails/*}:getPixels
Computes an image showing the result of a computation.

REST Resource: v1alpha.projects.image

Methods
computePixels POST /v1alpha/{project=projects/*}/image:computePixels
Computes a tile of pixels by performing an arbitrary computation on image data.
export POST /v1alpha/{project=projects/*}/image:export
Initiates a batch process that computes an image and writes the result to one of several destinations.
import POST /v1alpha/{project=projects/*}/image:import
Imports an image.
importExternal POST /v1alpha/{project=projects/*}/image:importExternal
Imports an external image.

REST Resource: v1alpha.projects.imageCollection

Methods
computeImages POST /v1alpha/{project=projects/*}/imageCollection:computeImages
Computes a set of features by applying an arbitrary computation to features in one or more tables.

REST Resource: v1alpha.projects.locations.assets

Methods
create POST /v1alpha/{parent=projects/*/locations/*}/assets
Creates an asset.

REST Resource: v1alpha.projects.locations.filmstripThumbnails

Methods
create POST /v1alpha/{parent=projects/*/locations/*}/filmstripThumbnails
Creates an ID that can be used to render an image containing multiple images from a collection.

REST Resource: v1alpha.projects.locations.maps

Methods
create POST /v1alpha/{parent=projects/*/locations/*}/maps
Creates an ID that can be used to render map tiles showing the results of a computation.

REST Resource: v1alpha.projects.locations.tables

Methods
create POST /v1alpha/{parent=projects/*/locations/*}/tables
Creates an ID that can be used to render "table" data.

REST Resource: v1alpha.projects.locations.thumbnails

Methods
create POST /v1alpha/{parent=projects/*/locations/*}/thumbnails
Creates an ID that can be used to render a "thumbnail" image.

REST Resource: v1alpha.projects.locations.videoThumbnails

Methods
create POST /v1alpha/{parent=projects/*/locations/*}/videoThumbnails
Creates an ID that can be used to render an image containing an animation of multiple images from a collection.

REST Resource: v1alpha.projects.map

Methods
export POST /v1alpha/{project=projects/*}/map:export
Initiates a batch process that computes a tiled map and writes the result to Google Cloud Storage.

REST Resource: v1alpha.projects.maps

Methods
create POST /v1alpha/{parent=projects/*}/maps
Creates an ID that can be used to render map tiles showing the results of a computation.

REST Resource: v1alpha.projects.maps.tiles

Methods
get GET /v1alpha/{parent=projects/*/maps/*}/tiles/{zoom}/{x}/{y}
Computes a map tile image showing a portion of a computation.

REST Resource: v1alpha.projects.operations

Methods
cancel POST /v1alpha/{name=projects/*/operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1alpha/{name=projects/*/operations/**}
Deletes a long-running operation.
get GET /v1alpha/{name=projects/*/operations/**}
Gets the latest state of a long-running operation.
list GET /v1alpha/{name=projects/*}/operations
Lists operations that match the specified filter in the request.
wait POST /v1alpha/{name=projects/*/operations/**}:wait
Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state.

REST Resource: v1alpha.projects.table

Methods
computeFeatures POST /v1alpha/{project=projects/*}/table:computeFeatures
Computes a set of features by applying an arbitrary computation to features in one or more tables.
export POST /v1alpha/{project=projects/*}/table:export
Initiates a batch process that computes a table and writes the result to one of several destinations.
import POST /v1alpha/{project=projects/*}/table:import
Imports a table.

REST Resource: v1alpha.projects.tables

Methods
create POST /v1alpha/{parent=projects/*}/tables
Creates an ID that can be used to render "table" data.
getFeatures GET /v1alpha/{name=projects/*/tables/*}:getFeatures
Fetches Table features, the request includes the name of the Table to download from a previous CreateTable request.

REST Resource: v1alpha.projects.thumbnails

Methods
create POST /v1alpha/{parent=projects/*}/thumbnails
Creates an ID that can be used to render a "thumbnail" image.
getPixels GET /v1alpha/{name=projects/*/thumbnails/*}:getPixels
Computes an image showing the result of a computation.

REST Resource: v1alpha.projects.value

Methods
compute POST /v1alpha/{project=projects/*}/value:compute
Computes an arbitrary value.

REST Resource: v1alpha.projects.video

Methods
export POST /v1alpha/{project=projects/*}/video:export
Initiates a batch process that computes a video and writes the result to one of several destinations.

REST Resource: v1alpha.projects.videoThumbnails

Methods
create POST /v1alpha/{parent=projects/*}/videoThumbnails
Creates an ID that can be used to render an image containing an animation of multiple images from a collection.
getPixels GET /v1alpha/{name=projects/*/videoThumbnails/*}:getPixels
Computes an image showing the result of a computation.

REST Resource: v1.projects

Methods
getConfig GET /v1/{name=projects/*/config}
Gets the config state of a project.
listAssets GET /v1/{parent=projects/*}:listAssets
Lists any container asset, such as a folder or collection.
updateConfig PATCH /v1/{projectConfig.name=projects/*/config}
Updates the config state of a project.

REST Resource: v1.projects.algorithms

Methods
list GET /v1/{parent=projects/*}/algorithms
Gets the list of all the algorithms available for use in Expressions.

REST Resource: v1.projects.assets

Methods
copy POST /v1/{sourceName=projects/*/assets/**}:copy
Copies an asset.
create POST /v1/{parent=projects/*}/assets
Creates an asset.
delete DELETE /v1/{name=projects/*/assets/**}
Deletes an asset.
get GET /v1/{name=projects/*/assets/**}
Gets detailed information about an asset.
getIamPolicy POST /v1/{resource=projects/*/assets/**}:getIamPolicy
Gets the access control policy for a resource.
getPixels POST /v1/{name=projects/*/assets/**}:getPixels
Fetches pixels from an image asset.
listAssets GET /v1/{parent=projects/*/assets/**}:listAssets
Lists any container asset, such as a folder or collection.
listFeatures GET /v1/{asset=projects/*/assets/**}:listFeatures
Lists the features in a table asset.
move POST /v1/{sourceName=projects/*/assets/**}:move
Moves an asset.
patch PATCH /v1/{asset.name=projects/*/assets/**}
Updates an asset.
setIamPolicy POST /v1/{resource=projects/*/assets/**}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource=projects/*/assets/**}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.classifier

Methods
export POST /v1/{project=projects/*}/classifier:export
Initiates a batch process that computes a classifier and saves it as an Earth Engine asset.

REST Resource: v1.projects.featureView

Methods
create POST /v1/{parent=projects/*}/featureView
Create a FeatureView.

REST Resource: v1.projects.featureViews

Methods
create POST /v1/{parent=projects/*}/featureViews
Create a FeatureView.

REST Resource: v1.projects.featureViews.tiles

Methods
get GET /v1/{parent=projects/*/featureViews/*}/tiles/{zoom}/{x}/{y}
Computes a map tile image showing a portion of a FeatureView.

REST Resource: v1.projects.filmstripThumbnails

Methods
create POST /v1/{parent=projects/*}/filmstripThumbnails
Creates an ID that can be used to render an image containing multiple images from a collection.
getPixels GET /v1/{name=projects/*/filmstripThumbnails/*}:getPixels
Computes an image showing the result of a computation.

REST Resource: v1.projects.image

Methods
computePixels POST /v1/{project=projects/*}/image:computePixels
Computes a tile of pixels by performing an arbitrary computation on image data.
export POST /v1/{project=projects/*}/image:export
Initiates a batch process that computes an image and writes the result to one of several destinations.
import POST /v1/{project=projects/*}/image:import
Imports an image.

REST Resource: v1.projects.imageCollection

Methods
computeImages POST /v1/{project=projects/*}/imageCollection:computeImages
Computes a set of features by applying an arbitrary computation to features in one or more tables.

REST Resource: v1.projects.locations.assets

Methods
create POST /v1/{parent=projects/*/locations/*}/assets
Creates an asset.

REST Resource: v1.projects.locations.filmstripThumbnails

Methods
create POST /v1/{parent=projects/*/locations/*}/filmstripThumbnails
Creates an ID that can be used to render an image containing multiple images from a collection.

REST Resource: v1.projects.locations.maps

Methods
create POST /v1/{parent=projects/*/locations/*}/maps
Creates an ID that can be used to render map tiles showing the results of a computation.

REST Resource: v1.projects.locations.tables

Methods
create POST /v1/{parent=projects/*/locations/*}/tables
Creates an ID that can be used to render "table" data.

REST Resource: v1.projects.locations.thumbnails

Methods
create POST /v1/{parent=projects/*/locations/*}/thumbnails
Creates an ID that can be used to render a "thumbnail" image.

REST Resource: v1.projects.locations.videoThumbnails

Methods
create POST /v1/{parent=projects/*/locations/*}/videoThumbnails
Creates an ID that can be used to render an image containing an animation of multiple images from a collection.

REST Resource: v1.projects.map

Methods
export POST /v1/{project=projects/*}/map:export
Initiates a batch process that computes a tiled map and writes the result to Google Cloud Storage.

REST Resource: v1.projects.maps

Methods
create POST /v1/{parent=projects/*}/maps
Creates an ID that can be used to render map tiles showing the results of a computation.

REST Resource: v1.projects.maps.tiles

Methods
get GET /v1/{parent=projects/*/maps/*}/tiles/{zoom}/{x}/{y}
Computes a map tile image showing a portion of a computation.

REST Resource: v1.projects.operations

Methods
cancel POST /v1/{name=projects/*/operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=projects/*/operations/**}
Deletes a long-running operation.
get GET /v1/{name=projects/*/operations/**}
Gets the latest state of a long-running operation.
list GET /v1/{name=projects/*}/operations
Lists operations that match the specified filter in the request.
wait POST /v1/{name=projects/*/operations/**}:wait
Waits until the specified long-running operation is done or reaches at most a specified timeout, returning the latest state.

REST Resource: v1.projects.table

Methods
computeFeatures POST /v1/{project=projects/*}/table:computeFeatures
Computes a set of features by applying an arbitrary computation to features in one or more tables.
export POST /v1/{project=projects/*}/table:export
Initiates a batch process that computes a table and writes the result to one of several destinations.
import POST /v1/{project=projects/*}/table:import
Imports a table.

REST Resource: v1.projects.tables

Methods
create POST /v1/{parent=projects/*}/tables
Creates an ID that can be used to render "table" data.
getFeatures GET /v1/{name=projects/*/tables/*}:getFeatures
Fetches Table features, the request includes the name of the Table to download from a previous CreateTable request.

REST Resource: v1.projects.thumbnails

Methods
create POST /v1/{parent=projects/*}/thumbnails
Creates an ID that can be used to render a "thumbnail" image.
getPixels GET /v1/{name=projects/*/thumbnails/*}:getPixels
Computes an image showing the result of a computation.

REST Resource: v1.projects.value

Methods
compute POST /v1/{project=projects/*}/value:compute
Computes an arbitrary value.

REST Resource: v1.projects.video

Methods
export POST /v1/{project=projects/*}/video:export
Initiates a batch process that computes a video and writes the result to one of several destinations.

REST Resource: v1.projects.videoThumbnails

Methods
create POST /v1/{parent=projects/*}/videoThumbnails
Creates an ID that can be used to render an image containing an animation of multiple images from a collection.
getPixels GET /v1/{name=projects/*/videoThumbnails/*}:getPixels
Computes an image showing the result of a computation.