Nếu initialize() được gọi lần đầu ở chế độ không đồng bộ (bằng cách truyền lệnh gọi lại thành công), thì mọi lệnh gọi chế độ không đồng bộ trong tương lai sẽ thêm lệnh gọi lại vào hàng đợi và tất cả lệnh gọi lại sẽ được chạy cùng nhau.
Nếu một lệnh gọi chế độ đồng bộ được thực hiện sau một số lệnh gọi không đồng bộ, thì lệnh gọi đó sẽ chặn và thực thi tất cả các lệnh gọi lại đã cung cấp trước đó trước khi trả về.
Trong hầu hết các trường hợp, bạn nên đặt mã thông báo uỷ quyền trước khi khởi chạy thư viện, bằng ee.data.authorize() hoặc ee.data.setAuthToken().
Trong Python, phương thức này có tên là ee.Initialize, với chữ I viết hoa. Xin lưu ý rằng một số tham số khác nhau giữa JavaScript và Python. Ngoài opt_url và project bên dưới, Python cũng hỗ trợ: credentials – một đối tượng google.oauth2.Credentials hoặc "persistent" để sử dụng thông tin xác thực được lưu trữ (mặc định); http_transport – một máy khách HTTP httplib2.
| Cách sử dụng | Giá trị trả về |
|---|---|
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project) |
| Đối số | Loại | Chi tiết |
|---|---|---|
baseurl | Chuỗi, không bắt buộc | Điểm cuối API REST của Earth Engine. (Tên đối số Python: opt_url) |
tileurl | Chuỗi, không bắt buộc | Điểm cuối của ô REST trong Earth Engine, đây là thông tin không bắt buộc và mặc định là baseurl. (Chỉ JavaScript) |
successCallback | Hàm, không bắt buộc | Lệnh gọi lại không bắt buộc được gọi khi khởi chạy thành công. Nếu không được cung cấp, quá trình khởi chạy sẽ được thực hiện đồng bộ. (Chỉ JavaScript) |
errorCallback | Hàm, không bắt buộc | Một lệnh gọi lại không bắt buộc được gọi kèm theo lỗi nếu quá trình khởi chạy không thành công. (Chỉ JavaScript) |
xsrfToken | Chuỗi, không bắt buộc | Một chuỗi để truyền vào tham số "xsrfToken" của XHR API EE. (Chỉ JavaScript) |
project | Chuỗi, không bắt buộc | Mã hoặc số dự án khách hàng (không bắt buộc) để sử dụng khi thực hiện lệnh gọi API. (Tên đối số Python: project) |