Method: dataLayers.get

מקבלת מידע סולארי עבור אזור סביב מיקום מסוים. מחזירה שגיאה עם קוד NOT_FOUND אם המיקום נמצא מחוץ לאזור הכיסוי.

בקשת HTTP

GET https://solar.googleapis.com/v1/dataLayers:get

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של שאילתה

פרמטרים
location

object (LatLng)

חובה. קווי האורך והרוחב של מרכז האזור שעבורם רוצים לקבל נתונים.
radiusMeters

number

חובה. הרדיוס במטרים, שמגדיר את האזור המקיף את נקודת המרכז שעבורה יש להחזיר את הנתונים. המגבלות על הערך הזה הן:

  • תמיד אפשר לציין כל ערך עד 100m.
  • אפשר לציין ערכים גדולים מ-100m, כל עוד radiusMeters <= pixelSizeMeters * 1000.
  • עם זאת, בערכים מעל 175 מ', DataLayerView בבקשה לא יכול לכלול שטף חודשי או הצללה לפי שעה.
view

enum (DataLayerView)

זה שינוי אופציונלי. קבוצת המשנה שרוצים להחזיר מתוך הנתונים.
requiredQuality

enum (ImageryQuality)

זה שינוי אופציונלי. רמת האיכות המינימלית המותרת בתוצאות. לא תוחזר תוצאה באיכות נמוכה מזו. אם לא מציינים זאת, הגדרה זו זהה להגבלה של 'איכות גבוהה' בלבד.
pixelSizeMeters

number

זה שינוי אופציונלי. קנה המידה המינימלי של הנתונים שיש להחזיר, במטרים לפיקסל. המערכת תומכת בערכים של 0.1 (ברירת המחדל, אם השדה לא מוגדר במפורש), 0.25, 0.5 ו-1.0. רכיבי תמונות שהרזולוציה הרגילה שלהם נמוכה מ- pixelSizeMeters יוחזרו ברזולוציה שצוינה על ידי pixelSizeMeters; רכיבי תמונות שהרזולוציה הרגילה שלהם שווה ל-pixelSizeMeters או גבוהה ממנה יוחזרו ברזולוציה הרגילה הזו.
exactQualityRequired

boolean

זה שינוי אופציונלי. האם לדרוש איכות מדויקת של התמונות. אם המדיניות מוגדרת כ-False, השדה requiredQuality יפורש כאיכות המינימלית הנדרשת. למשל, ייתכן שיוחזרו תמונות באיכות גבוהה אם הערך של requiredQuality מוגדר ל-MEDIUM. אם המדיניות מוגדרת כ-True, המערכת תפרש את requiredQuality כאיכות המדויקת הנדרשת, ויוחזרו רק תמונות באיכות MEDIUM אם הערך של requiredQuality מוגדר ל-MEDIUM.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של DataLayers.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

DataLayerView

איזו קבוצת משנה של המידע הסולארי להחזיר.

טיפוסים בני מנייה (enums)
DATA_LAYER_VIEW_UNSPECIFIED שוות ערך ל-Full.
DSM_LAYER קבלו את ה-DSM בלבד.
IMAGERY_LAYERS מורידים את ה-DSM, RGB והמסכה.
IMAGERY_AND_ANNUAL_FLUX_LAYERS קבל את ה-DSM , RGB, המסכה והשטף השנתי.
IMAGERY_AND_ALL_FLUX_LAYERS קבל את ה-DSM , RGB, התממה, שטף שנתי ושטף חודשי.
FULL_LAYERS הצגת כל הנתונים.