Dostęp do Earth Engine

Earth Engine działa w Google Cloud i wymaga projektów w chmurze do zarządzania dostępem i interfejsami API. Wszystkie wywołania Earth Engine (z edytora kodu, bibliotek klienta, aplikacji lub interfejsu REST API) są kierowane przez projekt w chmurze, 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 w chmurze, który:

Utwórz projekt

Odwiedź stronę rejestracji, aby utworzyć i zarejestrować nowy projekt w chmurze lub zarejestrować istniejący projekt. Po rejestracji dostęp do Earth Engine jest włączany natychmiast.

Projektami utworzonymi podczas procesu rejestracji można zarządzać w konsoli Google Cloud. Interfejs Earth Engine API możesz aktywować lub dezaktywować na stronie Earth Engine API w konsoli Cloud.

Czynności ręczne (zautomatyzowane przez stronę rejestracji)

Tworzenie projektu w chmurze

Jeśli nie masz jeszcze projektu Google Cloud, utwórz go. Możesz to zrobić na stronie projektów w konsoli Cloud lub klikając ten przycisk:

Utwórz projekt w chmurze

Włączanie interfejsu Earth Engine API

Aby włączyć interfejs Earth Engine API w projekcie, kliknij ten przycisk i przejdź na stronę interfejsu Earth Engine API:

Włączanie interfejsu Earth Engine API

Na stronie Earth Engine API sprawdź, czy masz wybrany projekt, i kliknij przycisk WŁĄCZ.

Zarejestruj projekt do wykorzystania w celach komercyjnych lub niekomercyjnych

Zmień podany niżej adres URL swojego projektu, wejdź na stronę i ukończ proces rejestracji.

https://code.earthengine.google.com/register?project=my-project

Tworzenie folderu zasobó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 i ścieżki opisanej tutaj. Na przykład:

earthengine create folder projects/my-project/assets/

Możesz też utworzyć folder zasobów dla projektu w Edytorze kodu, dodając projekt w panelu Zasoby.

Nie musisz tworzyć tego folderu, chyba że planujesz przechowywać zasoby w projekcie.

Używanie istniejącego projektu

Skontaktuj się z personelem IT 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 poniższych sekcjach opisujemy, 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 dla żądań Earth Engine pochodzących z bibliotek klienta Python i JavaScript. Istnieje kilka sposobów konfigurowania specyfikacji projektu. Więcej informacji znajdziesz na stronie poświęconej uwierzytelnianiu i inicjowaniu.

Edytor kodu

W prawym górnym rogu edytora kodu kliknij ikonę profilu i wybierz z menu „Zmień projekt w chmurze”. Wybierz projekt w oknie wyboru.

Aplikacje Earth Engine

Podczas publikowania aplikacji Earth Engine pojawi się prośba o wybranie projektu, przez który 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 w chmurze, 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 API (typu) REST z projektem w chmurze, 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 chmurze. 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 REST API.

Konfigurowanie dostępu do projektu

W sekcjach poniżej opisano, jak skonfigurować projekty z włączonym Earth Engine do użytku przez inne osoby i konta usługi.

Konta usługi

Konta usługi automatycznie uzyskują dostęp, gdy ich projekt nadrzędny zostanie zarejestrowany i będzie miał włączony interfejs Earth Engine API. Muszą też mieć odpowiednie uprawnienia w projekcie. Do korzystania z Earth Engine można skonfigurować dowolną liczbę kont usługi w projekcie. Aby dowiedzieć się więcej o używaniu kont usługi w Earth Engine, odwiedź stronę kont usługi.

Konta Google

Projekty w chmurze 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 użyć konsoli Cloud, aby przyznać im odpowiednie role i uprawnienia.

Identyfikator klienta OAuth 2.0

