מפות חום

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

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

לדוגמה, ברמת זום 2, מפת העולם מיוצגת באמצעות מטריצה של 4 על 4, בסך הכול 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.

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