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 |
الحصول على كل البيانات |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves solar information for a specified region using latitude, longitude, and radius.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of data retrieval with parameters like \u003ccode\u003eview\u003c/code\u003e, \u003ccode\u003erequiredQuality\u003c/code\u003e, \u003ccode\u003epixelSizeMeters\u003c/code\u003e, and \u003ccode\u003eexactQualityRequired\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns an error if the location is outside the coverage area or if radius exceeds limitations.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a \u003ccode\u003eDataLayers\u003c/code\u003e object containing the requested solar data subset if successful.\u003c/p\u003e\n"]]],["This content details how to retrieve solar information for a specific region via a `GET` request to `https://solar.googleapis.com/v1/dataLayers:get`. The request requires parameters like `location` (latitude/longitude), `radiusMeters`, and optional parameters including `view`, `requiredQuality`, `pixelSizeMeters` and `exactQualityRequired`. The body is empty and a successful response will provide solar data via `DataLayers`. Specific authorization scope `https://www.googleapis.com/auth/cloud-platform` is required. `DataLayerView` allows one to define the solar information subset to be retrieved.\n"],null,["# Method: dataLayers.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [DataLayerView](#DataLayerView)\n- [Try it!](#try-it)\n\nGets solar information for a region surrounding a location. Returns an error with code `NOT_FOUND` if the location is outside the coverage area.\n\n### HTTP request\n\n`GET https://solar.googleapis.com/v1/dataLayers:get`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location` | `object (`[LatLng](/maps/documentation/solar/reference/rest/v1/LatLng)`)` Required. The longitude and latitude for the center of the region to get data for. |\n| `radiusMeters` | `number` Required. The radius, in meters, defining the region surrounding that centre point for which data should be returned. The limitations on this value are: - Any value up to 100m can always be specified. - Values over 100m can be specified, as long as `radiusMeters` \\\u003c= `pixelSizeMeters * 1000`. - However, for values over 175m, the `DataLayerView` in the request must not include monthly flux or hourly shade. |\n| `view` | `enum (`[DataLayerView](/maps/documentation/solar/reference/rest/v1/dataLayers/get#DataLayerView)`)` Optional. The desired subset of the data to return. |\n| `requiredQuality` | `enum (`[ImageryQuality](/maps/documentation/solar/reference/rest/v1/dataLayers#ImageryQuality)`)` Optional. The minimum quality level allowed in the results. No result with lower quality than this will be returned. Not specifying this is equivalent to restricting to HIGH quality only. |\n| `pixelSizeMeters` | `number` Optional. The minimum scale, in meters per pixel, of the data to return. Values of 0.1 (the default, if this field is not set explicitly), 0.25, 0.5, and 1.0 are supported. Imagery components whose normal resolution is less than `pixelSizeMeters` will be returned at the resolution specified by `pixelSizeMeters`; imagery components whose normal resolution is equal to or greater than `pixelSizeMeters` will be returned at that normal resolution. |\n| `exactQualityRequired` | `boolean` Optional. Whether to require exact quality of the imagery. If set to false, the `requiredQuality` field is interpreted as the minimum required quality, such that HIGH quality imagery may be returned when `requiredQuality` is set to MEDIUM. If set to true, `requiredQuality` is interpreted as the exact required quality and only `MEDIUM` quality imagery is returned if `requiredQuality` is set to `MEDIUM`. |\n| `experiments[]` | `enum (`[Experiment](/maps/documentation/solar/reference/rest/v1/Experiment)`)` Optional. Specifies the pre-GA experiments to enable. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [DataLayers](/maps/documentation/solar/reference/rest/v1/dataLayers#DataLayers).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nDataLayerView\n-------------\n\nWhat subset of the solar information to return.\n\n| Enums ||\n|----------------------------------|--------------------------------------------------------|\n| `DATA_LAYER_VIEW_UNSPECIFIED` | Equivalent to FULL. |\n| `DSM_LAYER` | Get the DSM only. |\n| `IMAGERY_LAYERS` | Get the DSM, RGB, and mask. |\n| `IMAGERY_AND_ANNUAL_FLUX_LAYERS` | Get the DSM, RGB, mask, and annual flux. |\n| `IMAGERY_AND_ALL_FLUX_LAYERS` | Get the DSM, RGB, mask, annual flux, and monthly flux. |\n| `FULL_LAYERS` | Get all data. |"]]
