נקודת הקצה heatmapTiles מספקת מפות חום שקשורות לאבקנים באמצעות שכבת-על של משבצות. שכבת-על של משבצות היא אוסף של משבצות תמונה שאפשר להציג מעל מפות Google. כל משבצת תמונה היא בגודל 256 x 256 פיקסלים.
שכבת העל של קטעי המפה היא רשת שמורכבת מאוסף של קטעי מפה, שלכל אחד מהם מוקצות קואורדינטות (X,Y). האריח עם הקואורדינטות (0,0) נמצא תמיד בפינה הצפון-מערבית של המפה. הערכים של X עולים ממערב למזרח, והערכים של Y עולים מצפון לדרום.
ההגדרה zoom level קובעת את הגודל שבו התוכן של המפה יופיע בתצוגת המפה. גודל רשת המשבצות נקבע על ידי שינוי קנה המידה של הקואורדינטות X ו-Y באופן אקספוננציאלי לפי רמת הזום.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
לדוגמה, ברמת זום של 2, מפת העולם מיוצגת באמצעות מטריצה בגודל 4x4, כלומר 16 משבצות.
בתמונה הבאה מוצג TREE_UPI מפת חום של העולם כולו, שמחולקת למשבצות שאפשר לגשת אליהן ברמת זום 2.
פרטים נוספים זמינים במאמר בנושא קואורדינטות של מפה ומשבצת.
אפשר לבקש משבצות של מפת חום עדכנית של אבקנים באמצעות נקודת הקצה heatmapTiles על ידי שליחת בקשת 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):
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
המשבצת מופיעה כתמונה שאפשר להוסיף למפה:
מידע נוסף על שכבות של קטעי מפה מעל מפת ברירת המחדל זמין במאמר בנושא שכבות של סוגי מפות.