Nhập hình ảnh.
Yêu cầu HTTP
POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:import
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số | |
|---|---|
project |
Mã dự án hoặc số dự án của dự án Google Cloud Platform sẽ được coi là người dùng dịch vụ cho yêu cầu này. Định dạng là Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{
"imageManifest": {
object ( |
| Trường | |
|---|---|
imageManifest |
Tệp kê khai hình ảnh. |
description |
Tên công việc mà con người đọc được. |
overwrite |
Cho phép ghi đè thành phần hiện có hay không. |
requestId |
Một chuỗi duy nhất dùng để phát hiện các yêu cầu trùng lặp. Nếu cùng một người dùng thực hiện nhiều yêu cầu với cùng một |
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Operation.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/cloud-platform
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
ImageManifest
Mô tả cách dịch vụ EarthEngine tạo hình ảnh từ một tập hợp tệp.
| Biểu diễn dưới dạng JSON |
|---|
{ "name": string, "properties": { object }, "uriPrefix": string, "tilesets": [ { object ( |
| Trường | |
|---|---|
name |
Tên của thành phần sẽ được tạo. |
properties |
Các thuộc tính bổ sung của thành phần. Không dùng tên thuộc tính "system:time_start" và "system:time_end" nữa. Thay vào đó, hãy sử dụng các trường |
uriPrefix |
Tiền tố không bắt buộc được thêm vào tất cả |
tilesets[] |
Các tập hợp thẻ thông tin. Mỗi tập hợp thẻ thông tin phải có một mã nhận dạng duy nhất. |
bands[] |
Các dải tần. Thứ tự băng tần của thành phần giống với thứ tự của |
maskBands[] |
Các dải mặt nạ. |
footprint |
Dấu chân trong toạ độ pixel (không phải trong toạ độ lat/lng). Nếu để trống, theo mặc định, kích thước sẽ là toàn bộ hình ảnh. Hãy xem |
missingData |
Các giá trị thể hiện không có dữ liệu trong tất cả các dải của hình ảnh. Áp dụng cho tất cả các băng không chỉ định |
pyramidingPolicy |
Chính sách về mô hình kim tự tháp. Nếu không chỉ định, chính sách MEAN sẽ được áp dụng theo mặc định. Áp dụng cho tất cả các băng không chỉ định |
startTime |
Dấu thời gian liên kết với thành phần (nếu có), ví dụ: thời gian chụp ảnh vệ tinh. Đối với những thành phần tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm bắt đầu khoảng thời gian đó. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
endTime |
Đối với những thành phần tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm kết thúc khoảng thời gian đó (không bao gồm). Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
skipMetadataRead |
Liệu có bỏ qua việc đọc siêu dữ liệu từ các tệp bằng GDAL hay không. Khi trường này có giá trị true, các tập thẻ thông tin phải chứa siêu dữ liệu GDAL đầy đủ: loại dữ liệu, crs, phép biến đổi, kích thước tệp và không có giá trị dữ liệu. |
memo |
Trường dạng tự do để lưu trữ ghi chú của người dùng. Không được dùng trong quá trình truyền dẫn. |
TilesetBand
Biểu thị một dải tần số lấy từ một tập thẻ thông tin.
| Biểu diễn dưới dạng JSON |
|---|
{ "id": string, "tilesetId": string, "tilesetBandIndex": integer, "missingData": { object ( |
| Trường | |
|---|---|
id |
Mã của dải tần. |
tilesetId |
Mã của tập hợp thẻ thông tin tương ứng với dải. |
tilesetBandIndex |
Chỉ mục băng dựa trên 0 từ tập hợp thẻ thông tin tương ứng với băng. Ví dụ: nếu là 1, thì các pixel của dải là các pixel của dải tại chỉ mục 1 của tập thẻ thông tin (trong |
missingData |
Các giá trị thể hiện không có dữ liệu trong dải tần. Nếu bạn đặt |
pyramidingPolicy |
Chính sách về mô hình kim tự tháp. |
TilesetMaskBand
Biểu thị một dải mặt nạ lấy từ một tập hợp thẻ thông tin.
| Biểu diễn dưới dạng JSON |
|---|
{ "tilesetId": string, "bandIds": [ string ] } |
| Trường | |
|---|---|
tilesetId |
Mã của nhóm Thẻ thông tin tương ứng với dải mặt nạ. Dải cuối cùng của Bộ thẻ thông tin luôn được dùng làm dải mặt nạ. |
bandIds[] |
Mã của các dải tần áp dụng cho dải tần mặt nạ. Nếu để trống, dải mặt nạ sẽ được áp dụng cho tất cả các dải trong thành phần. Mỗi dải chỉ có thể có một dải mặt nạ tương ứng. Nếu bất kỳ băng tần nào trong số này có mặt nạ nội bộ, thì mặt nạ nội bộ sẽ bị bỏ qua để ưu tiên băng tần mặt nạ này. |
PixelFootprint
Dấu vết của tất cả các pixel hợp lệ trong một hình ảnh.
| Biểu diễn dưới dạng JSON |
|---|
{
"points": [
{
object ( |
| Trường | |
|---|---|
points[] |
Một vòng tròn tạo thành phần bên ngoài của một đa giác đơn giản phải chứa tâm của tất cả các pixel hợp lệ của hình ảnh. Đây phải là một vòng tròn tuyến tính: điểm cuối phải bằng điểm đầu. Toạ độ nằm trong phép chiếu của dải do Lưu ý: Sử dụng toạ độ không phải số nguyên, chẳng hạn như tâm của mỗi pixel, vì kích thước sẽ được tính bao gồm một pixel nếu và chỉ khi pixel đó (hình chữ nhật 1x1) giao nhau với kích thước. Để tránh vô tình chọn các pixel lân cận, đừng sử dụng toạ độ có giá trị số nguyên vì đó là ranh giới giữa các pixel. Việc vẽ dấu chân dọc theo tâm điểm ảnh sẽ ngăn việc đưa vào các điểm ảnh không mong muốn. Điều này có thể gây ra lỗi khi các điểm ảnh dự kiến nằm cạnh ranh giới bản đồ, chẳng hạn như kinh tuyến đối diện hoặc một cực. Ví dụ: đối với hình ảnh 2x2 có cả 4 pixel hợp lệ, sau đây là một vòng tròn có thể có: [{"x": 0,5, "y": 0,5}, {"x": 0,5, "y": 1,5}, {"x": 1,5, "y": 1,5}, {"x": 1,5, "y": 0,5}, {"x": 0,5, "y": 0,5}] |
bandId |
Mã của băng có CRS xác định toạ độ của dấu vết. Nếu để trống, dải tần số đầu tiên sẽ được sử dụng. |
GridPoint
Một điểm hoặc vectơ hai chiều.
| Biểu diễn dưới dạng JSON |
|---|
{ "x": number, "y": number } |
| Trường | |
|---|---|
x |
Giá trị toạ độ x. |
y |
Giá trị toạ độ y. |