מפות חום

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

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