מפות חום

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

בתמונה הבאה מוצגת מפת חום של TREE_UPI עם כל העולם, מחולקת למשבצות שאפשר לגשת אליהן ברמת זום של 2.

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

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

אפשר לבקש את המשבצות הנוכחיות של מפת החום של אבקנים באמצעות נקודת הקצה heatmapTiles על ידי שליחת בקשת HTTP GET אל:

https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

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

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

  • KEY: מפתח ה-API של האפליקציה שלכם. המפתח הזה מזהה את האפליקציה למטרות ניהול מכסות. איך מקבלים מפתח
  • TYPE: הסוג של מפת החום שצריך להחזיר. לערכים המותרים
  • Z: רמת המרחק מהתצוגה שקובעת כמה גדול או קטן התוכן של המפה יופיע בתצוגת המפה. הערכים המותרים הם 0-16, כאשר ערך של 0 מציג את כל העולם במשבצת אחת.
  • X,Y: הקואורדינטות של האריח ביחס לפינה הצפון-מזרחית (0,0). הערכים של X עולים ממערב למזרח והערכים של Y עולים מצפון לדרום. הקואורדינטות חייבות להיות חוקיות לרמת הזום שצוינה. לדוגמה, אם מגדירים את רמת הזום ל-2 ומבקשים משבצת בקואורדינטות (10,10), ה-API יחזיר שגיאה.

דוגמה לבקשת מפת חום

התמונה שלמעלה מציגה מפת חום של TREE_UPI עם זום ברמה 2, יחד עם הקואורדינטות של כל אריח. בדוגמה הבאה משתמשים בנקודת הקצה heatmapTiles כדי לבקש את המשבצת בקואורדינטות (2,1):

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

האריח מופיע כתמונה שניתנת כשכבת-על במפה:

דוגמה לאריח של מפת חום באמצעות המפה TREE_UPI.

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