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.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: