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.

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

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

ייצוג 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

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

MapType

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

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