מפות חום

נקודת הקצה 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.

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