מפות צפיפות

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

לדוגמה, ברמת זום 2, מפת העולם מיוצגת באמצעות מטריקס 4 על 4, עם 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.

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