# Earth Engine

{% hint style="success" %}
**Note:** assets must be shared with *<openet@googlegroups.com>* to be used by the API.&#x20;
{% endhint %}

{% hint style="danger" %}
**DO NOT** add *<openet@googlegroups.com>* to the IAM Permission of any GCP Project.&#x20;
{% endhint %}

<details>

<summary>Signing Up</summary>

Anyone can sign up for Google Earth Engine. GEE is free for [non-commercial and non-operational use](https://earthengine.google.com/noncommercial/). To sign up, you will need to register a cloud project which can be done [here](https://code.earthengine.google.com/register). Make sure that your project is registered to your GEE account by visiting the [GEE code editor](https://code.earthengine.google.com) and following any steps if you see a warning sign under your profile image. Once you have been accepted you will receive an email with additional information. G-suite accounts may have automatically create a GEE for you similar to the way Google Drive is created.&#x20;

</details>

<details>

<summary>Uploading Shapefiles</summary>

To upload and manage geospatial datasets, use the Asset Manager in the Code Editor which can be found on the **Assets** tab at the left side of the Code Editor. See [Importing Table Data](https://developers.google.com/earth-engine/guides/table_upload) for instructions on uploading table data. Your assets are initially private, but may be shared with others.

Datasets uploaded through the Asset Manager become private assets in a folder owned by your user account. The space allocated to each user account for storing assets is limited by a quota. Quota usage is measured by the total number and the compressed size of stored assets. To see how much of your asset quota is in use, hover over **users/username** and click the data\_usage icon.

</details>

<details>

<summary>Sharing Assets</summary>

In order for the API to access information from you Earth Engine assets you must grant **READ** permission to ***<openet@googlegroups.com>***. A tutorial can be found in the Earth Engine documentation [here](https://developers.google.com/earth-engine/guides/asset_manager#sharing-assets).&#x20;

</details>

<details>

<summary>Linking Your Account</summary>

If you have an existing Google Earth Engine account, click <img src="/files/FwHk2geNei6SZq1MHiNi" alt="" data-size="line">when visiting your [Account Dashboard](https://account.etdata.org/) and grant access to the requested scopes to leverage your Earth Engine resources with OpenET. You will need to enter your [cloud project id](https://code.earthengine.google.com/register) information on your [profile page](https://account.etdata.org/settings/profile) near the bottom under the *Cloud Project ID* section and hit `save`.&#x20;

Once completed, all raster processing will be handled by you. This means no queue, the ability to monitor and cancel tasks, an expanded quota, and private exporting to your Google Drive. This will apply a **4x** multiplier to your account's [Quota](/docs/additional-resources/quota.md).&#x20;

The default export destination with be a folder at the root of your Google Drive called **OpenET Exports**. You can monitor and cancel requests with the [Earth Engine Task Manager](https://code.earthengine.google.com/tasks). &#x20;

To revoke access at anytime, visit your Google [account settings](https://myaccount.google.com/permissions?pli=1). Under the *Third-party Apps with Account Access* tab select OpenET and click `REMOVE ACCESS`. Finally, you will need to remove the cloud project id from you profile page.&#x20;

</details>

<details>

<summary>Public Data Catalog</summary>

OpenET publishes raster datasets to the Google Earth Engine [public data catalog](https://developers.google.com/earth-engine/datasets). Data is updated periodically. For very large data extractions which exceed quota limits, this is a great option for retrieval.&#x20;

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://openet.gitbook.io/docs/additional-resources/earth-engine.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
