Method: dataLayers.get

الحصول على معلومات عن الأشعة الشمسية لمنطقة تحيط بموقع جغرافي تعرِض رسالة خطأ بالرمز NOT_FOUND إذا كان الموقع الجغرافي خارج منطقة التغطية.

طلب HTTP

GET https://solar.googleapis.com/v1/dataLayers:get

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

مَعلمات طلب البحث

المعلمات
location

object (LatLng)

مطلوب. خطا الطول والعرض لمركز المنطقة التي تريد الحصول على بيانات عنها
radiusMeters

number

مطلوب. نصف القطر، بالكيلومترات، الذي يحدّد المنطقة المحيطة بنقطة المركز التي يجب عرض البيانات لها. في ما يلي القيود المفروضة على هذه القيمة:

  • يمكن تحديد أي قيمة تصل إلى 100 متر في أي وقت.
  • يمكن تحديد قيم تزيد عن 100 متر، شرط أن تكون radiusMeters <= pixelSizeMeters * 1000.
  • ومع ذلك، بالنسبة إلى القيم التي تزيد عن 175 مترًا، يجب ألا يتضمّن DataLayerView في الطلب تدفقًا شهريًا أو تظليلًا كل ساعة.
view

enum (DataLayerView)

اختياريّ. المجموعة الفرعية المطلوبة من البيانات المطلوب عرضها.
requiredQuality

enum (ImageryQuality)

اختياريّ. الحد الأدنى لمستوى الجودة المسموح به في النتائج ولن يتم عرض أي نتيجة بجودة أقل من هذه القيمة. ويؤدي عدم تحديد هذا الخيار إلى حصر المحتوى بالجودة العالية فقط.
pixelSizeMeters

number

اختياريّ. الحد الأدنى للمقياس، بالمتر لكل بكسل، للبيانات المطلوب عرضها. يمكن استخدام القيم 0.1 (القيمة التلقائية في حال عدم ضبط هذا الحقل بشكل صريح) و0.25 و0.5 و1.0. سيتم عرض مكوّنات الصور التي تكون دقتها العادية أقل من pixelSizeMeters بالدقة المحدّدة في pixelSizeMeters، وسيتم عرض مكوّنات الصور التي تكون دقتها العادية مساوية أو أكبر من pixelSizeMeters بالدقة العادية.
exactQualityRequired

boolean

اختياريّ. ما إذا كنت تريد أن تكون جودة الصور دقيقة في حال ضبط القيمة على false، يتم تفسير الحقل requiredQuality على أنّه الحد الأدنى للجودة المطلوبة، ما يتيح عرض صور ذات جودة عالية عند ضبط requiredQuality على MEDIUM. في حال ضبطها على "صحيح"، يتم تفسير requiredQuality على أنّها الجودة المطلوبة بالضبط، ولا يتم عرض صور بجودة أقل من MEDIUM إلا إذا تم ضبط requiredQuality على MEDIUM.
experiments[]

enum (Experiment)

اختياريّ. تُستخدَم لتحديد تجارب مرحلة ما قبل الإطلاق التي يجب تفعيلها.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

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

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

يجب توفير نطاق OAuth التالي:

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

DataLayerView

المجموعة الفرعية من معلومات الطاقة الشمسية المطلوب عرضها

عمليات التعداد
DATA_LAYER_VIEW_UNSPECIFIED يعادل FULL.
DSM_LAYER الحصول على DSM فقط
IMAGERY_LAYERS الحصول على DSM وRGB والقناع
IMAGERY_AND_ANNUAL_FLUX_LAYERS يمكنك الحصول على بيانات DSM وRGB والقناع والمعدل السنوي للتغير.
IMAGERY_AND_ALL_FLUX_LAYERS يمكنك الحصول على مقياس DSM وRGB والقناع والمعدل السنوي للتغيرات والمعدل الشهري للتغيرات.
FULL_LAYERS الحصول على كل البيانات