Method: projects.image.import

استيراد صورة

طلب HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:import

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
project

string

معرّف المشروع أو رقم المشروع على Google Cloud Platform الذي يجب التعامل معه كمستهلك الخدمة لهذا الطلب. التنسيق هو projects/{project-id}.

يتطلب التفويض إذن IAM التالي على المورد المحدّد project:

  • earthengine.imports.create

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
الحقول
imageManifest

object (ImageManifest)

ملف بيان الصورة
description

string

اسم المهمة الذي يمكن لشخص عادي قراءته
overwrite

boolean

ما إذا كان سيتم السماح باستبدال مادة عرض حالية.
requestId

string

سلسلة فريدة تُستخدَم لرصد الطلبات المكرّرة إذا قدّم المستخدم نفسه أكثر من طلب واحد باستخدام requestId غير فارغ نفسه، قد يبدأ أحد هذه الطلبات فقط عملية طويلة الأمد بنجاح. يمكن أن يحتوي requestId على الأحرف a..z أو A..Z أو 0-9 أو "-". يمكن أن يتألّف requestId من 60 حرفًا كحدّ أقصى.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

ImageManifest

يصف هذا القسم كيفية إنشاء خدمة EarthEngine لصورة من مجموعة من الملفات.

تمثيل JSON 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "memo": string
}
الحقول
name

string

اسم مادة العرض التي سيتم إنشاؤها. يكون name بالتنسيق "projects/*/assets/**" (مثل "projects/earthengine-legacy/assets/users//"). تندرج جميع مواد العرض التي يملكها المستخدمون ضمن المشروع "earthengine-legacy" (مثل "projects/earthengine-legacy/assets/users/foo/bar"). تندرج جميع مواد العرض الأخرى ضمن المشروع "earthengine-public" (مثل "projects/earthengine-public/assets/LANDSAT").
properties

object (Struct format)

خصائص إضافية لمادة العرض تم إيقاف اسمَي السمتَين "system:time_start" و "system:time_end" نهائيًا. استخدِم الحقلين startTime وendTime بدلاً من ذلك.
uriPrefix

string

البادئة الاختيارية التي يتمّ وضعها قبل جميع uri التي تمّ تحديدها في هذا البيان
tilesets[]

object (Tileset)

مجموعات الأشكال يجب أن يكون لكلّ مجموعة رسومات تخطيطية رقم تعريف فريد.
bands[]

object (TilesetBand)

النطاقات ترتيب النطاقات في مادة العرض هو نفسه ترتيب bands.
maskBands[]

object (TilesetMaskBand)

أشرطة القناع
footprint

object (PixelFootprint)

مساحة العرض بالإحداثيات بالبكسل (وليس بالإحداثيات الجغرافية). إذا كانت هذه السمة فارغة، تكون مساحة العرض التلقائية هي الصورة بأكملها. يُرجى الاطّلاع على PixelGrid للحصول على وصف أكثر تفصيلاً لتنسيقات إحداثيات البكسل.
missingData

object (MissingData)

القيم التي لا تمثّل أي بيانات في جميع نطاقات الصورة ينطبق ذلك على جميع النطاقات التي لا تحدّد missingData الخاصة بها.
pyramidingPolicy

enum (PyramidingPolicy)

سياسة الهرم في حال عدم تحديدها، يتم تطبيق السياسة MEAN تلقائيًا. ينطبق ذلك على جميع النطاقات التي لا تحدّد pyramidingPolicy الخاصة بها.
startTime

string (Timestamp format)

الطابع الزمني المرتبط بمادة العرض، إن توفّر، مثل الوقت الذي تم فيه التقاط صورة من الأقمار الصناعية بالنسبة إلى مواد العرض التي تتوافق مع فاصل زمني، مثل متوسط القيم على مدار شهر أو عام، يتوافق الطابع الزمني مع بداية هذا الفاصل.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

بالنسبة إلى مواد العرض التي تتوافق مع فاصل زمني، مثل متوسط القيم على مدار شهر أو سنة، يتوافق الطابع الزمني مع نهاية هذا الفاصل (حصري).

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
skipMetadataRead

boolean

