Earth Engine działa w Google Cloud i wymaga dostępu do projektów Cloud oraz zarządzania interfejsami API. Wszystkie wywołania Earth Engine (z poziomu edytora kodu, bibliotek klienta, aplikacji lub interfejsu REST API) są kierowane przez projekt Cloud, co umożliwia kontrolę dostępu, zarządzanie zasobami i monitorowanie wykorzystania w Konsoli Cloud.
Uzyskiwanie dostępu do Earth Engine
Aby korzystać z Earth Engine, musisz mieć dostęp do projektu Cloud, który:
- ma włączony interfejs Earth Engine API,
- jest zarejestrowany do komercyjnego lub niekomercyjnego użytku, oraz
- przyznaje Ci (lub użytkownikowi) odpowiednie role i uprawnienia.
Utwórz projekt
Otwórz stronę rejestracji, aby utworzyć i zarejestrować nowy projekt Cloud lub zarejestrować istniejący projekt.
Projektami utworzonymi podczas procesu rejestracji można zarządzać w konsoli Google Cloud. Interfejs API Earth Engine możesz aktywować lub dezaktywować na stronie interfejsu API Earth Engine w Konsoli Cloud.
Kroki ręczne (automatyczne na stronie rejestracji)
Tworzenie projektu Cloud
Jeśli jeszcze tego nie zrobisz, utwórz projekt Google Cloud. Możesz to zrobić na stronie projektów w Cloud Console lub kliknąć ten przycisk:
Utwórz projekt CloudWłącz interfejs Earth Engine API
Aby włączyć interfejs Earth Engine API w projekcie, kliknij ten przycisk, aby przejść na stronę interfejsu Earth Engine API:
Włącz interfejs Earth Engine APINa stronie interfejsu API Earth Engine sprawdź, czy wybrano Twój projekt, i kliknij przycisk WŁĄCZ.
Zarejestruj projekt do wykorzystania w celach komercyjnych lub niekomercyjnych
Zmień ten URL na swój projekt, otwórz stronę i przejdź przez proces rejestracji.
https://code.earthengine.google.com/register?project=my-project
Utwórz folder komponentów (opcjonalnie)
Możesz utworzyć folder zasobów Earth Engine powiązany z projektem Cloud, do którego masz dostęp, za pomocą polecenia
earthengine create folder
z ścieżką opisaną tutaj.
Na przykład:
earthengine create folder projects/my-project/assets/Folder zasobów dla projektu możesz też utworzyć w Edytorze kodu, dodając projekt w panelu Komponenty.
Nie musisz tworzyć tego folderu, chyba że planujesz przechowywać w nim zasoby w projekcie.
Korzystanie z istniejącego projektu
Skontaktuj się z personelem IT organizacji, aby dowiedzieć się więcej o istniejących projektach Cloud skonfigurowanych pod kątem Earth Engine. Upewnij się, że konto Google, którego będziesz używać do uzyskiwania dostępu do usług Earth Engine, ma w tym projekcie odpowiednie role i uprawnienia.
Określ projekt
W poniższych sekcjach dowiesz się, jak określić projekt dla różnych interfejsów usług Earth Engine.
Biblioteki klienta (Python, JavaScript)
Funkcja ee.Initialize() służy do wskazywania projektu w przypadku żądań Earth Engine pochodzących z bibliotek klienta Python i JavaScript. Specyfikację projektu można skonfigurować na kilka sposobów. Więcej informacji znajdziesz na stronie Uwierzytelnianie i inicjowanie.
Edytor kodu
W prawym górnym rogu Edytowanie kodu kliknij ikonę profilu i w menu wybierz „Zmień projekt w chmurze”. Wybierz projekt w oknie wyboru.
Aplikacje Earth Engine
Podczas publikowania aplikacji Earth Engine pojawi się prośba o wybranie projektu, do którego mają być kierowane żądania. Postępuj zgodnie z instrukcjami w oknie publikowania.
Narzędzie wiersza poleceń
Aby powiązać wywołania Earth Engine z narzędzia wiersza poleceń z projektem Cloud, użyj parametru --project w wywołaniu earthengine lub użyj parametru set_project, aby ustawić projekt domyślny.
Interfejs API typu REST
Aby powiązać wywołania interfejsu REST API z projektem Cloud, wyślij uwierzytelnione wywołania HTTP, w przypadku których uwierzytelnianie jest obsługiwane przez oauth2. W środowisku lokalnym możesz użyć polecenia gcloud. Możesz też użyć konta usługi powiązanego z projektem w chmurze. Przykład użycia interfejsu google.oath.service_account.Credentials.from_service_account_file() do uwierzytelniania za pomocą konta usługi znajdziesz w artykule Krótki przewodnik po interfejsie API REST.
Konfigurowanie dostępu do projektu
W kolejnych sekcjach opisaliśmy, jak skonfigurować projekty korzystające z Earth Engine do użytku przez inne osoby i konta usługi.
Konta usługi
Konta usługi mają dostęp automatycznie, gdy ich nadrzędny projekt jest zarejestrowany i ma włączone API Earth Engine. Muszą też mieć odpowiednie uprawnienia w projekcie. W projekcie można skonfigurować dowolną liczbę kont usług do korzystania z Earth Engine. Aby dowiedzieć się więcej o korzystaniu z kont usługi w Earth Engine, otwórz stronę Konta usługi.
Konta Google
Projekty w Cloud korzystają z Cloud IAM do zarządzania rolami i uprawnieniami. Aby inni użytkownicy mogli uzyskać dostęp do Earth Engine za pomocą Twojego projektu, musisz przyznać im w konsoli Cloud odpowiednie role i uprawnienia.
Identyfikator klienta OAuth 2.0
Może być konieczne utworzenie identyfikatora klienta OAuth 2.0 w projekcie, np. aby utworzyć aplikację, która przekazuje dane logowania użytkownika do Earth Engine. Dane logowania do projektu w Cloud możesz zarządzać w menu Cloud Console () i wybrać Interfejsy API i usługi > Dane logowania. (w razie potrzeby wybierz projekt).
Aby utworzyć nowy identyfikator klienta dla projektu, kliknij + UTWÓRZ DANE LOGOWANIA > Identyfikator klienta OAuth > Aplikacja internetowa.
W konfiguracji aplikacji internetowej:
- Określ autoryzowane źródła JavaScriptu, na przykład:
http://localhost:8080
https://foo-ee-project.appspot.com
- Podaj autoryzowane identyfikatory URI przekierowania, np.:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback
Więcej informacji o uwierzytelnianiu użytkowników za pomocą OAuth
Typowe scenariusze
Prowadzę zajęcia edukacyjne...
Świetnie. Jeśli rejestrujesz projekt niekomercyjny, nie musisz konfigurować płatności. Następnie możesz dodać uczniów do projektu.
Jestem członkiem zespołu operacyjnego lub organizacji komercyjnej...
Świetnie. Możesz zarejestrować projekt do wykorzystania komercyjnego i dodać do niego współpracowników. Zwróć też uwagę na limit miejsc w wybranej subskrypcji Earth Engine.
Usuwanie danych z Earth Engine
Usuwanie na poziomie konta
Usunięcie na poziomie konta spowoduje usunięcie wszystkich danych Earth Engine z Twojego konta.
Jeśli Twoje konto należy do organizacji Google Workspace, administrator kontroluje dane Twojego konta. Gdy administrator usunie konto Google, wszystkie powiązane dane Earth Engine zostaną usunięte w ciągu około 30 dni.
Zespół Earth Engine nie może przywrócić danych po ich usunięciu.
Projekty Cloud
Usunięcie projektu Cloud powoduje usunięcie powiązanych z nim danych Earth Engine (w tym m.in. zasobów przechowywanych w katalogu głównym projektu, aplikacji EE na poziomie projektu, danych monitorowania itp.). Ten proces może zostać cofnięty w ciągu 30 dni, ale po upływie tego czasu odzyskanie tych danych jest niemożliwe.
Zasoby
Najprostszym sposobem usuwania zasobów jest użycie karty „Komponenty” w Edytorze kodu, aby wyświetlić i ręcznie usunąć komponenty Earth Engine.
W przypadku automatycznego usunięcia zasobu o identyfikatorze projects/{project-id}/assets/{asset-id}(np. projects/my-project/assets/my-asset):
Klient Python
ee.data.deleteAsset('projects/my-project/assets/my-asset')
Klient JavaScript
Pamiętaj, że piaskownica bezpieczeństwa w Edytorze kodu uniemożliwia działanie tego wywołania w tym środowisku.
ee.data.deleteAsset('projects/my-project/assets/my-asset')
Narzędzie wiersza poleceń
Użyj polecenia rm:
earthengine rm projects/my-project/assets/my-assetSkrypty edytora kodu
Aby usunąć skrypty edytora kodu Earth Engine:
Edytor kodu
Na karcie „Skrypty” w Edytorze kodu wybierz skrypt lub repozytorium i usuń je. Po oznaczeniu repozytorium jako usuniętego nie można go odzyskać w ciągu 30 dni.
Korzystanie z Git
Zaawansowani użytkownicy mogą używać Git do zarządzania skryptami. Aby wyświetlić listę repozytoriów, których możesz używać, wejdź na stronę https://earthengine.googlesource.com/.
Aplikacje Earth Engine
Aby usunąć aplikacje Earth Engine, użyj przycisku „Aplikacje” w Edytorze kodu, aby zarządzać aplikacjami.
Odwołania do „Uzyskaj link”
Na stronie Zarządzaj linkami możesz wyświetlać i usuwać linki „Uzyskaj link” z Edytora kodu. Aby ją otworzyć, kliknij opcję „Zarządzaj linkami” w menu obok przycisku „Uzyskaj link”.
Zamykanie dostępu komercyjnego
Jeśli jesteś bezpośrednim klientem Earth Engine i chcesz przestać korzystać z Earth Engine w kontekście płatnym, musisz wprowadzić kilka zmian, aby zaprzestać ponoszenia opłat:
Zatrzymanie naliczania opłat za subskrypcję
- Aby anulować subskrypcję Earth Engine na swoim koncie rozliczeniowym, musisz użyć strony „Zarządzaj planami” (dostępnej w menu Ustawienia użytkownika w prawym górnym rogu Edytora kodu podczas korzystania z zarejestrowanego projektu Cloud połączonego z tym kontem rozliczeniowym).
Możesz też otworzyć stronę „Zarządzaj planami” bezpośrednio na koncie płatności:
https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_IDWybranie planu „Ograniczony” powoduje, że po zakończeniu bieżącego cyklu rozliczeniowego Twoje konto rozliczeniowe nie będzie obciążane żadnymi opłatami za subskrypcję platformy Earth Engine.
Zatrzymywanie opłat za obliczenia
- Aby zapobiec nowym opłatom związanym z przetwarzaniem (czas EECU), wyłącz interfejs Earth Engine API w swoich projektach w Google Cloud. Pamiętaj, że nie powoduje to zakończenia żądań w toku ani nie powoduje usunięcia przechowywanych obiektów, więc nawet po wyłączeniu interfejsu API mogą być naliczane opłaty za Earth Engine.
- Informacje o wyłączaniu interfejsów API znajdziesz w Konsoli interfejsów API (Help).
Zatrzymywanie opłat za miejsce na dane
- Zasoby Earth Engine przechowywane w usłudze nadal powodują naliczanie kosztów, nawet jeśli interfejs API jest wyłączony. Usunięcie zasobów spowoduje, że nie będziesz już ponosić opłat za miejsce na dane w usłudze EE.