Może być konieczne utworzenie identyfikatora klienta OAuth 2.0 z projektu, na przykład w celu utworzenia aplikacji, która przekazuje dane logowania użytkownika do Earth Engine. Danymi logowania do projektu w chmurze możesz zarządzać, otwierając menu konsola Cloud () i wybierając Interfejsy API i usługi > Dane logowania. (jeśli pojawi się taka prośba, 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
  • Określ autoryzowane identyfikatory URI przekierowania, na przykład:
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 niekomercyjny, 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 stanowisk 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, danymi na koncie zarządza administrator. Gdy administrator usunie konto Google, wszystkie powiązane z nim dane Earth Engine zostaną usunięte w ciągu około 30 dni.

Zespół Earth Engine nie może odzyskać danych po ich usunięciu.

Projekty w chmurze

Usunięcie projektu w chmurze powoduje usunięcie danych Earth Engine powiązanych z tym projektem (w tym np. 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 nie będzie możliwe.

Zasoby

Najprostszym sposobem usunięcia zasobów jest użycie karty „Zasoby” w edytorze kodu, aby wyświetlić i ręcznie usunąć zasoby Earth Engine.

W przypadku automatycznego usuwania zasobu o identyfikatorze projects/{project-id}/assets/{asset-id} (np. projects/my-project/assets/my-asset):

Klient Pythona

ee.data.deleteAsset('projects/my-project/assets/my-asset')

Klient JavaScript

Pamiętaj, że bezpieczna 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-asset

Skrypty edytora kodu

Aby usunąć skrypty edytora kodu Earth Engine:

Edytor kodu

Na karcie „Scripts” (Skrypty) w edytorze kodu wybierz skrypt lub repozytorium i usuń je. Gdy repozytorium zostanie oznaczone jako usunięte, w ciągu 30 dni nie będzie można go odzyskać.

Za pomocą Gita

Zaawansowani użytkownicy mogą zarządzać skryptami za pomocą Gitu. Aby wyświetlić listę repozytoriów, które możesz przeglądać, wejdź na https://earthengine.googlesource.com/.

Aplikacje Earth Engine

Aby usunąć aplikacje Earth Engine, użyj przycisku „Aplikacje” w edytorze kodu, który służy do zarządzania aplikacjami.

Na stronie Zarządzaj linkami możesz wyświetlać i usuwać linki utworzone za pomocą opcji „Pobierz link” w edytorze kodu. Aby ją otworzyć, 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 dla swojego projektu, musisz wypełnić kwestionariusz rejestracyjny w konsoli Cloud, aby potwierdzić, że projekt się kwalifikuje.

Weryfikacja

Earth Engine zapewnia bezpłatny dostęp do dużej ilości zasobów obliczeniowych, dlatego Google wymaga weryfikacji każdego projektu zarejestrowanego na potrzeby dostępu niekomercyjnego. Proces weryfikacji jest częścią rejestracji. Jeśli wypełnisz kwestionariusz weryfikacyjny i Twój projekt zostanie uznany za komercyjny, nie będziesz mieć możliwości korzystania z Earth Engine bez opłat.

Od 26 września 2025 r. wszystkie projekty niekomercyjne muszą mieć wypełniony kwestionariusz w konsoli Cloud. Zalecamy jak najszybsze przejście procesu weryfikacji. Jeśli nie podejmiesz działań przed 26 września 2025 r., dostęp Twojego projektu do Earth Engine 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 dla swojego projektu, musisz skonfigurować projekt na stronie rejestracji i wybrać abonament na koncie rozliczeniowym.

Zakończ dostęp komercyjny

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 przestać ponosić opłaty:

  • Zatrzymywanie opłat za subskrypcję

    • Aby zakończyć subskrypcję Earth Engine na koncie rozliczeniowym, musisz użyć strony „Zarządzaj abonamentami” (dostępnej w menu ustawień użytkownika w prawym górnym rogu Edytora kodu, gdy używasz zarejestrowanego projektu w chmurze połączonego z tym kontem rozliczeniowym).
    • Możesz też uzyskać dostęp do strony „Zarządzaj abonamentami” bezpośrednio z konta rozliczeniowego:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • Wybranie abonamentu „Ograniczony” spowoduje, że po zakończeniu bieżącego cyklu rozliczeniowego na Twoim koncie rozliczeniowym nie będą już naliczane żadne opłaty za subskrypcję platformy Earth Engine.

  • Zatrzymywanie opłat za moc obliczeniową

    • Aby zapobiec nowym opłatom związanym z zasobami obliczeniowymi (czas EECU), wyłącz interfejs Earth Engine API w projektach w chmurze. Pamiętaj, że nie spowoduje to przerwania żądań w toku ani usunięcia przechowywanych 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 konsoli interfejsów API.
  • Zatrzymywanie opłat za miejsce na dane

    • Przechowywane zasoby Earth Engine nadal generują koszty, nawet jeśli interfejs API jest wyłączony. Usunięcie zasobów zapobiega naliczaniu dalszych opłat za miejsce na dane w EE.