Wprowadzenie
Aplikacje Earth Engine to dynamiczne, możliwe do udostępniania interfejsy użytkownika do analiz Earth Engine. Dzięki aplikacjom eksperci mogą używać prostych elementów interfejsu, aby wykorzystywać Data Catalog i możliwości analityczne Earth Engine, z których mogą korzystać zarówno eksperci, jak i osoby niebędące ekspertami.
Aplikacje opublikowane z Earth Engine są dostępne pod adresem URL wygenerowanym w momencie publikacji. Do wyświetlania opublikowanej aplikacji i interakcji z nią nie jest wymagane konto Earth Engine. Aplikacje wybrane przez twórcę jako polecane są też dostępne w galerii aplikacji użytkownika (np. NAZWA_UŻYTKOWNIKA.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 interfejsu użytkownika został zaprojektowany z myślą o deweloperach aplikacji. Jeśli dopiero zaczynasz korzystać z interfejsu API interfejsu użytkownika, zapoznaj się z omówieniem interfejsu API interfejsu użytkownika.
Publikowanie aplikacji
Aby opublikować aplikację z edytora kodu, najpierw wczytaj skrypt, który chcesz przekształcić w aplikację, a następnie otwórz panel zarządzania aplikacjami, klikając przycisk Aplikacje nad sekcją skryptu w edytorze kodu.
Następnie kliknij przycisk NEW APP (Nowa aplikacja).
W oknie wybierz uprawnienia do edycji, nazwę aplikacji, projekt w chmurze Google Cloud i określ lokalizację kodu źródłowego aplikacji. Ogranicz dostęp do tej aplikacji do określonej grupy dyskusyjnej Google lub zachowaj jej publiczny dostęp, korzystając z opcji na karcie Ograniczenia. W przypadku aplikacji dostępnych publicznie możesz też podać niestandardowy obraz podglądu aplikacji oraz opis na karcie Galeria. Kliknij „Wyróżnij tę aplikację w Galerii aplikacji”, jeśli chcesz, aby ta aplikacja była widoczna w publicznej galerii aplikacji dostępnej pod adresem USERNAME.users.earthengine.app. Opcjonalnie możesz dodać niestandardowe logo w lewym górnym rogu aplikacji, przesyłając wybrany obraz na karcie Logo.
Zarządzanie aplikacjami
Aby zarządzać aplikacją z poziomu edytora kodu, otwórz panel zarządzania aplikacjami, klikając przycisk Aplikacje nad sekcją skryptu w edytorze kodu. Możesz tam zaktualizować konfigurację aplikacji lub ją usunąć.
Współpraca z innymi osobami nad aplikacjami należącymi do projektu
Domyślnie aplikacje opublikowane pod Twoją nazwą użytkownika możesz edytować tylko Ty. 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ą projektu w chmurze i są w nim publikowane. Każdy, kto ma rolę uprawnień Wydawca aplikacji Earth Engine, może edytować i usuwać aplikacje opublikowane w ramach projektu w chmurze. Więcej informacji o rolach uprawnień Earth Engine
Aby włączyć aplikacje należące do projektu, w kroku „Wybierz uprawnienia do edycji” wybierz opcję Projekt w chmurze i wskaż 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żdą osobę, która ma rolę uprawnień wydawcy aplikacji Earth Engine w projekcie w chmurze.
Aby wyświetlić aplikacje w projekcie w chmurze, naciśnij przycisk DODAJ PROJEKT W CHMURZE i wybierz projekt w chmurze.
Aby udostępnić projekt w chmurze innym osobom, kliknij przycisk UDOSTĘPNIJ PROJEKT. Spowoduje to przejście na stronę uprawnień w konsoli Cloud dla projektu, na której możesz przyznać współpracownikom rolę uprawnień wydawcy aplikacji Earth Engine.
Najczęstsze pytania
- Jak usunąć aplikację z Galerii aplikacji?
- Pole wyboru „Poleć tę aplikację” na stronie konfiguracji aplikacji określa, czy aplikacja pojawia się na stronie Polecane aplikacje. Aplikacje z ograniczonym dostępem nie mogą być promowane.
- Czy mój kod Earth Engine jest widoczny?
- Tak, dla każdego, kto ma dostęp do aplikacji. Chociaż nie jest on wyraźnie widoczny po opublikowaniu aplikacji, każdy może łatwo wyświetlić kod JavaScript aplikacji, obserwując ruch w sieci do swojej przeglądarki. Na przykład w Chrome kod JavaScript będzie widoczny w panelu Sieć w Narzędziach dla programistów.
- Jakie są możliwe przyczyny błędu „Podczas wczytywania niektórych elementów mapy wystąpił błąd” w opublikowanej aplikacji?
- Upewnij się, że wszystkie zasoby obrazów lub tabel używane w aplikacji są udostępniane publicznie lub aplikacji. W oknie udostępniania zasobów wybierz opcję „Każdy może odczytać” lub wybierz nazwę aplikacji z listy. W przypadku aplikacji ograniczonych do Grupy dyskusyjnej Google udostępnienie zasobu tej grupie nie spowoduje, że będzie on widoczny dla aplikacji. Zasoby należy udostępnić aplikacji lub 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 problem zostaje rozwiązany w ciągu kilku minut. Jeśli błąd będzie się powtarzał, skontaktuj się z nami.
- Dlaczego narysowane przeze mnie geometrie są widoczne w aplikacji?
- Ułatwia to wyświetlanie geometrii referencyjnych w aplikacji i pozwala tworzyć aplikacje, w których użytkownicy mogą edytować geometrie. Jeśli nie chcesz, aby określone geometrie były wyświetlane 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 do geometrii.
- Czym jest limit aplikacji?
- Aby zapobiec negatywnemu wpływowi błędnych lub wymagających dużej ilości zasobów skryptów na dostępność usługi, Earth Engine ma limity wykorzystania aplikacji w przypadku równoczesnych zapytań. Ten limit działa podobnie do limitu na użytkownika w Earth Engine, ale jest powiązany z aplikacją, a nie z konkretnym użytkownikiem.
- Czy każda utworzona przeze mnie aplikacja ma własny 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 w chmurze, z którego generujesz klucz interfejsu API aplikacji. Jeśli wygenerujesz wiele kluczy interfejsu API z tego samego projektu w chmurze, wszystkie będą miały ten sam limit wykorzystania.
- Dlaczego wymagane jest konto rozliczeniowe Cloud? Czy zostaną naliczone opłaty za aplikacje?
- Używamy Google Cloud Platform do różnych zadań wykonywanych w tle. Za utworzenie aplikacji Earth Engine nie zostaną naliczone żadne opłaty. Google Cloud Storage nie jest jednak bezpłatny, więc jeśli zdecydujesz się wyeksportować wyniki analiz do Google Cloud Storage, może zostać naliczona opłata.
- Jak mogę lepiej zrozumieć wykorzystanie i limity aplikacji?
-
Jeśli limit zostanie przekroczony, Earth Engine może zwracać błędy
HTTP 429: Too Many Requests. Zasadniczo te błędy są obsługiwane przez bibliotekę klienta Earth Engine, która opakowuje żądania w ramach wzrastającego czasu do ponowienia i ponawia zapytanie, dopóki nie zostanie ono wykonane. Biblioteka klienta Earth Engine ponowi próbę wysłania żądania 5 razy.Jeśli Twoja aplikacja stanie się tak popularna, że wielu użytkowników będzie otrzymywać błędy związane z przekroczeniem limitu, użytkownicy zobaczą komunikat ostrzegawczy, a Earth Engine może (tymczasowo) ograniczyć dostęp do aplikacji.
Aby uniknąć błędów 429, możesz włączyć buforowanie w aplikacji, np. przez przechowywanie możliwych do buforowania statystyk zbiorczych jako zasobów tabeli Earth Engine, zamiast obliczać je na bieżąco.