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)

اختياريّ. تحدّد هذه السمة التجارب التي يجب تفعيلها في مرحلة ما قبل التوفّر للجمهور العام. يتم تصنيف الطلبات التي تستخدم هذا الحقل كعرض لمرحلة ما قبل التوفّر للجمهور العام بموجب بنود الخدمة المحدّدة في "منصة خرائط Google". يُرجى الاطّلاع على [أوصاف مراحل الإطلاق]( https://cloud.google.com/maps-platform/terms/launch-stages) لمزيد من التفاصيل.

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

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

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

DataLayerView

تحدّد هذه السمة المجموعة الفرعية من المعلومات الشمسية التي سيتم عرضها.

عمليات التعداد
DATA_LAYER_VIEW_UNSPECIFIED تعادل FULL.
DSM_LAYER الحصول على DSM فقط
IMAGERY_LAYERS احصل على نموذج DSM والنموذج اللوني أحمر أخضر أزرق والقناع.
IMAGERY_AND_ANNUAL_FLUX_LAYERS احصل على نموذج سطح رقمي (DSM) وأحمر وأخضر وأزرق (RGB) وقناع وتدفّق سنوي.
IMAGERY_AND_ALL_FLUX_LAYERS يمكنك الحصول على نموذج الارتفاع الرقمي (DSM) ونموذج أحمر أخضر أزرق (RGB) والقناع والتدفق السنوي والتدفق الشهري.
FULL_LAYERS الحصول على جميع البيانات