נקודת הקצה 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.
לפרטים נוספים, ראו קואורדינטות של מפה ומשבצות.
ניתן לך לבקש משבצות מפת חום של אבקנים באמצעות נקודת הקצה 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
המשבצת מופיעה כתמונה שניתן להציג אותה בשכבת-על במפה:
למידע נוסף על שכבת-על של משבצות מעל מפת ברירת המחדל, ראו סוגים של מפות שכבת-על.