Method: geoTiff.get

מחזירה תמונה לפי המזהה שלה.

בקשת HTTP

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

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

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

פרמטרים
id

string

חובה. המזהה של הנכס המבוקש.

גוף הבקשה

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

גוף התשובה

הודעה שמייצגת גוף HTTP שרירותי. יש להשתמש בו רק בפורמטים של מטען ייעודי (payload) שלא ניתן לייצג כ-JSON, כמו דף בינארי גולמי או דף HTML.

אפשר להשתמש בהודעה הזו גם בשיטות API של סטרימינג וגם בשיטות API שלא קשורות בסטרימינג במסגרת הבקשה, וגם בתגובה.

הוא יכול לשמש כשדה בקשה ברמה העליונה. זהו שדה נוח אם רוצים לחלץ פרמטרים מכתובת האתר או מתבנית HTTP לתוך שדות הבקשה וגם רוצים גישה לגוף ה-HTTP הגולמי.

דוגמה:

message GetResourceRequest {
  // A unique request id.
  string request_id = 1;

  // The raw HTTP body is bound to this field.
  google.api.HttpBody http_body = 2;

}

service ResourceService {
  rpc GetResource(GetResourceRequest)
    returns (google.api.HttpBody);
  rpc UpdateResource(google.api.HttpBody)
    returns (google.protobuf.Empty);

}

דוגמאות לשיטות סטרימינג:

service CaldavService {
  rpc GetCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);
  rpc UpdateCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);

}

שימוש מהסוג הזה משנה רק את אופן הטיפול בבקשות ובגוף התגובה, וכל שאר התכונות ימשיכו לפעול ללא שינוי.

אם הפעולה בוצעה בהצלחה, התגובה היא תגובת HTTP כללית שהפורמט שלה מוגדר על ידי השיטה.

ייצוג JSON 
{
  "contentType": string,
  "data": string,
  "extensions": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
שדות
contentType

string

ערך הכותרת HTTP Content-Type לציון סוג התוכן של הגוף.
data

string (bytes format)

גוף הבקשה/התגובה של HTTP כבינארי גולמי.

מחרוזת בקידוד base64.
extensions[]

object

מטא-נתונים של תגובות ספציפיות לאפליקציה. יש להגדיר זאת בתגובה הראשונה עבור ממשקי API לסטרימינג.

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI המזהה את הסוג. לדוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }.

היקפי הרשאות

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

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