Bạn có thể cài đặt Earth Engine Python API vào máy cục bộ thông qua conda, một trình quản lý môi trường và gói Python. Conda được đi kèm với các bản phân phối Python Anaconda và Miniconda. Anaconda là một nền tảng lập trình khoa học dữ liệu bao gồm hơn 1.500 gói, trong khi Miniconda chỉ bao gồm conda và các phần phụ thuộc của nó. Một trong hai bản phân phối Python này đều phù hợp để cài đặt và làm việc với Earth Engine API. Nếu bạn chưa biết đến những bản phân phối này, vui lòng truy cập vào đường liên kết của họ để tìm hiểu thêm.
Hướng dẫn này sẽ hướng dẫn bạn:
- Kiểm tra xem có bản cài đặt conda hiện có hay không
- Cài đặt conda trên máy cục bộ
- Cài đặt Earth Engine Python API
- Thiết lập thông tin xác thực
- Kiểm thử API
Kiểm tra xem có lệnh cài đặt conda hay không
Nếu conda đã được cài đặt trên hệ thống của bạn, hãy chuyển đến phần Cài đặt API. Nếu bạn không chắc chắn liệu conda đã được cài đặt hay chưa, hãy xác minh bằng cách nhập lệnh sau vào giao diện dòng lệnh.
conda --help
Nếu conda đã được cài đặt và đường dẫn hệ thống của conda được đăng ký trong biến môi trường PATH, thì nội dung trợ giúp của conda sẽ xuất hiện trong thiết bị đầu cuối. Nếu nội dung trợ giúp xuất hiện, hãy chuyển đến phần Cài đặt API. Nếu conda không được nhận dạng, kết quả sẽ có nội dung như sau: conda not found or not recognized as a command (không tìm thấy conda hoặc không nhận dạng được conda là một lệnh). Có thể chương trình này tồn tại trên hệ thống của bạn nhưng chưa được đăng ký trong biến môi trường PATH. Ngay cả khi bạn đã cài đặt conda, để đảm bảo tính nhất quán, vui lòng tiếp tục với phần Cài đặt conda vì rất khó để giải quyết tất cả các cấu hình hệ thống có thể có. Miễn là thư mục "miniconda3" không tồn tại trong thư mục Home, các hướng dẫn cài đặt conda sau đây sẽ thành công. Để biết thêm thông tin về vị trí cài đặt và đăng ký conda, vui lòng xem các trang Cài đặt Miniconda và Cài đặt Anaconda.
Cài đặt conda
Trong phần này, bạn sẽ tải và cài đặt Miniconda. Đây sẽ là nền tảng Python để truy cập vào Earth Engine API. Như mô tả ở trên, bạn có thể sử dụng Miniconda hoặc Anaconda, nhưng để giảm thiểu tác động đến hệ thống, hướng dẫn này sẽ mô tả quy trình cài đặt Miniconda mà không làm thay đổi các biến môi trường của hệ thống. Nếu bạn muốn dùng Anaconda, vui lòng xem hướng dẫn cài đặt tại đây rồi chuyển đến phần Cài đặt API.
Cài đặt Miniconda
Quá trình tải xuống và cài đặt Miniconda được thực hiện qua 3 bước:
- Tải trình cài đặt Miniconda Python 3 64 bit xuống thư mục Home
- Chạy trình cài đặt
- Xoá trình cài đặt
Hoàn tất các bước này bằng cách sao chép và dán các dòng sau vào giao diện dòng lệnh thích hợp cho hệ thống của bạn. Quá trình cài đặt sẽ thêm một thư mục có tên "miniconda3" vào thư mục Home (Trang chủ) của bạn.
1. Tải trình cài đặt Miniconda xuống thư mục Home.
Linux
wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh
Mac
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh
Windows
powershell -command "Invoke-WebRequest -Uri https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"
2. Cài đặt Miniconda ở chế độ im lặng, chấp nhận các giá trị mặc định, vào thư mục Home.
Linux
bash ~/miniconda.sh -b
Mac
bash ~/miniconda.sh -b
Windows
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda3
3. Xoá trình cài đặt Miniconda khỏi thư mục Home.
Linux
rm ~/miniconda.sh
Mac
rm ~/miniconda.sh
Windows
del %UserProfile%\miniconda.exe
Kiểm tra quá trình cài đặt Miniconda
In trình đơn trợ giúp của lệnh conda để kiểm thử quá trình cài đặt Miniconda.
Vì Miniconda chưa được thêm vào biến môi trường PATH của hệ thống, nên trước tiên, bạn cần kích hoạt conda cho phiên này bằng cách gọi lệnh activate theo đường dẫn hệ thống đầy đủ của lệnh. Một thử nghiệm thành công sẽ dẫn đến việc nội dung trợ giúp conda xuất hiện trong thiết bị đầu cuối. Chạy các dòng sau trong giao diện dòng lệnh của hệ thống.
Linux
source $HOME/miniconda3/bin/activate conda --help
Mac
source $HOME/miniconda3/bin/activate conda --help
Windows
%UserProfile%\miniconda3\condabin\activate conda --help
Thêm Miniconda vào biến PATH
Bạn có thể tuỳ ý thêm đường dẫn cài đặt Miniconda vào biến PATH của hệ thống. Việc này sẽ cho phép bạn tương tác với conda bằng một lệnh gọi đơn giản đến conda mà không cần chạy lệnh activate theo đường dẫn đầy đủ trước. Hướng dẫn sau đây sẽ hướng dẫn bạn cách thêm bản cài đặt Miniconda vào biến PATH của hệ thống.
Linux
Thêm đường dẫn sau vào biến môi trường "PATH" bằng cách hoàn tất hướng dẫn về GUI hoặc dòng lệnh bên dưới.
$HOME/miniconda3/bin
GUI
1. Mở tệp .bashrc trong thư mục $HOME bằng một trình chỉnh sửa văn bản.
xdg-open ~/.bashrc
2. Sao chép và dán các dòng sau vào cuối tệp.
# add path to conda export PATH="$HOME/miniconda3/bin:$PATH"
3. Lưu tệp và đóng trình chỉnh sửa văn bản.
Dòng lệnh
Nhập lệnh sau vào một thiết bị đầu cuối để thêm đường dẫn conda vào tệp ~/.bashrc.
printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc
Mac
Thêm đường dẫn sau vào biến môi trường "PATH" bằng cách hoàn tất hướng dẫn về GUI hoặc dòng lệnh bên dưới.
$HOME/miniconda3/bin
GUI
1. Mở tệp .bashrc trong thư mục $HOME bằng một trình chỉnh sửa văn bản.
touch ~/.bashrc; open -t ~/.bashrc
2. Sao chép và dán các dòng sau vào cuối tệp.
# add path to conda export PATH="$HOME/miniconda3/bin:$PATH"
3. Lưu tệp và đóng trình chỉnh sửa văn bản.
Dòng lệnh
Nhập lệnh sau vào một thiết bị đầu cuối để thêm đường dẫn conda vào tệp ~/.bashrc.
printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc
Windows
Thêm đường dẫn sau vào biến môi trường "Path" bằng cách hoàn tất một trong hai hướng dẫn về GUI hoặc dòng lệnh bên dưới.
%UserProfile%\miniconda3\condabin
GUI
1. Nhập dòng sau vào dấu nhắc lệnh để mở hộp thoại "Biến môi trường".
rundll32 sysdm.cpl,EditEnvironmentVariables
2. Nhấp đúp vào biến "Path" (Đường dẫn) trong phần "User" (Người dùng) để chọn biến này để chỉnh sửa.
3. Nhấp vào nút "Chỉnh sửa văn bản" trong cửa sổ hộp thoại "Chỉnh sửa" mới để mở trình chỉnh sửa.
4. Thêm chuỗi sau vào cuối giá trị biến "Path" hiện có. Đảm bảo rằng dấu chấm phẩy (;) bao quanh mục nhập để phân biệt mục nhập đó với các mục nhập lân cận.
%UserProfile%\miniconda3\condabin;
5. Nhấp vào nút "OK" cho đến khi tất cả cửa sổ hộp thoại đều đóng.
Dòng lệnh
Sử dụng lệnh setx để thêm đường dẫn. Trên giao diện nhập dòng lệnh, hãy nhập:
setx Path "%Path%%UserProfile%\miniconda3\condabin;"
Khởi chạy conda
Khởi động conda để tương tác với shell. Chạy lệnh tiếp theo để biết thông tin về quá trình khởi chạy cho nhiều shell. Làm theo các hướng dẫn tiếp theo được in vào bảng điều khiển khi bạn nhập lệnh.
conda init --help
Sau khi khởi động lại giao diện dòng lệnh, bạn có thể kích hoạt môi trường conda cơ sở bằng lệnh sau.
conda activate
Install API
Earth Engine Python API được phân phối dưới dạng một gói conda-forge tại: https://anaconda.org/conda-forge/earthengine-api.
Công cụ này được cài đặt bằng lệnh conda install. Tuy nhiên, trước khi cài đặt, hãy tạo một môi trường conda dành riêng cho Earth Engine.
Việc cài đặt Earth Engine API vào môi trường riêng đảm bảo rằng API này và các gói phụ thuộc của nó sẽ không gây ra vấn đề về phiên bản với môi trường cơ sở hoặc bất kỳ môi trường nào khác mà bạn đã thiết lập trước đó và ngược lại. Để biết thêm thông tin về cách quản lý môi trường conda, vui lòng truy cập vào trang web này.
1. Kích hoạt môi trường conda cơ bản (nếu chưa kích hoạt).
Linux
source $HOME/miniconda3/bin/activate
Mac
source $HOME/miniconda3/bin/activate
Windows
%UserProfile%\miniconda3\condabin\activate
2. Tạo một môi trường ảo conda cho Earth Engine API.
conda create --name ee
Bạn sẽ được yêu cầu xác nhận việc tạo môi trường, hãy xác nhận.
3. Kích hoạt môi trường conda ee.
conda activate ee
4. Cài đặt API vào môi trường conda ee. Đảm bảo rằng (ee) xuất hiện ở đầu dòng lệnh, cho biết bạn đang làm việc trong môi trường ee.
conda install -c conda-forge earthengine-api
Bạn sẽ được yêu cầu xác nhận việc cài đặt API và các phần phụ thuộc của API. Sau khi xác nhận, conda sẽ tải xuống và cài đặt các phần phụ thuộc. Nếu mọi việc diễn ra suôn sẻ, bạn sẽ có một môi trường conda có tên là "ee" với tất cả các yêu cầu để truy cập vào API, cũng như earthengine công cụ dòng lệnh.
Lấy thông tin đăng nhập
Trước khi sử dụng Earth Engine API hoặc công cụ dòng lệnh earthengine, bạn phải thực hiện quy trình xác thực một lần để cấp quyền truy cập vào Earth Engine thay cho Tài khoản Google của bạn. Để xác thực, hãy sử dụng lệnh authenticate trong công cụ dòng lệnh earthengine.
Trong môi trường conda ee, hãy chạy lệnh sau và làm theo hướng dẫn được in ra. Một URL sẽ được cung cấp để tạo mã uỷ quyền khi bạn đồng ý. Sao chép mã uỷ quyền rồi nhập mã đó làm dữ liệu đầu vào dòng lệnh.
earthengine authenticate
Sau khi bạn nhập mã uỷ quyền, mã thông báo uỷ quyền sẽ được lưu vào một tệp thông tin đăng nhập mà bạn có thể tìm thấy bên dưới. Những lần sử dụng tiếp theo của lệnh ee.Initialize() trong API và công cụ dòng lệnh earthengine sẽ tìm đến tệp này để xác thực. Nếu bạn muốn thu hồi quyền uỷ quyền, chỉ cần xoá tệp thông tin đăng nhập.
Linux
ls $HOME/.config/earthengine/credentials
Mac
ls $HOME/.config/earthengine/credentials
Windows
dir %UserProfile%\.config\earthengine\credentials
Kiểm thử API
Chạy một tập lệnh Python đơn giản in siêu dữ liệu cho một tập dữ liệu DEM để kiểm thử quá trình cài đặt API. Thao tác này sẽ in một đối tượng JSON ra bảng điều khiển.
1. Khởi động trình thông dịch python từ môi trường ee của conda.
python
2. Chạy từng dòng Python sau đây để in siêu dữ liệu cho một tập dữ liệu DEM
import ee # Initialize the Earth Engine module. ee.Initialize() # Print metadata for a DEM dataset. print(ee.Image('USGS/SRTMGL1_003').getInfo())
Sử dụng API sau đó
Bất cứ khi nào muốn sử dụng Earth Engine API, trước tiên bạn phải kích hoạt môi trường conda ee. Quy trình kích hoạt phụ thuộc vào việc conda có được đăng ký để sử dụng trong trình bao hay không. Làm theo hướng dẫn bên dưới có liên quan đến bản cài đặt conda của bạn.
Conda chưa được đăng ký
Lệnh kích hoạt môi trường conda ee sau đây giả định rằng conda đã được cài đặt theo hướng dẫn trong phần Cài đặt conda ở trên, tức là đường dẫn cài đặt được giả định dựa trên các bước trước đó. Chạy lệnh sau trong giao diện dòng lệnh.
Linux
source $HOME/miniconda3/bin/activate ee
Mac
source $HOME/miniconda3/bin/activate ee
Windows
%UserProfile%\miniconda3\condabin\activate ee
Đã đăng ký Conda
Lệnh kích hoạt môi trường conda ee sau đây giả định rằng conda đã được đăng ký để sử dụng trong shell hoặc dấu nhắc lệnh theo hướng dẫn trong tài liệu này hoặc bằng các phương tiện khác. Chạy lệnh sau trong giao diện dòng lệnh.
conda activate ee
Sau khi chạy lệnh, bạn sẽ thấy (ee) ở đầu dòng lệnh, cho biết bạn đang làm việc trong môi trường ee.
Giờ đây, bạn đã sẵn sàng bắt đầu trình thông dịch Python và truy cập vào Earth Engine Python API. Vui lòng tham khảo trang Cài đặt Python để biết hướng dẫn chung về cách làm việc với Python API.
Cập nhật API
Sử dụng lệnh conda update để cập nhật môi trường ee lên phiên bản API mới nhất. Hãy nhớ kích hoạt môi trường conda ee trước, nếu môi trường này chưa hoạt động.
conda update -c conda-forge earthengine-api
Lấy số phiên bản hiện đã cài đặt trong Python bằng cách in thuộc tính thư viện ee__version__. Khởi động trình thông dịch Python bằng cách nhập python vào dòng lệnh môi trường conda ee rồi nhập các lệnh sau.
import ee print(ee.__version__)
Chia sẻ môi trường ee
Bạn có thể chia sẻ môi trường Python conda với người khác để đạt được kết quả có thể tái tạo và sao chép, đặc biệt là khi bạn đã cài đặt các gói Python bổ sung. Conda cung cấp một cách thuận tiện để người khác sao chép môi trường của bạn.
Trong môi trường conda ee, hãy chạy lệnh sau để lưu tệp YAML có tên là "ee-shared-env" vào thư mục chính. Tệp này liệt kê các thông số kỹ thuật về môi trường của bạn.
Linux
conda env export > $HOME/ee-shared-env.yml
Mac
conda env export > $HOME/ee-shared-env.yml
Windows
conda env export > %UserProfile%\ee-shared-env.yml
Chia sẻ tệp kết quả và người nhận có thể sao chép môi trường bằng cách chạy lệnh conda sau đây.
conda env create -f path-to-ee-shared-env.yml