מפות צפיפות

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

מידע על אריחים של מפות חום

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

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

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

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

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

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

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