يحدد هذا الخيار ما إذا كان سيتم تخطّي قراءة البيانات الوصفية من الملفات باستخدام GDAL. عندما يكون هذا الحقل صحيحًا، يجب أن تحتوي مجموعات الأشكال على البيانات الوصفية الكاملة لـ GDAL: نوع البيانات ونظام CRS والتحويل وأبعاد الملف، وألا تحتوي على أي قيمة بيانات.
memo

string

حقل بتنسيق حر لتخزين ملاحظات المستخدم لا يتم استخدامها في نقل البيانات.

TilesetBand

يمثّل نطاقًا واحدًا مصدره من مجموعة رسومات.

تمثيل JSON 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
الحقول
id

string

رقم تعريف المجموعة
tilesetId

string

رقم تعريف مجموعة الأشكال المركّبة المقابلة للشريحة
tilesetBandIndex

integer

فهرس النطاق المستند إلى الصفر من مجموعة الأشكال المركّبة المقابلة للنطاق على سبيل المثال، إذا كان 1، تكون وحدات البكسل في النطاق هي وحدات البكسل في النطاق في الفهرس 1 من مجموعة البلاطات (في ImageManifest.tilesets) التي تحمل المعرّف tilesetId.
missingData

object (MissingData)

القيم التي لا تمثّل أي بيانات في النطاق إذا تم ضبط MissingData بدون values، سيتم تجاهل أي قيمة nodata متوفّرة للملفات المقابلة لهذا TilesetBand.
pyramidingPolicy

enum (PyramidingPolicy)

سياسة الهرم

TilesetMaskBand

يمثّل شريط قناع واحدًا مصدره مجموعة رسومات.

تمثيل JSON 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
الحقول
tilesetId

string

رقم تعريف مجموعة الوحدات المربّعة المقابلة لفرقة القناع يتم دائمًا استخدام الشريط الأخير من مجموعة الأشكال كشريط قناع.
bandIds[]

string

أرقام تعريف النطاقات التي ينطبق عليها نطاق القناع إذا كانت فارغة، يتم تطبيق شريط القناع على جميع الأشرطة في مادة العرض. يمكن أن تتضمّن كل مجموعة ترددات مجموعة قناع واحدة فقط. إذا كان أيّ من هذه النطاقات يحتوي على قناع داخلي، يتم تجاهل القناع الداخلي لصالح نطاق القناع هذا.

PixelFootprint

مساحة جميع وحدات البكسل الصالحة في صورة.

تمثيل JSON 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
الحقول
points[]

object (GridPoint)

حلقة تشكل الجزء الخارجي من مضلع بسيط يجب أن يحتوي على مراكز جميع وحدات البكسل الصالحة للصورة يجب أن تكون هذه حلقة خطية: يجب أن تكون النقطة الأخيرة مساوية للنقطة الأولى. الإحداثيات في إسقاط النطاق المحدّد بواسطة bandId.

ملاحظة: استخدِم إحداثيات غير صحيحة، مثل مركز كل بكسل، لأنّه يتم تضمين بكسل في مساحة العرض إذا كان البكسل (مستطيل أبعاده 1×1) يتقاطع مع مساحة العرض. لتجنُّب اختيار وحدات البكسل المجاورة عن طريق الخطأ، لا تستخدِم إحداثيات ذات قيم صحيحة، لأنّها الحدود بين وحدات البكسل. يمنع رسم مساحة العرض على طول مراكز البكسل تضمين وحدات بكسل غير مقصودة، ما قد يؤدي إلى حدوث أخطاء عندما تكون وحدات البكسل المقصودة متاخمة لحدود الخريطة، مثل خط الطول المقابل أو أحد القطبين.

على سبيل المثال، بالنسبة إلى صورة 2×2 تحتوي على جميع البكسلات الأربعة الصالحة، في ما يلي حلقة واحدة محتملة: [{"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

string

رقم تعريف النطاق الذي يحدِّد نظام مرجعي جغرافي إحداثيات مساحة التغطية. إذا كان الحقل فارغًا، يتم استخدام النطاق الأول.

GridPoint

نقطة أو متجه ثنائي الأبعاد

تمثيل JSON 
{
  "x": number,
  "y": number
}
الحقول
x

number

قيمة الإحداثي x
y

number

قيمة الإحداثي y