מפות חום

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

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

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

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

פרטים נוספים זמינים במאמר קואורדינטות של מפה ושל משבצת.

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

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

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.

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