Method: dataLayers.get

Bir konumu çevreleyen bölge için güneş enerjisi bilgilerini alır. Konum kapsama alanının dışındaysa NOT_FOUND koduyla ilgili 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 merkezi için enlem ve boylam.
radiusMeters

number

Zorunlu. Verilerin döndürülmesi gereken merkez noktasını ç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 metrenin üzerindeki değerler belirtilebilir.
  • Bununla birlikte, 175 metrenin üzerindeki 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ülmesi istenen veri alt kümesi.
requiredQuality

enum (ImageryQuality)

İsteğe bağlı. Sonuçlarda izin verilen minimum kalite seviyesi. Bundan daha düşük kalitede bir sonuç döndürülmez. Bunu belirtmemek, 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 ayarlanmamışsa varsayılan değerdir) 0,25, 0,5 ve 1,0 değerleri desteklenir. Normal çözünürlüğü pixelSizeMeters'den düşük olan görüntü bileşenleri, pixelSizeMeters tarafından belirtilen çözünürlükte döndürülür; normal çözünürlüğü pixelSizeMeters değerine eşit veya bundan daha yüksek olan görüntü bileşenleri bu normal çözünürlükte döndürülür.
exactQualityRequired

boolean

İsteğe bağlı. Görüntülerin tam kalitesine ihtiyaç duyulup duyulmayacağı. Yanlış değerine ayarlanırsa requiredQuality alanı, gerekli minimum kalite olarak yorumlanır. Böylece, requiredQuality ORTA olarak ayarlandığında YÜKSEK kaliteli görüntüler döndürülebilir. Doğru değerine ayarlanırsa requiredQuality, tam olarak gerekli kalite olarak yorumlanır ve requiredQuality, MEDIUM olarak ayarlanırsa yalnızca MEDIUM kalitesindeki görüntüler döndürülür.

İ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ş bilgisi alt kümesi.

Sıralamalar
DATA_LAYER_VIEW_UNSPECIFIED FULL değerine eşdeğer.
DSM_LAYER Yalnızca DSM'yi alın.
IMAGERY_LAYERS DSM, RGB ve maskeyi edinin.
IMAGERY_AND_ANNUAL_FLUX_LAYERS DSM, RGB, maske ve yıllık akıyı edinin.
IMAGERY_AND_ALL_FLUX_LAYERS DSM, RGB, maske, yıllık akı ve aylık akıyı edinin.
FULL_LAYERS Tüm verileri alın.