Method: mapTypes.heatmapTiles.lookupHeatmapTile

מחזירה מערך בייטים שמכיל את הנתונים של תמונת ה-PNG של המשבצת.

בקשת HTTP

GET https://pollen.googleapis.com/v1/mapTypes/{mapType}/heatmapTiles/{zoom}/{x}/{y}

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

פרמטרים של נתיב

פרמטרים
mapType

enum (MapType)

חובה. הסוג של מפת החום של האבקנים. מגדיר את השילוב של סוג האבקנים והאינדקס שהמפה תייצג באופן גרפי.
zoom

integer

חובה. רמת הזום של המפה. מגדירה את הגודל או הקטן של התוכן שמוצג במפה בתצוגת מפה.

  • רמת זום 0 מציגה את העולם כולו במשבצת אחת.
  • רמת זום 1 מציגה את העולם כולו ב-4 משבצות.
  • רמת זום 2 מציגה את העולם כולו ב-16 משבצות.
  • רמת זום 16 כוללת את כל העולם ב-65,536 משבצות.

ערכים מותרים: 0-16
x

integer

חובה. מגדירה את הנקודה המזרחית-מערבית באריח המבוקש.
y

integer

חובה. מגדירה את הנקודה צפונית-דרום באריח המבוקש.

גוף הבקשה

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

גוף התשובה

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

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

אפשר להשתמש בשדה הזה כשדה בקשה ברמה העליונה. הוא נוח אם רוצים לחלץ פרמטרים מכתובת ה-URL או מתבנית ה-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 כללית שהפורמט שלה מוגדר על ידי ה-method.

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

string

ערך הכותרת Content-Type ב-HTTP שמציין את סוג התוכן של הגוף.
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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

MapType

הסוג של מפת החום של האבקנים. מגדיר את השילוב של סוג האבקנים והאינדקס שהמפה תייצג באופן גרפי.

טיפוסים בני מנייה (enum)
MAP_TYPE_UNSPECIFIED לא צוין סוג מפה.
TREE_UPI הסוג של מפת החום ייצג מפה גרפית של אינדקס עץ.
GRASS_UPI הסוג של מפת החום ייצג מפה גרפית של מדד דשא.
WEED_UPI הסוג של מפת החום ייצג מפה גרפית של אינדקס עשבים.