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