מפות חום

heatmapTiles נקודת הקצה מספקת מפות חום שקשורות לאבקנים דרך שכבת-על של משבצות. שכבה מעל קטעי המפה הוא אוסף של משבצות תמונות שאפשר להציג מעל מפות Google. כל אחד משבצת התמונה היא בגודל 256x256 פיקסלים.

שכבת-העל של המשבצות היא רשת שמורכבת מאוסף של משבצות, שכל אחת מהן מוקצית (X,Y). האריח עם הקואורדינטות (0,0) תמיד נמצא הפינה הצפון-מערבית של המפה. הערכים של X עולים ממערב למזרח, בזמן ערכי Y עולים מצפון לדרום.

הzoom level קובע את הגודל או הגודל של תוכן המפה שמופיעים במפה תצוגת מפה. גודל הרשת של המשבצות נקבע על ידי שינוי קנה המידה של X ושל Y את הקואורדינטות באופן אקספוננציאלי ברמת הזום.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

לדוגמה, ברמת זום של 2, מפת העולם מיוצגת באמצעות 4 x 4 בסך הכול, 16 אבנים.

בתמונה הבאה מוצגת מפת חום של TREE_UPI עם כל העולם, מחולקת לחלקים למשבצות שניתן לגשת אליהן בזום ברמת 2.

מפת חום של העולם כולו בצורת רשת של 4 על 4.

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

אפשר לבקש את המשבצות הנוכחיות של מפת החום של אבקנים באמצעות heatmapTiles בנקודת קצה (endpoint) על ידי שליחת בקשת HTTP GET אל:

https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

מידע על נקודת הקצה של מפת החום

כל הפרמטרים הבאים נדרשים לבקשה מוצלחת:

  • KEY: מפתח ה-API של האפליקציה שלכם. המפתח הזה משמש לזיהוי האפליקציה שלכם למטרות ניהול מכסות. בקישור הבא מוסבר איך לקבל מקש הקיצור.
  • TYPE: הסוג של מפת החום שצריך להחזיר. ראו מותר ערכים.
  • Z: רמת זום שקובעת את הגודל או הגודל של התוכן שמוצג במפה להופיע בתצוגת מפה. הערכים המותרים הם 0-16, כאשר מוצג הערך 0. את כל העולם באריח אחד.
  • X,Y: הקואורדינטות של האריח ביחס לפינה הצפון-מזרחית (0,0). X ערכים עולים ממערב למזרח וערכים של Y עולים מצפון ל דרומה. הקואורדינטות חייבות להיות חוקיות לרמת הזום שצוינה. לדוגמה, אם הגדרתם את רמת הזום ל-2 וביקשתם משבצת בקואורדינטות (10,10), שה-API יחזיר שגיאה.

דוגמה לבקשה למפת חום

התמונה שלמעלה מציגה מפת חום של TREE_UPI עם רמת זום של 2, וגם את הקואורדינטות של כל משבצת. הדוגמה הבאה משתמשת בפונקציה heatmapTiles נקודת קצה (2,1) שתבקש את המשבצת בקואורדינטות (2,1):

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

האריח מופיע כתמונה שניתנת כשכבת-על במפה:

דוגמה לאריח של מפת חום באמצעות המפה TREE_UPI.

למידע נוסף על שכבת-על של משבצות מעל מפת ברירת המחדל, ראה סוגים של מפת שכבת-על.