מפות חום

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

מידע על משבצות של מפת חום

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

לדוגמה, בזום של 2, מפת העולם מיוצגת באמצעות מטריצה של 4 x 4 x סה"כ 16 אריחים. המרחק מהתצוגה קובע גם מהו הערך המקסימלי המותר לקואורדינטות.

בתמונה הבאה מוצגת מפת חום של US_AQI עם רמת זום של 2, לצד הקואורדינטות של כל אריח:

מפת חום של העולם בצורת רשת של 4 על 4.

לפרטים נוספים, ראו קואורדינטות של מפות ואריחים.

מידע על נקודת הקצה של מפת החום

אריח מפת חום מיוצג על ידי מערך בייטים שמכיל את נתוני המשבצות כתמונה מסוג PNG. מבקשים את משבצות מפת החום הנוכחיות של איכות האוויר באמצעות נקודת הקצה heatmapTiles. לשם כך שולחים בקשת HTTP GET אל:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

כל הפרמטרים של הבקשה נדרשים בבקשה:

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

  • Z – רמת הזום שקובעת עד כמה התוכן של המפה יופיע בתצוגת המפה. הערכים המותרים הם 0-16, כאשר ערך של 0 מציג את העולם כולו במשבצת אחת.

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

    קואורדינטות של משבצות חייבות להיות חוקיות עבור רמת המרחק מהתצוגה שצוינה. לדוגמה, במקרה שמגדירים את רמת הזום ל-2 ומבקשים משבצת בקואורדינטות של 10,10, ה-API יחזיר שגיאה.

  • YOUR_API_KEY - מפתח ה-API של האפליקציה שלך. המפתח הזה מזהה את האפליקציה שלכם לצורך ניהול המכסות. תוכלו לקרוא מידע נוסף במאמר קבלת מפתח.

דוגמה לבקשה למפת חום

בתמונה שלמעלה מוצגת מפת חום של US_AQI עם רמת זום של 2, יחד עם הקואורדינטות של כל אריח. בדוגמה הבאה נשתמש בנקודת הקצה heatmapTiles כדי לבקש את המשבצת בקואורדינטות 0:1 ממפת החום:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

המשבצת תופיע כך:

אריח מפת חום בקואורדינטות 0,1.

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