Aplikacje Earth Engine

Wprowadzenie

Aplikacje Earth Engine to dynamiczne, udostępniane interfejsy użytkownika do analiz w Earth Engine. Dzięki aplikacjom eksperci mogą używać prostych elementów interfejsu użytkownika do korzystania z katalogu danych i możliwości analitycznych Earth Engine, zarówno przez ekspertów, jak i osoby początkujące.

Aplikacje opublikowane w Earth Engine są dostępne pod adresem URL aplikacji wygenerowanym w momencie publikacji. Aby wyświetlić opublikowaną aplikację lub wchodzić z nią w interakcję, nie trzeba mieć konta Earth Engine. Aplikacje wybrane przez ich twórców jako polecane są też dostępne w Galerii aplikacji dla konkretnego użytkownika (np. USERNAME.users.earthengine.app).

Tworzenie aplikacji

Aplikacje Earth Engine mogą korzystać z większości tych samych funkcji, co edytor kodu, z kilkoma wyjątkami. Dodatkowo interfejs API został zaprojektowany z myślą o programistach aplikacji. Jeśli nie znasz jeszcze interfejsu API, zapoznaj się z  ogólnym opisem interfejsu API.

Publikowanie aplikacji

Aby opublikować aplikację z poziomu edytora kodu, najpierw załaduj skrypt, który chcesz przekształcić w aplikację, a potem otwórz panel zarządzania aplikacjami. Aby to zrobić, kliknij przycisk Aplikacje nad sekcją skryptu w Edytorze kodu.

Przycisk Zarządzaj aplikacjami
Przycisk Zarządzaj aplikacjami

Następnie kliknij przycisk NOWA APLIKACJA.

Nowy przycisk aplikacji
Przycisk nowej aplikacji

W oknie wybierz dostęp do edytora, nazwę aplikacji, projekt Google Cloud i lokalizację kodu źródłowego aplikacji. Ogranicz dostęp do tej aplikacji do konkretnej grupy Google lub pozostaw ją publicznie dostępną, korzystając z opcji na karcie Ograniczenia. W przypadku aplikacji publicznie dostępnych możesz też przesłać niestandardowy obraz podglądu aplikacji oraz podać jej opis na karcie Galeria. Jeśli chcesz, aby aplikacja była widoczna w publicznej galerii aplikacji na stronie USERNAME.users.earthengine.app, kliknij „Poleć tę aplikację w Galerii aplikacji”. Opcjonalnie możesz umieścić w lewym górnym rogu aplikacji logo niestandardowe, przesyłając wybrany obraz na karcie Logo.

Wybieranie uprawnień do edycji
Wybierz dostęp do edycji: wybierz, kto może edytować aplikację.
Publikowanie aplikacji, nazwy i adresu URL
Opublikuj aplikację: wybierz nazwę, identyfikator aplikacji i projekt Cloud.
Publikowanie aplikacji, kod źródłowy
Opublikuj aplikację: wybierz kod źródłowy aplikacji
Publikowanie aplikacji, szczegóły publikacji
Opublikuj aplikację: wybierz opcje takie jak prezentowanie aplikacji w galerii, ograniczenia dostępu i logo niestandardowe

Zarządzanie aplikacjami

Aby zarządzać aplikacją w Edytorze kodu, otwórz panel Zarządzanie aplikacją, klikając przycisk Aplikacje nad sekcją skryptu w Edytorze kodu. Tutaj możesz zaktualizować konfigurację aplikacji lub ją usunąć.

Zarządzaj Aplikacjami
Zarządzaj aplikacjami

Współpraca z innymi nad aplikacjami należącymi do projektu

Domyślnie aplikacje opublikowane pod Twoją nazwą użytkownika mogą być edytowane tylko przez Ciebie. Współpraca nad aplikacjami jest możliwa w przypadku aplikacji należących do projektu. Aplikacje należące do projektu to aplikacje, które są własnością i publikowane w ramach projektu Cloud. Każdy użytkownik z rolą Wydawca aplikacji Earth Engine w Cloud IAM może edytować i usuwać aplikacje opublikowane w ramach projektu Cloud. Więcej informacji o rolach uprawnień Earth Engine

Aby włączyć aplikacje należące do projektu, na etapie „Wybierz uprawnienia do edycji” wybierz opcję Projekt w chmurze i wybierz projekt w chmurze, którego chcesz użyć, a następnie dokończ proces publikowania aplikacji w zwykły sposób. Aplikacja zostanie opublikowana w domenie PROJECT-ID.projects.earthengine.app i będzie mogła być edytowana przez każdego, kto ma rolę wydawcy aplikacji Earth Engine w projekcie Cloud.

Publikowanie aplikacji należącej do projektu
Publikowanie aplikacji należącej do projektu

Aby wyświetlić aplikacje w projekcie Cloud, kliknij przycisk DODAJ PROJEKT CLOUD i wybierz projekt Cloud.

Dodawanie projektu Cloud
Dodaj projekt Cloud

