Method: dataLayers.get

Bir konumun çevresindeki bölge için 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, bu merkez noktasını çevreleyen bölgeyi tanımlayan yarıçap (metre cinsinden). Bu değerle ilgili sınırlamalar şunlardır:

  • 100 m'ye kadar olan tüm değerler her zaman belirtilebilir.
  • radiusMeters <= pixelSizeMeters * 1000 olduğu sürece 100 metrenin üzerindeki değerler belirtilebilir.
  • Ancak 175 m'den büyük 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 seviyesi. Bundan daha düşük kaliteli sonuçlar döndürülmez. Bu seçeneğin belirtilmemesi, yalnızca YÜKSEK kaliteyle sınırlamaya eşdeğerdir.
pixelSizeMeters

number

İsteğe bağlı. Döndürülecek verilerin metre/piksel cinsinden minimum ölçeği. 0,1 (bu alan açıkça ayarlanmamışsa varsayılan değer), 0,25, 0,5 ve 1,0 değerleri desteklenir. Normal çözünürlüğü pixelSizeMeters değerinden 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 bu değerden yüksek olan görüntü bileşenleri ise 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 gerekip gerekmediği. Yanlış olarak ayarlanırsa requiredQuality alanı, gerekli minimum kalite olarak yorumlanır. Bu nedenle, requiredQuality alanı ORTA olarak 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 GKST öncesi denemeleri belirtir. Bu alanın kullanıldığı istekler, Google Haritalar Platformu Hizmete Özgü Şartları uyarınca GKST öncesi teklif olarak sınıflandırılır. Daha fazla bilgi için [lansman aşaması açıklamaları]( https://cloud.google.com/maps-platform/terms/launch-stages) bölümüne bakın.

İstek metni

İ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

Güneşle ilgili hangi bilgilerin döndürüleceği.

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