-
Notifications
You must be signed in to change notification settings - Fork 17
/
gee-sign-up.Rmd
112 lines (80 loc) · 6.46 KB
/
gee-sign-up.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
---
title: "Sign-up for Google Earth Engine"
subtitle: "A step-by-step guide for signing-up for a GEE account with a cloud-project"
fontsize: 12pt
output:
html_document:
df_print: paged
toc: no
toc_depth: 2
highlight: pygments
includes:
after_body: comment.html
# pdf_document:
# toc: yes
# toc_depth: 3
# word_document:
# toc: yes
# toc_depth: '3'
header-includes:
- \usepackage{fancyhdr}
- \pagestyle{fancy}
- \renewcommand{\footrulewidth}{0.4pt}
- \fancyhead[LE,RO]{\thepage}
- \geometry{left=1in,top=0.75in,bottom=0.75in}
- \fancyfoot[CE,CO]{{\includegraphics[height=0.5cm]{images/cc-by-nc.png}} Ujaval Gandhi http://www.spatialthoughts.com}
classoption: a4paper
---
Google Earth Engine requires all users to sign-up for an account. This account is linked with Google Cloud and users must create a Google Cloud Project to use the service. If you have a legacy Earth Engine account, it must be linked to a Google Cloud Project to continue using GEE. Below are the official instructions for obtaining a new account as well as transitioning old accounts.
* [Earth Engine access](https://developers.google.com/earth-engine/guides/access) for new users.
* [Transition Guide](https://developers.google.com/earth-engine/guides/transition_to_cloud_projects) for existing users.
We have put together a simplified FAQ and step-by-step guide below for users who may not be familiar with Google Cloud.
----
### FAQ
* **Why the requirement for a Cloud Project?** Previously - Earth Engine was a separate Google service with it's own systems and was governed by its own Terms of Service. It is now integrated with Google Cloud Platform and is one of hundreds of other cloud offerings. This means that the usage of GEE is now governed by the *Google Cloud Platform Terms of Service* and it uses the standard cloud systems for access, logging, billing etc. It helps Earth Engine team offer better integration with other Google Cloud offerings. Using Google Cloud requires a *Project* - which is just a workspace where you can enable different services.
* **Should I sign-up for a Cloud Project?** As of June 2024, you do not have an option to use Earth Engine without a cloud project. If you do not link your existing account with a Cloud Project, your GEE account will stop functioning at some point in the future.
* **What happens to my scripts and assets?** Your existing scripts and assets will remain in your account and you can continue using them as normal after linking the account with a Cloud Project.
* **Do I have to pay for Google Cloud?** Earth Engine remains free for [Noncommercial and Research Use](https://earthengine.google.com/noncommercial/). You do not need to setup a billing account or pay if you qualify for this category. For [Commercial Use](https://earthengine.google.com/commercial/), you will need to setup a billing account and choose a [Pricing Plan](https://cloud.google.com/earth-engine/pricing).
Ready sign-up for Earth Engine with a Cloud Project? Follow the steps below.
----
### Choose a Sign-up Method
* **First-time GEE Users**: Visit the [Project Registration Page](https://code.earthengine.google.com/register) to start the [Sign-up Flow](#sign-up-flow).
* **Existing GEE Users**: Visit the [Earth Engine Code Editor](https://code.earthengine.google.com) and click on the account logo in the top-right corner and select *Register a new Cloud Project*. This will start the [Sign-up Flow](#sign-up-flow) that will connect your existing account to a Cloud Project.
```{r echo=FALSE, fig.align='left', out.width='75%'}
knitr::include_graphics('images/gee_sign_up/existing.png')
```
### Sign-up Flow
1. On the *Product Registration Page*, select `Register a Noncommercial or Commercial Cloud project`.
```{r echo=FALSE, fig.align='center', out.width='75%'}
knitr::include_graphics('images/gee_sign_up/cloud1.png')
```
2. Next, you need to choose *How do you want to use Earth Engine?*. Choose the `Paid usage` or `Unpaid usage` depending on your use case. Click *Next*. Since we are a training provider, we have chosen *Unpaid usage → Trainer & trainees*. You should select the category that applies to you.
```{r echo=FALSE, fig.align='center', out.width='50%'}
knitr::include_graphics('images/gee_sign_up/cloud2.png')
```
3. In the next dialog, choose *Create a new Google Cloud Project*. Select `No organization` for *Organization* and enter a *Project-ID*. This id needs to be unique. A standard practice is to use the project-ID in the form of `ee-<yourusername>`. Click *CONTINUE TO SUMMARY*. If you have never used Google Cloud before, an error message will be displayed with a note *You must accept the Cloud Terms of Service before a Cloud Project can be created*. Click on the link that will open the Google Cloud Console. If you do not get the warning, skip to step 6.
```{r echo=FALSE, fig.align='center', out.width='50%'}
knitr::include_graphics('images/gee_sign_up/cloud3.png')
```
4. Choose your *Country* and review the *Google Cloud Platform Terms of Service* and the terms of service of *any applicable services and APIs*. After reviewing, click *AGREE AND CONTINUE*.
```{r echo=FALSE, fig.align='center', out.width='50%'}
knitr::include_graphics('images/gee_sign_up/cloud4.png')
```
5. Once the Terms of Service have been accepted, go back to the previous tab and click *CONTINUE TO SUMMARY*.
```{r echo=FALSE, fig.align='center', out.width='50%'}
knitr::include_graphics('images/gee_sign_up/cloud5.png')
```
6. You will be presented with a summary in the *Confirm your Cloud project information* dialog. Review and click *CONFIRM*.
```{r echo=FALSE, fig.align='center', out.width='50%'}
knitr::include_graphics('images/gee_sign_up/cloud6.png')
```
7. The project will be registered and you will be redirected to the Code Editor. If you are not redirected automatically, visit the [Earth Engine Code Editor](https://code.earthengine.google.com).
```{r echo=FALSE, fig.align='center', out.width='50%'}
knitr::include_graphics('images/gee_sign_up/cloud7.png')
```
8. Your code editor will now display information about the linked project.
```{r echo=FALSE, fig.align='center', out.width='75%'}
knitr::include_graphics('images/gee_sign_up/cloud8.png')
```
Done! You are now ready to start using your Earth Engine account with a Cloud Project.
> Disclaimer: The information provider below is general information to help new users. The cloud-integration with Earth Engine is evolving and may change in the future. Read to the official guides linked above for up-to-date information.