Method: dataLayers.get
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir konumu çevreleyen bölgenin güneş enerjisi bilgilerini alır. Konum kapsama alanı dışındaysa NOT_FOUND koduyla bir hata döndürür.
HTTP isteği
GET https://solar.googleapis.com/v1/dataLayers:get
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler |
location |
object (LatLng)
Zorunlu. Veri alınacak bölgenin merkezinin boylamı ve enlemi.
|
radiusMeters |
number
Zorunlu. Verilerin döndürülmesi gereken merkez noktayı çevreleyen bölgeyi tanımlayan, metre cinsinden yarıçap. Bu değerle ilgili sınırlamalar şunlardır:
- 100 metreye kadar herhangi bir değer her zaman belirtilebilir.
radiusMeters <= pixelSizeMeters * 1000 olduğu sürece 100 m'den uzun değerler belirtilebilir.- Ancak 175 m'den uzun değerler için istekteki
DataLayerView, aylık akış veya saatlik gölge içermemelidir.
|
view |
enum (DataLayerView)
İsteğe bağlı. Döndürülecek verilerin istenen alt kümesi.
|
requiredQuality |
enum (ImageryQuality)
İsteğe bağlı. Sonuçlarda izin verilen minimum kalite düzeyi. Bundan daha düşük kaliteli sonuç döndürülmez. Bu parametrenin belirtilmemesi, yalnızca YÜKSEK kaliteyle kısıtlamaya eşdeğerdir.
|
pixelSizeMeters |
number
İsteğe bağlı. Döndürülecek verilerin piksel başına metre cinsinden minimum ölçeği. 0,1 (bu alan açıkça ayarlanmazsa varsayılan değer), 0,25, 0,5 ve 1,0 değerleri desteklenir. Normal çözünürlüğü pixelSizeMeters'ten az olan görüntü bileşenleri, pixelSizeMeters tarafından belirtilen çözünürlükte döndürülür. Normal çözünürlüğü pixelSizeMeters'e eşit veya pixelSizeMeters'ten büyük olan görüntü bileşenleri, normal çözünürlükte döndürülür.
|
exactQualityRequired |
boolean
İsteğe bağlı. Görüntülerin tam kalitede olmasının zorunlu olup olmadığı. Yanlış olarak ayarlanırsa requiredQuality alanı, minimum gerekli kalite olarak yorumlanır. Bu durumda, requiredQuality ORTAYA ayarlandığında YÜKSEK kaliteli görüntüler döndürülebilir. Doğru olarak ayarlanırsa requiredQuality tam olarak gerekli kalite olarak yorumlanır ve requiredQuality MEDIUM olarak ayarlanırsa yalnızca MEDIUM kalitesinde görüntüler döndürülür.
|
experiments[] |
enum (Experiment)
İsteğe bağlı. Etkinleştirilecek GA öncesi denemeleri belirtir.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, DataLayers öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
DataLayerView
Döndürülecek güneş bilgilerinin alt kümesi.
| Sıralamalar |
DATA_LAYER_VIEW_UNSPECIFIED |
FULL değerine eşdeğerdir. |
DSM_LAYER |
Yalnızca DSM'yi alın. |
IMAGERY_LAYERS |
DSM, RGB ve maskeyi alın. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
DSM, RGB, maske ve yıllık akış elde edin. |
IMAGERY_AND_ALL_FLUX_LAYERS |
DSM, RGB, maske, yıllık akış ve aylık akış bilgilerini alın. |
FULL_LAYERS |
Tüm verileri alın. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[[["\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. |"]]
