ee.initialize
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Khởi chạy thư viện. Nếu chưa được gọi vào thời điểm bất kỳ hàm dựng đối tượng nào được dùng, thì hàm này sẽ được gọi sau đó. Nếu phương thức này được gọi lần thứ hai bằng một baseurl hoặc tileurl khác, thì phương thức này sẽ không huỷ khởi tạo, ví dụ: Các thuật toán đã tải trước đó, nhưng sẽ ghi đè các thuật toán đó và cho phép trỏ đến các máy chủ thay thế.
Nếu initialize() được gọi lần đầu tiên ở chế độ không đồng bộ (bằng cách truyền một 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 của chúng vào một hàng đợi và tất cả các lệnh gọi lại sẽ 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 thư viện được khởi chạy, 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 đã lưu trữ (mặc định); http_transport – một ứng dụng httplib2.Http.
| Cách sử dụng | Giá trị trả về |
|---|
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project) | |
| Đối số | Loại | Thông tin chi tiết |
|---|
baseurl | Chuỗi, không bắt buộc | Điểm cuối Earth Engine REST API.
(Tên đối số Python: opt_url) |
tileurl | Chuỗi, không bắt buộc | Điểm cuối của ô REST Earth Engine, đây là điểm cuối không bắt buộc và mặc định là baseurl. (Chỉ JavaScript) |
successCallback | Hàm, không bắt buộc | Một lệnh gọi lại không bắt buộc sẽ được gọi khi quá trình khởi chạy thành công. Nếu không được cung cấp, quá trình khởi tạo 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 sẽ được gọi kèm theo một 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 EE API XHR. (Chỉ JavaScript) |
project | Chuỗi, không bắt buộc | Mã dự án hoặc số dự án ứng dụ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) |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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) |"]]
