מפות צפיפות

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

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