Earth Engine działa w Google Cloud i wymaga projektów Cloud do uzyskiwania dostępu i zarządzania interfejsami API. Wszystkie wywołania Earth Engine (z Edytora kodu, bibliotek klienta, aplikacji lub interfejsu REST API) są kierowane przez projekt w Google Cloud, co umożliwia kontrolę dostępu, zarządzanie zasobami i monitorowanie wykorzystania w konsoli Google 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 wykorzystania w celach komercyjnych lub niekomercyjnych,
- 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 Earth Engine API możesz włączyć lub wyłączyć na stronie interfejsu Earth Engine API w konsoli Cloud.
Czynności wykonywane ręcznie (automatyzowane przez stronę rejestracji)
Tworzenie projektu w Google Cloud
Jeśli jeszcze tego nie zrobiono, utwórz projekt Google Cloud. Możesz to zrobić na stronie projektów w Cloud Console lub kliknąć ten przycisk:
Tworzenie projektu CloudWłączanie interfejsu Earth Engine API
Aby włączyć Earth Engine API w projekcie, kliknij ten przycisk, aby przejść na stronę Earth Engine API:
Włącz interfejs Earth Engine APINa stronie interfejsu Earth Engine API sprawdź, czy wybrano projekt, a następnie kliknij przycisk WŁĄCZ.
Zarejestruj projekt do użytku komercyjnego lub niekomercyjnego.
Edytuj ten URL projektu, otwórz stronę i dokonaj rejestracji.
https://code.earthengine.google.com/register?project=my-project
Tworzenie folderu komponentów (opcjonalnie)
Możesz utworzyć folder zasobów Earth Engine powiązany z projektem Cloud, do którego masz dostęp, używając polecenia
earthengine create folder z ścieżką opisaną tutaj.
Na przykład:
earthengine create folder projects/my-project/assets/Folder zasobów projektu możesz też utworzyć w Edytorze kodu, dodając projekt w panelu Zasoby.
Nie musisz tworzyć tego folderu, chyba że planujesz przechowywać w projekcie komponenty.
Używanie istniejącego projektu
Skontaktuj się z personelem IT w swojej organizacji, aby dowiedzieć się o istniejących projektach w chmurze skonfigurowanych na potrzeby Earth Engine. Upewnij się, że konto Google, którego będziesz używać do uzyskiwania dostępu do usług Earth Engine, ma w projekcie odpowiednie role i uprawnienia.
Określanie projektu
W sekcjach poniżej znajdziesz informacje o tym, jak określić projekt dla różnych interfejsów usług Earth Engine.
Biblioteki klienta (Python, JavaScript)
Funkcja ee.Initialize() służy do określania projektu na potrzeby żą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 edytora kodu kliknij ikonę profilu i z menu wybierz „Zmień projekt w chmurze”. Wybierz projekt w oknie wyboru.
Aplikacje Earth Engine
Podczas publikowania aplikacji Earth Engine zobaczysz prośbę o wybranie projektu, przez który będą 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 set_project, aby ustawić projekt domyślny.
Interfejs API typu REST
Aby powiązać wywołania interfejsu REST API z projektem Cloud, wysyłaj uwierzytelnione wywołania HTTP, w 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 Google Cloud. Przykład użycia google.oath.service_account.Credentials.from_service_account_file() do uwierzytelniania za pomocą konta usługi znajdziesz w krótkim wprowadzeniu do interfejsu API REST.
Konfigurowanie dostępu do projektu
W sekcjach poniżej opisujemy, jak skonfigurować projekty z włączoną obsługą Earth Engine, aby mogły z nich korzystać inne osoby i konta usługi.
Konta usługi
Konta usługi automatycznie uzyskują dostęp po zarejestrowaniu projektu nadrzędnego i włączeniu w nim Earth Engine API. Muszą też mieć odpowiednie uprawnienia w projekcie. Dowolną liczbę kont usług w projekcie można skonfigurować tak, aby korzystały z Earth Engine. Więcej informacji o używaniu kont usługi w Earth Engine znajdziesz na stronie kont usługi.
Konta Google
Projekty w Google Cloud używają 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 odpowiednie role i uprawnienia w konsoli Cloud.
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. Możesz zarządzać danymi logowania do projektu w Cloud, otwierając menu Cloud Console () i wybierając Interfejsy API i usługi > Dane logowania. (Wybierz projekt, jeśli pojawi się monit).
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
- Określ 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ą protokołu OAuth
Typowe scenariusze
Prowadzę zajęcia edukacyjne…
Świetnie! Jeśli zarejestrujesz projekt do użytku niekomercyjnego, nie musisz konfigurować płatności. Następnie możesz dodać uczniów do projektu.
Należę do zespołu operacyjnego lub organizacji komercyjnej...
Świetnie! Możesz zarejestrować projekt do użytku 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 konta. Gdy administrator usunie konto Google, wszystkie powiązane z nim dane Earth Engine zostaną usunięte w ciągu około 30 dni.
Po usunięciu danych zespół Earth Engine nie może ich przywrócić.
Projekty Google Cloud
Gdy projekt Cloud zostanie usunięty, spowoduje to usunięcie danych Earth Engine powiązanych z tym projektem (w tym na przykład wszystkich zasobów przechowywanych w katalogu głównym projektu, wszystkich aplikacji EE na poziomie projektu, danych monitorowania itp.). Ten proces może być odwracalny przez maksymalnie 30 dni, ale po tym czasie odzyskanie danych jest niemożliwe.
Zasoby
Najprostszym sposobem usuwania zasobów jest użycie karty „Zasoby” w edytorze kodu, aby wyświetlić i ręcznie usunąć zasoby Earth Engine.
W przypadku zautomatyzowanego usuwania 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 zabezpieczeń Edytora 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 z edytora kodu Earth Engine:
Edytor kodu
Na karcie „Skrypty” w edytorze kodu wybierz skrypt lub repozytorium i usuń go. Po oznaczeniu repozytorium jako usuniętego nie można go odzyskać w ciągu 30 dni.
Korzystanie z Gita
Zaawansowani użytkownicy mogą zarządzać skryptami za pomocą Git. Listę repozytoriów, które możesz wyświetlić, znajdziesz na stronie https://earthengine.googlesource.com/.
Aplikacje Earth Engine
Aby usunąć aplikacje Earth Engine, użyj przycisku „Aplikacje” w edytorze kodu.
Odwołania do „Pobierz link”
Na stronie Zarządzaj linkami możesz wyświetlać i usuwać linki „Uzyskaj link” z edytora kodu. Aby otworzyć tę stronę, kliknij opcję „Zarządzaj linkami” w menu obok przycisku „Pobierz link”.
Konfigurowanie dostępu do zastosowań niekomercyjnych
Aby skonfigurować niekomercyjny (bezpłatny) dostęp do Earth Engine w projekcie, musisz wypełnić kwestionariusz rejestracyjny w konsoli Cloud, aby potwierdzić, że Twój projekt kwalifikuje się do tego dostępu.
Weryfikacja
Earth Engine zapewnia bezpłatny dostęp do dużej ilości zasobów obliczeniowych, dlatego Google wymaga weryfikacji każdego projektu zarejestrowanego w celu uzyskania dostępu niekomercyjnego. Proces weryfikacji jest przeprowadzany w ramach rejestracji. Jeśli wypełnisz kwestionariusz weryfikacyjny i okaże się, że Twój projekt ma charakter komercyjny, nie będziesz mieć możliwości korzystania z Earth Engine bez opłat.
Od 26 września 2025 r. w przypadku wszystkich projektów niekomercyjnych należy wypełnić ankietę w konsoli Cloud. Zalecamy jak najszybsze przeprowadzenie procesu weryfikacji. Jeśli nie podejmiesz żadnych działań do 26 września 2025 r., dostęp do Earth Engine w Twoim projekcie zostanie wstrzymany do czasu zakończenia procesu weryfikacji.
Ponowna weryfikacja
Wszystkie projekty z dostępem niekomercyjnym będą musiały okresowo przechodzić ponowną weryfikację.
Konfigurowanie dostępu komercyjnego
Aby skonfigurować komercyjny (płatny) dostęp do Earth Engine w swoim projekcie, musisz skonfigurować projekt na stronie rejestracji i wybrać abonament na koncie rozliczeniowym.
Zakończenie dostępu komercyjnego
Jeśli jesteś bezpośrednim klientem Earth Engine i chcesz przestać korzystać z tej usługi w kontekście płatnym, musisz wprowadzić kilka zmian, aby uniknąć naliczania opłat:
Zatrzymywanie naliczania opłat za subskrypcję
- Aby zakończyć subskrypcję Earth Engine na koncie rozliczeniowym, musisz użyć strony „Zarządzaj planami” (dostępnej w menu ustawień użytkownika w prawym górnym rogu edytora kodu, gdy używasz zarejestrowanego projektu w Cloud połączonego z tym kontem rozliczeniowym).
Możesz też otworzyć bezpośrednio stronę „Zarządzaj planami” dla konta rozliczeniowego:
https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_IDWybór subskrypcji „Ograniczona” spowoduje, że po zakończeniu bieżącego cyklu rozliczeniowego nie będziemy już naliczać opłat za subskrypcję platformy Earth Engine.
Zatrzymywanie naliczania opłat za moc obliczeniową
- Aby zapobiec naliczaniu nowych opłat związanych z obliczeniami (czas EECU), wyłącz interfejs Earth Engine API w projektach w Cloud. Pamiętaj, że nie powoduje to zakończenia trwających żądań ani usunięcia zapisanych obiektów, więc nawet po wyłączeniu interfejsu API możesz nadal ponosić opłaty za Earth Engine.
- Informacje o wyłączaniu interfejsów API znajdziesz w Pomocy dotyczącej konsoli interfejsów API.
Zatrzymywanie opłat za miejsce na dane
- Zasoby Earth Engine nadal generują koszty, nawet jeśli interfejs API jest wyłączony. Usunięcie komponentów spowoduje, że nie będziesz już ponosić opłat za miejsce na dane w EE.