מפות חום

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

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

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