נקודת הקצה heatmapTiles מספקת מפות חום שקשורות לאבקנים דרך שכבת-על של משבצות. שכבת-על של משבצת היא אוסף של קטעי תמונות שאפשר להציג מעל מפות Google. כל משבצת תמונה היא בגודל 256 x 256 פיקסלים.
שכבת-העל של המשבצת היא רשת שמורכבת מאוסף של משבצות, שכל אחת מהן מוקצית (X
,Y
). האריח עם הקואורדינטות (0,0) נמצא תמיד בפינה הצפונית-מערבית של המפה. ערכי X
עולים ממערב למזרח, והערכים של Y
עולים מצפון לדרום.
השדה zoom level
קובע את הגודל או הגודל של התוכן שמוצג במפה בתצוגת המפה. גודל הרשת של המשבצות נקבע על ידי התאמת הקואורדינטות X
ו-Y
באופן אקספוננציאלי לפי רמת הזום.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
לדוגמה, ברמת זום של 2, מפת העולם מיוצגת באמצעות מטריצה של 4 x 4, כך שהמספר הכולל של 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
האריח מופיע כתמונה שניתנת כשכבת-על במפה:
למידע נוסף על שכבות-על של משבצות מעל מפת ברירת המחדל, ראו סוגים של מפת שכבת-על.