Annuncio: tutti i progetti non commerciali registrati per l'utilizzo di Earth Engine prima del
15 aprile 2025 devono
verificare l'idoneità non commerciale per mantenere l'accesso a Earth Engine.
ee.initialize
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Inizializza la libreria. Se non è stato chiamato prima dell'utilizzo di un costruttore di oggetti, verrà chiamato in quel momento. Se viene chiamato una seconda volta con un baseurl o un tileurl diverso, non viene eseguita l'annullamento dell'inizializzazione, ad esempio, degli algoritmi caricati in precedenza, ma vengono sovrascritti e puntano a server alternativi.
Se initialize() viene chiamato per primo in modalità asincrona (passando un callback di successo), tutte le chiamate future in modalità asincrona aggiungeranno i propri callback a una coda e tutti i callback verranno eseguiti insieme.
Se viene effettuata una chiamata in modalità sincrona dopo un numero qualsiasi di chiamate asincrone, bloccherà ed eseguirà tutti i callback forniti in precedenza prima di tornare.
Nella maggior parte dei casi, un token di autorizzazione deve essere impostato prima dell'inizializzazione della libreria, con ee.data.authorize() o ee.data.setAuthToken().
In Python, questo metodo si chiama ee.Initialize, con la I maiuscola. Tieni presente che alcuni parametri differiscono tra JavaScript e Python. Oltre a opt_url e project riportati di seguito, Python supporta anche: credentials, un oggetto google.oauth2.Credentials o "persistent" per utilizzare le credenziali archiviate (impostazione predefinita); http_transport, un client httplib2.Http.
| Utilizzo | Resi |
|---|
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project) | |
| Argomento | Tipo | Dettagli |
|---|
baseurl | Stringa, facoltativa | L'endpoint dell'API REST di Earth Engine.
(Nome argomento Python: opt_url) |
tileurl | Stringa, facoltativa | L'endpoint del riquadro REST di Earth Engine. Questo campo è facoltativo e il valore predefinito è baseurl. (solo JavaScript) |
successCallback | Funzione, facoltativa | Un callback facoltativo da richiamare quando l'inizializzazione ha esito positivo. Se non viene fornito, l'inizializzazione viene eseguita in modo sincrono. (solo JavaScript) |
errorCallback | Funzione, facoltativa | Un callback facoltativo da richiamare con un errore se l'inizializzazione non va a buon fine. (solo JavaScript) |
xsrfToken | Stringa, facoltativa | Una stringa da passare nel parametro "xsrfToken" delle richieste XHR dell'API EE. (solo JavaScript) |
project | Stringa, facoltativa | ID o numero di progetto client facoltativo da utilizzare quando si effettuano chiamate API. (Nome argomento Python: project) |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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) |"]]
