heatmapTiles נקודת הקצה מספקת מפות חום שקשורות לאבקנים דרך שכבת-על של משבצות. שכבה מעל קטעי המפה הוא אוסף של משבצות תמונות שאפשר להציג מעל מפות Google. כל אחד משבצת התמונה היא בגודל 256x256 פיקסלים.
שכבת-העל של המשבצות היא רשת שמורכבת מאוסף של משבצות, שכל אחת מהן מוקצית
(X
,Y
). האריח עם הקואורדינטות (0,0) תמיד נמצא
הפינה הצפון-מערבית של המפה. הערכים של X
עולים ממערב למזרח, בזמן
ערכי Y
עולים מצפון לדרום.
הzoom level
קובע את הגודל או הגודל של תוכן המפה שמופיעים במפה
תצוגת מפה. גודל הרשת של המשבצות נקבע על ידי שינוי קנה המידה של X
ושל Y
את הקואורדינטות באופן אקספוננציאלי ברמת הזום.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
לדוגמה, ברמת זום של 2, מפת העולם מיוצגת באמצעות 4 x 4 בסך הכול, 16 אבנים.
בתמונה הבאה מוצגת מפת חום של TREE_UPI
עם כל העולם, מחולקת לחלקים
למשבצות שניתן לגשת אליהן בזום ברמת 2.
הצגת מפה ומשבצת קואורדינטות בשביל פרטים נוספים.
אפשר לבקש את המשבצות הנוכחיות של מפת החום של אבקנים באמצעות heatmapTiles בנקודת קצה (endpoint) על ידי שליחת בקשת 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) שתבקש את המשבצת בקואורדינטות (2,1):
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
האריח מופיע כתמונה שניתנת כשכבת-על במפה:
למידע נוסף על שכבת-על של משבצות מעל מפת ברירת המחדל, ראה סוגים של מפת שכבת-על.