מפות חום

נקודת הקצה 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.

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

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

אפשר לבקש משבצות של מפת חום עדכנית של אבקנים באמצעות נקודת הקצה 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

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

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

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