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:
- ma włączony interfejs Earth Engine API,
- jest zarejestrowany do użytku komercyjnego lub niekomercyjnego,
- przyznaje Tobie (lub użytkownikowi) odpowiednie role i uprawnienia.
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 chmurzeWłą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 APINa 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-assetSkrypty 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.
Odwołania do opcji „Pobierz link”
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_IDWybranie 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.