Jeśli funkcja initialize() zostanie najpierw wywołana w trybie asynchronicznym (przez przekazanie wywołania zwrotnego po powodzeniu), wszystkie przyszłe wywołania w trybie asynchronicznym dodadzą swoje wywołania zwrotne do kolejki i wszystkie wywołania zwrotne zostaną uruchomione razem.
Jeśli wywołanie w trybie synchronicznym zostanie wykonane po dowolnej liczbie wywołań asynchronicznych, zablokuje ono i wykona wszystkie wcześniej dostarczone wywołania zwrotne przed zwróceniem.
W większości przypadków token autoryzacji powinien być ustawiony przed zainicjowaniem biblioteki za pomocą funkcji ee.data.authorize() lub ee.data.setAuthToken().
W Pythonie ta metoda nosi nazwę ee.Initialize (z wielką literą I). Pamiętaj, że niektóre parametry różnią się w zależności od tego, czy używasz JavaScriptu czy Pythona. Oprócz parametrów opt_url i project poniżej Python obsługuje też: credentials – obiekt google.oauth2.Credentials lub „persistent”, aby używać przechowywanych danych logowania (domyślnie); http_transport – klient httplib2.Http.
| Wykorzystanie | Zwroty |
|---|---|
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project) |
| Argument | Typ | Szczegóły |
|---|---|---|
baseurl | Ciąg znaków (opcjonalnie) | Punkt końcowy interfejsu Earth Engine REST API. (nazwa argumentu w Pythonie: opt_url) |
tileurl | Ciąg znaków (opcjonalnie) | Punkt końcowy kafelka REST Earth Engine. Jest to opcjonalne i domyślnie ustawione na baseurl. (tylko JavaScript) |
successCallback | Funkcja (opcjonalnie) | Opcjonalne wywołanie zwrotne, które zostanie wywołane po pomyślnej inicjalizacji. Jeśli nie zostanie podany, inicjowanie zostanie wykonane synchronicznie. (tylko JavaScript) |
errorCallback | Funkcja (opcjonalnie) | Opcjonalne wywołanie zwrotne, które zostanie wywołane z błędem, jeśli inicjowanie się nie powiedzie. (tylko JavaScript) |
xsrfToken | Ciąg znaków (opcjonalnie) | Ciąg znaków do przekazania w parametrze „xsrfToken” żądań XHR interfejsu EE API. (tylko JavaScript) |
project | Ciąg znaków (opcjonalnie) | Opcjonalny identyfikator projektu klienta lub numer do użycia podczas wywoływania interfejsu API. (nazwa argumentu w Pythonie: project) |