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

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

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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 الحصول على جميع البيانات