ee.initialize
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zainicjuj bibliotekę. Jeśli nie zostanie wywołana przed użyciem konstruktora obiektu, zostanie wywołana wtedy. Jeśli ta funkcja zostanie wywołana po raz drugi z innym adresem baseurl lub tileurl, nie spowoduje to wycofania inicjowania np. wcześniej załadowanych algorytmów, ale spowoduje ich zastąpienie i umożliwi wskazywanie alternatywnych serwerów.
Jeśli funkcja initialize() zostanie najpierw wywołana w trybie asynchronicznym (przez przekazanie wywołania zwrotnego sukcesu), wszystkie przyszłe wywołania w trybie asynchronicznym będą dodawać swoje wywołania zwrotne do kolejki, a wszystkie wywołania zwrotne zostaną uruchomione razem.
Jeśli po dowolnej liczbie wywołań asynchronicznych zostanie wykonane wywołanie w trybie synchronicznym, przed zwróceniem wartości zablokuje ono i wykona wszystkie wcześniej dostarczone wywołania zwrotne.
W większości przypadków token autoryzacji należy ustawić przed zainicjowaniem biblioteki, używając funkcji ee.data.authorize() lub ee.data.setAuthToken().
W Pythonie ta metoda nazywa się ee.Initialize i zaczyna się od wielkiej litery I. Pamiętaj, że niektóre parametry różnią się w zależności od tego, czy używasz JavaScriptu czy Pythona. Oprócz opcji opt_url i project Python obsługuje też: credentials – obiekt google.oauth2.Credentials lub „persistent” (trwałe) do używania zapisanych 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 REST Earth Engine. Jest to opcjonalne i domyślnie ustawione na baseurl. (tylko JavaScript) |
successCallback | Funkcja (opcjonalnie) | Opcjonalne wywołanie zwrotne, które ma zostać wywołane po pomyślnym zainicjowaniu. Jeśli nie podasz tego parametru, inicjowanie zostanie wykonane synchronicznie. (tylko JavaScript) |
errorCallback | Funkcja (opcjonalnie) | Opcjonalne wywołanie zwrotne, które ma być wywoływane z błędem, jeśli inicjalizacja 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 lub numer projektu klienta do użycia podczas wywoływania interfejsu API. (Nazwa argumentu w Pythonie: project) |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eee.initialize()\u003c/code\u003e function initializes the Earth Engine library, setting the API endpoint and optional tile server.\u003c/p\u003e\n"],["\u003cp\u003eInitialization can be performed synchronously or asynchronously with success and error callbacks.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization should typically be handled before initialization using \u003ccode\u003eee.data.authorize()\u003c/code\u003e or \u003ccode\u003eee.data.setAuthToken()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eee.initialize()\u003c/code\u003e offers parameters for customization, like base URL, tile URL, and project ID.\u003c/p\u003e\n"],["\u003cp\u003eThe Python equivalent is \u003ccode\u003eee.Initialize()\u003c/code\u003e, with minor parameter differences compared to JavaScript.\u003c/p\u003e\n"]]],[],null,["# ee.initialize\n\n\u003cbr /\u003e\n\nInitialize the library. If this hasn't been called by the time any object constructor is used, it will be called then. If this is called a second time with a different baseurl or tileurl, this doesn't do an un-initialization of e.g.: the previously loaded Algorithms, but will overwrite them and let point at alternate servers.\n\n\u003cbr /\u003e\n\nIf initialize() is first called in asynchronous mode (by passing a success callback), any future asynchronous mode calls will add their callbacks to a queue and all the callbacks will be run together.\n\nIf a synchronous mode call is made after any number of asynchronous calls, it will block and execute all the previously supplied callbacks before returning.\n\nIn most cases, an authorization token should be set before the library is initialized, either with ee.data.authorize() or ee.data.setAuthToken().\n\nIn Python, this method is named ee.Initialize, with a capital I. Note that some parameters differ between JavaScript and Python. In addition to opt_url and project below, Python also supports: credentials - a google.oauth2.Credentials object or 'persistent' to use stored credentials (the default); http_transport - a httplib2.Http client.\n\n| Usage | Returns |\n|--------------------------------------------------------------------------------------------------------------------|---------|\n| `ee.initialize(`*baseurl* `, `*tileurl* `, `*successCallback* `, `*errorCallback* `, `*xsrfToken* `, `*project*`)` | |\n\n| Argument | Type | Details |\n|-------------------|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `baseurl` | String, optional | The Earth Engine REST API endpoint. (Python argument name: opt_url) |\n| `tileurl` | String, optional | The Earth Engine REST tile endpoint, this is optional and defaults to baseurl. (JavaScript only) |\n| `successCallback` | Function, optional | An optional callback to be invoked when the initialization is successful. If not provided, the initialization is done synchronously. (JavaScript only) |\n| `errorCallback` | Function, optional | An optional callback to be invoked with an error if the initialization fails. (JavaScript only) |\n| `xsrfToken` | String, optional | A string to pass in the \"xsrfToken\" parameter of EE API XHRs. (JavaScript only) |\n| `project` | String, optional | Optional client project ID or number to use when making API calls. (Python argument name: project) |"]]
