Method: dataLayers.get
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mendapatkan informasi surya untuk wilayah di sekitar lokasi. Menampilkan error dengan kode NOT_FOUND jika lokasi berada di luar area cakupan.
Permintaan HTTP
GET https://solar.googleapis.com/v1/dataLayers:get
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
| Parameter |
location |
object (LatLng)
Wajib. Bujur dan lintang untuk bagian tengah wilayah yang akan mendapatkan data.
|
radiusMeters |
number
Wajib. Radius, dalam meter, yang menentukan wilayah di sekitar titik tengah yang datanya akan ditampilkan. Batasan pada nilai ini adalah:
- Nilai apa pun hingga 100 m selalu dapat ditentukan.
- Nilai di atas 100 m dapat ditentukan, selama
radiusMeters <= pixelSizeMeters * 1000.
- Namun, untuk nilai di atas 175 m,
DataLayerView dalam permintaan tidak boleh menyertakan fluks bulanan atau bayangan per jam.
|
view |
enum (DataLayerView)
Opsional. Subset data yang diinginkan untuk ditampilkan.
|
requiredQuality |
enum (ImageryQuality)
Opsional. Tingkat kualitas minimum yang diizinkan dalam hasil. Tidak ada hasil dengan kualitas yang lebih rendah dari ini yang akan ditampilkan. Jika tidak ditentukan, hal ini sama dengan membatasi kualitas ke TINGGI saja.
|
pixelSizeMeters |
number
Opsional. Skala minimum, dalam meter per piksel, dari data yang akan ditampilkan. Nilai 0,1 (default, jika kolom ini tidak ditetapkan secara eksplisit), 0,25, 0,5, dan 1,0 didukung. Komponen gambar yang resolusi normalnya kurang dari pixelSizeMeters akan ditampilkan pada resolusi yang ditentukan oleh pixelSizeMeters; komponen gambar yang resolusi normalnya sama dengan atau lebih besar dari pixelSizeMeters akan ditampilkan pada resolusi normal tersebut.
|
exactQualityRequired |
boolean
Opsional. Apakah akan mewajibkan kualitas gambar yang tepat. Jika ditetapkan ke salah (false), kolom requiredQuality akan ditafsirkan sebagai kualitas minimum yang diperlukan, sehingga gambar berkualitas TINGGI dapat ditampilkan saat requiredQuality ditetapkan ke SEDANG. Jika ditetapkan ke benar (true), requiredQuality akan ditafsirkan sebagai kualitas yang diperlukan secara persis dan hanya gambar berkualitas MEDIUM yang ditampilkan jika requiredQuality ditetapkan ke MEDIUM.
|
experiments[] |
enum (Experiment)
Opsional. Menentukan eksperimen pra-GA yang akan diaktifkan.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat instance DataLayers.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud-platform
DataLayerView
Subset informasi surya yang akan ditampilkan.
| Enum |
DATA_LAYER_VIEW_UNSPECIFIED |
Setara dengan FULL. |
DSM_LAYER |
Mendapatkan DSM saja. |
IMAGERY_LAYERS |
Mendapatkan DSM, RGB, dan mask. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Mendapatkan DSM, RGB, mask, dan fluks tahunan. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Mendapatkan DSM, RGB, mask, fluks tahunan, dan fluks bulanan. |
FULL_LAYERS |
Mendapatkan semua data. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
