如果 initialize() 是先在非同步模式下呼叫 (透過傳遞成功回呼),日後任何非同步模式呼叫都會將回呼新增至佇列,且所有回呼都會一起執行。
如果在任何數量的非同步呼叫後進行同步模式呼叫,系統會封鎖並執行所有先前提供的回呼,然後再傳回。
在多數情況下,應在初始化程式庫前,使用 ee.data.authorize() 或 ee.data.setAuthToken() 設定授權權杖。
在 Python 中,這個方法名為 ee.Initialize,其中 I 為大寫。請注意,JavaScript 和 Python 的部分參數不同。除了下方的 opt_url 和 project 之外,Python 也支援:credentials - google.oauth2.Credentials 物件或「persistent」,用於使用儲存的憑證 (預設);http_transport - httplib2.Http 用戶端。
| 用量 | 傳回 |
|---|---|
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project) |
| 引數 | 類型 | 詳細資料 |
|---|---|---|
baseurl | 字串,選填 | Earth Engine REST API 端點。 (Python 引數名稱:opt_url) |
tileurl | 字串,選填 | Earth Engine REST 圖塊端點,這是選用項目,預設為 baseurl。(僅限 JavaScript) |
successCallback | 函式 (選用) | 初始化成功時叫用的選用回呼。如未提供,系統會同步執行初始化作業。(僅限 JavaScript) |
errorCallback | 函式 (選用) | 如果初始化失敗,系統會叫用選用的回呼,並傳回錯誤。(僅限 JavaScript) |
xsrfToken | 字串,選填 | 要在 EE API XHR 的「xsrfToken」參數中傳遞的字串。(僅限 JavaScript) |
project | 字串,選填 | 發出 API 呼叫時,可選擇使用的用戶端專案 ID 或編號。(Python 引數名稱:project) |