מפות חום

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

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