Method: dataLayers.get

Bir konumun çevresindeki 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 enlem ve boylamı.
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 değerin 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ı, gerekli minimum 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.

İ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 TAM 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.