API Python của Earth Engine có thể được cài đặt vào máy cục bộ thông qua conda, gói Python và trình quản lý môi trường. Conda đi kèm với các bản phân phối Anaconda và Python. Anaconda là một nền tảng lập trình khoa học dữ liệu bao gồm hơn 1500 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 API Earth Engine. Nếu bạn không quen với các bản phân phối này, vui lòng truy cập các liên kết của chúng để tìm hiểu thêm
Hướng dẫn này sẽ hướng dẫn bạn qua
- Kiểm tra cài đặt conda hiện có
- Cài đặt conda trên máy cục bộ
- Cài đặt API Python của Earth Engine
- Thiết lập thông tin đăng nhập xác thực
- Kiểm tra API
Kiểm tra cài đặt conda
Nếu conda đã được cài đặt trên hệ thống của bạn, hãy chuyển sang phần. Nếu bạn không chắc liệu conda đã được cài đặt hay chưa, hãy xác minh bằng cách nhập lệnh sau tại giao diện dòng lệnh của bạn
bash ~/miniconda.sh -b -p5
Nếu conda được cài đặt và đường dẫn hệ thống của nó được đăng ký trong biến môi trường PATH, 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 bỏ qua phần. Nếu conda không được nhận dạng, kết quả sẽ đọc một cái gì đó như. conda không tìm thấy hoặc không được công nhận là một lệnh. Có thể chương trình tồn tại trên hệ thống của bạn nhưng không được đăng ký trong biến môi trường PATH. Ngay cả trong trường hợp này, để đảm bảo tính nhất quán, vui lòng tiếp tục với phần này, 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ủa bạn, 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 trang Cài đặt Miniconda và Cài đặt Anaconda
Cài đặt cửa hàng
Lưu ý. Bỏ qua phần nếu conda đã được cài đặt trên hệ thống của bạnTrong phần này, bạn sẽ tải xuống và cài đặt Miniconda, sẽ đóng vai trò là nền tảng Python để truy cập API Earth Engine. 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 của bạn, hướng dẫn này sẽ mô tả cách cài đặt Miniconda mà không thay đổi các biến môi trường của hệ thống. Nếu bạn thích Anaconda hơn, vui lòng xem hướng dẫn cài đặt được cung cấp tại đây và sau đó bỏ qua phần
Cài đặt Miniconda
Tải xuống và cài đặt Miniconda được thực hiện trong ba bước
- Tải xuống trình cài đặt Python 3 Miniconda 64-bit về thư mục Home của bạn
- Chạy trình cài đặt
- Xóa trình cài đặt
Hoàn thành 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. Kết quả cài đặt trong một thư mục có tên 'miniconda3' được thêm vào thư mục Home của bạn
1. Tải xuống trình cài đặt Miniconda vào thư mục Home của bạn
Linux
wget //repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh
Mac
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh
các cửa sổ
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"
2. Cài đặt Miniconda lặng lẽ, chấp nhận mặc định, vào thư mục Home của bạn
Linux
bash ~/miniconda.sh -b -p
Mac
bash ~/miniconda.sh -b -p
các cửa sổ
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda3
3. Xóa trình cài đặt Miniconda khỏi thư mục Home của bạn
Linux
rm ~/miniconda.sh
Mac
rm ~/miniconda.sh
các cửa sổ
del %UserProfile%\miniconda.exe
Kiểm tra cài đặt Miniconda
In menu trợ giúp của lệnh
bash ~/miniconda.sh -b -p6 để kiểm tra 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
bash ~/miniconda.sh -b -p7 bằng đường dẫn hệ thống đầy đủ của nó. Thử nghiệm thành công sẽ dẫn đến
bash ~/miniconda.sh -b -p6 nội dung trợ giúp 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 của bạn
Linux
source $HOME/miniconda3/bin/activate
conda --help
Mac
source $HOME/miniconda3/bin/activate
conda --help
các cửa sổ
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh
1
bash ~/miniconda.sh -b -p9. Lưu ý. Nếu đường dẫn đến Miniconda không được đặt làm biến môi trường, như trong trường hợp cài đặt này, bạn cần kích hoạt Miniconda cho mọi phiên dòng lệnh mới trong tương lai, bao gồm cả việc sử dụng API. Sử dụng lệnh đầu tiên từ đoạn mã trên để kích hoạt Miniconda khi cần
Thêm Miniconda vào biến PATH
Thận trọng. Việc thay đổi biến PATH của hệ thống có thể gây ra những hậu quả không mong muốnBạn có thể tùy ý thêm đường dẫn cài đặt Miniconda vào biến PATH của hệ thống, điều 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 tới
bash ~/miniconda.sh -b -p6 mà không cần phải chạy lệnh
bash ~/miniconda.sh -b -p7 trước bằng đường dẫn đầy đủ của nó. Các hướng dẫn sau đây hướng dẫn cách thêm cài đặt Miniconda vào biến PATH của hệ thống của bạn
Thêm đường dẫn sau vào biến môi trường 'PATH' của bạn bằng cách hoàn thành GUI hoặc hướng dẫn dòng lệnh bên dướiLinux
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda3
2
1. Mở tệp
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda33 được tìm thấy trong thư mục
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda34 của bạn trong trình soạn thảo văn bản
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh2
2. Sao chép và dán các dòng sau vào cuối tệp
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh3
3. Lưu tệp và đóng trình soạn thảo văn bản
Lưu ý. Có thể xóa đường dẫn conda đã thêm bằng cách xóa các dòng vừa thêm. Dòng lệnhNhập lệnh sau vào terminal để nối đường dẫn conda vào tệp
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda35
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh4
Mac
Thêm đường dẫn sau vào biến môi trường 'PATH' của bạn bằng cách hoàn thành GUI hoặc hướng dẫn dòng lệnh bên dưới
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda32GUI
1. Mở tệp
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda33 được tìm thấy trong thư mục
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda34 của bạn trong trình soạn thảo văn bản
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh5
2. Sao chép và dán các dòng sau vào cuối tệp
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh3
3. Lưu tệp và đóng trình soạn thảo văn bản
Lưu ý. Có thể xóa đường dẫn conda đã thêm bằng cách xóa các dòng vừa thêm. Dòng lệnhNhập lệnh sau vào terminal để nối đường dẫn conda vào tệp
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda35
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh4
các cửa sổ
Thêm đường dẫn sau vào biến môi trường 'Đường dẫn' của bạn bằng cách hoàn thành GUI hoặc hướng dẫn dòng lệnh bên dưới
rm ~/miniconda.sh0GUI
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'
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh8
2. Nhấp đúp vào biến 'Đường dẫn' trong phần 'Người dùng' để chọn nó để 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 'Đường dẫn' hiện có. Đảm bảo rằng các dấu chấm phẩy [;] bao quanh mục nhập để phân biệt nó với các mục nhập lân cận
curl //repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh9
5. Nhấp vào các nút 'Được' cho đến khi tất cả các cửa sổ hộp thoại được đóng lại
Lưu ý. Có thể xóa đường dẫn conda đã thêm theo cùng một phương pháp chỉnh sửa. Dòng lệnhSử dụng lệnh
rm ~/miniconda.sh1 để nối thêm đường dẫn. Từ dấu nhắc lệnh nhập
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"0
Khởi tạo cửa hàng
Khởi tạo conda cho tương tác shell. Chạy lệnh tiếp tục để biết thông tin về khởi tạo cho các trình bao khác nhau. Thực hiện theo các hướng dẫn tiếp theo được in trên bảng điều khiển khi nhập lệnh
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"1
Sau khi khởi động lại giao diện dòng lệnh, bạn sẽ có thể kích hoạt môi trường conda cơ sở bằng lệnh sau
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"2
Cài đặt API
Earth Engine Python API được phân phối dưới dạng gói conda-forge tại. https. // anaconda. org/conda-forge/earthengine-api. Nó được cài đặt bằng lệnh
rm ~/miniconda.sh2. 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 của nó đảm bảo rằng nó và các gói phụ thuộc của nó sẽ không gây ra sự cố lập phiên bản với môi trường cơ sở của bạn 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ề quản lý môi trường lưu trữ, vui lòng truy cập trang web này Lưu ý. Bước đầu tiên sau đây giả định rằng bạn vừa hoàn thành phần này mà không thay đổi các biến môi trường hoặc khởi tạo conda để sử dụng trình bao; . Nếu trước đây bạn đã cài đặt conda bằng phương tiện khác hoặc đã đăng ký conda để sử dụng trong trình bao, vui lòng thực hiện những gì cần thiết để kích hoạt conda, sau đó bắt đầu làm theo hướng dẫn với bước 2
1. Kích hoạt môi trường conda cơ sở của bạn, nếu nó chưa được kích hoạt
Linux
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"
3Mac
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"
3các cửa sổ
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"
5
2. Tạo một môi trường ảo conda cho Earth Engine API
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"6
Bạn sẽ được yêu cầu xác nhận việc tạo môi trường, hãy làm như vậy
3. Kích hoạt môi trường conda ee
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"7
4. Cài đặt API vào môi trường conda ee. Đảm bảo rằng
rm ~/miniconda.sh3 xuất hiện ở đầu dòng lệnh, cho biết bạn đang làm việc từ môi trường ee
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"8
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 nó. Sau khi xác nhận, conda sẽ tải xuống và cài đặt các phụ thuộc. Nếu mọi việc suôn sẻ, bây giờ 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 API, cũng như công cụ dòng lệnh
rm ~/miniconda.sh4
Nhận thông tin đăng nhập
Trước khi sử dụng API Earth Engine hoặc công cụ dòng lệnh
rm ~/miniconda.sh4, bạn phải thực hiện xác thực một lần cho phép truy cập vào Earth Engine thay mặt cho tài khoản Google của bạn. Để xác thực, hãy sử dụng lệnh
rm ~/miniconda.sh6 từ công cụ dòng lệnh
rm ~/miniconda.sh4
Trong môi trường conda ee của bạn, hãy chạy lệnh sau và làm theo hướng dẫn được in kết quả. Một URL sẽ được cung cấp để tạo mã ủy quyền theo thỏa thuận. Sao chép mã ủy quyền và nhập nó làm đầu vào dòng lệnh
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"9
Khi nhập mã ủy quyền, mã thông báo ủy quyền sẽ được lưu vào tệp thông tin đăng nhập có thể tìm thấy bên dưới. Việc sử dụng tiếp theo lệnh
rm ~/miniconda.sh8 của API và công cụ dòng lệnh
rm ~/miniconda.sh4 sẽ xem xét tệp này để xác thực. Nếu bạn muốn thu hồi ủy quyền, chỉ cần xóa tệp thông tin xác thực
Linux
bash ~/miniconda.sh -b -p
0Mac
bash ~/miniconda.sh -b -p
0các cửa sổ
bash ~/miniconda.sh -b -p
2
Kiểm tra API
Chạy tập lệnh Python đơn giản in siêu dữ liệu cho bộ dữ liệu DEM để kiểm tra cài đặt API. Nó sẽ in một đối tượng JSON ra bàn điều khiển
1. Bắt đầu trình thông dịch
rm ~/miniconda.sh0 từ môi trường conda ee của bạn
bash ~/miniconda.sh -b -p3
2. Chạy từng dòng Python sau để in siêu dữ liệu cho tập dữ liệu DEM
bash ~/miniconda.sh -b -p4
Sử dụng API sau
Bất cứ lúc nào bạn muốn sử dụng API Earth Engine, trước tiên bạn phải kích hoạt môi trường conda ee của mình. 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. Thực hiện theo các hướng dẫn liên quan đến cài đặt conda của bạn bên dưới
Conda chưa được đăng ký
Lệnh kích hoạt môi trường conda ee sau đây giả sử rằng conda đã được cài đặt theo hướng dẫn trong phần trên i. e. đườ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
bash ~/miniconda.sh -b -p
5Mac
bash ~/miniconda.sh -b -p
5các cửa sổ
bash ~/miniconda.sh -b -p
7
Conda đã đăng ký
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 trình bao hoặc dấu nhắc lệnh bằng 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
powershell -command "Invoke-WebRequest -Uri //repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"7
Sau khi chạy lệnh, bạn sẽ thấy
rm ~/miniconda.sh3 ở đầu dòng lệnh, cho biết bạn đang làm việc từ môi trường ee
Bạn hiện đã sẵn sàng khởi động trình thông dịch Python và truy cập API Python của Earth Engine. 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 API Python
Cập nhật API
Sử dụng lệnh
rm ~/miniconda.sh2 để cập nhật môi trường ee của bạn lên phiên bản API mới nhất. Hãy nhớ kích hoạt môi trường conda ee của bạn trước, nếu nó chưa hoạt động
bash ~/miniconda.sh -b -p9
Nhận số phiên bản hiện được cài đặt bằng Python bằng cách in thuộc tính
rm ~/miniconda.sh3 thư viện
rm ~/miniconda.sh4. Bắt đầu trình thông dịch Python bằng cách nhập
rm ~/miniconda.sh0 vào dòng lệnh môi trường ee conda rồi nhập các lệnh sau
bash ~/miniconda.sh -b -p0
Chia sẻ môi trường của bạn
Có thể hữu ích khi chia sẻ môi trường Python hiện tại của bạn với những người khác để đạt được kết quả có thể tái tạo và nhân rộng, đặc biệt 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 để những người khác tái tạo môi trường của bạn
Từ môi trường conda ee của bạn, hãy chạy lệnh sau để lưu tệp YAML có tên 'ee-shared-env' vào thư mục Chính của bạn, nơi liệt kê các thông số kỹ thuật môi trường của bạn
Linux
bash ~/miniconda.sh -b -p
1Mac
bash ~/miniconda.sh -b -p
1các cửa sổ
bash ~/miniconda.sh -b -p
3
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
______0_______4 Lưu ý. Dòng đầu tiên của ee-shared-env. tệp yml xác định tên của môi trường sẽ được tạo. Conda sẽ không ghi đè lên môi trường hiện có, vì vậy tên của môi trường trong ee-shared-env. tập tin yml có thể cần phải được thay đổi. Ngoài ra, hãy sử dụng lệnhrm ~/miniconda.sh6 của conda hoặc cờ
rm ~/miniconda.sh7 của lệnh
rm ~/miniconda.sh8 của conda để quản lý tên môi trường. Lưu ý. Việc sao chép môi trường trên các hệ điều hành có thể không thành công, vì có các phiên bản và bản dựng gói dành riêng cho hệ điều hành có thể không khả dụng hoặc tạo xung đột phụ thuộc