Aby udostępnić projekt Cloud innym osobom, kliknij przycisk UDOSTĘPNIJ PROJEKT. Spowoduje to przejście na stronę uprawnień Cloud Console dla projektu, na której możesz przyznać współpracownikom rolę uprawnień wydawcy aplikacji Earth Engine.

Włączanie aplikacji należących do projektu
Edytowanie i usuwanie aplikacji należących do projektu

Najczęstsze pytania

Jak usunąć aplikację z galerii aplikacji?
Pole wyboru „Poleć tę aplikację” na stronie konfiguracji aplikacji określa, czy aplikacja będzie widoczna na stronie Polecane aplikacje. Aplikacje z ograniczonym dostępem nie mogą być wyróżniane.
Czy mój kod Earth Engine jest widoczny?
Tak, każdy, kto ma dostęp do aplikacji. Chociaż nie jest to wyraźnie widoczne, gdy aplikacja jest opublikowana, można łatwo wyświetlić kod JavaScript aplikacji, obserwując ruch sieciowy w przeglądarce. Na przykład w Chrome kod JavaScript będzie widoczny na karcie Sieć w Narzędziach dla deweloperów.
Jakie mogą być przyczyny błędu „Wystąpił błąd podczas wczytywania niektórych elementów mapy” w opublikowanej aplikacji?
Upewnij się, że wszystkie komponenty obrazów lub tabel używanych w aplikacji są udostępniane publicznie lub tylko tej aplikacji. W oknie udostępniania komponenta wybierz opcję „Każdy może odczytać” lub wybierz nazwę aplikacji z listy rozwijanej. W przypadku aplikacji ograniczonych do grupy dyskusyjnej Google udostępnienie komponentu tej grupie nie spowoduje, że będzie on widoczny dla aplikacji. Komponenty należy udostępnić aplikacji lub udostępnić je publicznie.
Dlaczego wyświetla się strona „Aplikacja nie jest jeszcze gotowa”?
Po utworzeniu aplikacji może minąć trochę czasu, zanim informacje zostaną rozpowszechnione w systemie. Zwykle zajmuje to kilka minut. Jeśli błąd będzie się powtarzał, skontaktuj się z zespołem pomocy.
Dlaczego narysowane przeze mnie geometrie są widoczne w aplikacji?
Umożliwia to wyświetlanie geometrii referencyjnych w aplikacji oraz tworzenie aplikacji, w których użytkownicy mogą edytować geometrie. Jeśli nie chcesz, aby określone geometrie były widoczne lub edytowane, możesz ukryć lub zablokować poszczególne warstwy geometrii, aby uniemożliwić użytkownikom ich wyświetlanie lub edytowanie przed opublikowaniem aplikacji. Więcej informacji znajdziesz w  dokumentacji narzędzi geometrii.
Co to jest limit aplikacji?
Aby zapobiec negatywnemu wpływowi błędnych skryptów lub skryptów intensywnie wykorzystujących zasoby na dostępność usługi, Earth Engine ma limity użycia aplikacji dotyczące jednoczesnych zapytań. Ta pula działa podobnie do puli na użytkownika w Earth Engine, z tym wyjątkiem, że jest powiązana z aplikacją, a nie z konkretnym użytkownikiem.
Czy każda aplikacja ma swój limit?
Tak, z każdą aplikacją jest powiązany osobny limit. W przypadku starszych aplikacji utworzonych za pomocą klucza interfejsu API limit jest powiązany z projektem Cloud, z którego wygenerowano klucz interfejsu API aplikacji. Jeśli wygenerujesz wiele kluczy interfejsu API z tego samego projektu Cloud, wszystkie będą miały ten sam limit wykorzystania.
Dlaczego wymagane jest konto rozliczeniowe Cloud? Czy będę płacić za aplikacje?
Korzystamy z Google Cloud Platform do wykonywania różnych zadań w tle. Nie będziesz płacić za utworzenie aplikacji Earth Engine. Usługa Google Cloud Storage jest jednak płatna, więc jeśli zdecydujesz się wyeksportować wyniki analiz do Google Cloud Storage, może to wiązać się z opłatą.
Jak mogę lepiej zrozumieć wykorzystanie aplikacji i limity?

Jeśli limit zostanie przekroczony, Earth Engine może zwrócić błędy HTTP 429: Too Many Requests. Zwykle te błędy są obsługiwane przez bibliotekę klienta Earth Engine, która otacza żądania odczekaniem wykładniczym i powtarza zapytanie, aż do skutku. Biblioteka klienta Earth Engine spróbuje ponownie wysłać żądanie 5 razy.

Jeśli Twoja aplikacja stanie się na tyle popularna, że wielu użytkowników będzie otrzymywać błędy związane z przekroczeniem limitu, zobaczą oni ostrzeżenie, a Earth Engine może (tymczasowo) ograniczyć dostęp do aplikacji.

Aby uniknąć błędów 429, możesz włączyć w aplikacji buforowanie, na przykład przechowując statystyki zbiorcze, które można przechowywać w buforze, jako zasoby tabeli Earth Engine, zamiast obliczać je na bieżąco.