קבלת מפות מזג אוויר (ניסיוני)

נקודת הקצה mapTypes מספקת משבצות של מפות מבוססות-פיקסלים שמייצגות תופעות שונות של מזג אוויר, כמו תחזיות משקעים. אפשר להציג את קטעי המפה האלה כשכבת-על במפות Google הרגילות.

תנאים

התנאים האלה מפורסמים במסגרת סעיף 6 (תנאי השימוש במוצרים בגרסת טרום-GA) בתנאים הספציפיים לשירות של הפלטפורמה של מפות Google, כפי שהוסכם בינך לבין Google.

‫1.1 דרישות ייחוס. אם הלקוח משתמש בתוכן של מפות Google מ-Weather API, הוא צריך לספק ל-Google שיוך (Attribution) בהתאם למסמכי התיעוד.

‫1.2 הגבלות. הלקוחות לא יכולים להשתמש בתוכן של מפות Google שאוחזר מ-Weather API כדי ליצור מחדש שירות או מוצר של Google (למשל, להשתמש בנתונים שאוחזרו מ-Weather API באפליקציית מזג אוויר או במודל מזג אוויר שהמטרה העיקרית שלהם היא לספק מידע על מזג האוויר).

‫1.3 שמירה במטמון. הלקוחות יכולים לשמור באופן זמני במטמון את התוכן הרלוונטי של מפות Google מ-Weather API למשך תקופת השמירה במטמון הרלוונטית, כפי שמתואר בטבלה 1.3.1 (הרשאות לשמירה במטמון).

טבלה 1.3.1 (הרשאות לשמירה במטמון)

ההרשאות האלה הן בנוסף להרשאות שמתוארות בטבלה 17.2.1 בתנאים הספציפיים לשירות של Google Maps Platform.

תוכן במפות Google תקופת השמירה במטמון
משבצות של מפת מזג האוויר שעה אחת, שלאחריה הלקוח חייב למחוק את תוכן מפות Google שנשמר במטמון

מידע על בקשות למפת מזג האוויר

כדי לבקש מפות מזג אוויר, שולחים בקשת HTTP GET אל:

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

סוגי מפות

‫Weather API תומך בסוגים שונים של מפות מזג אוויר, שתואמים למודלים שונים של מזג אוויר ולאזורים גיאוגרפיים שונים:

  • ‫US_PRECIPITATION_CURRENT: תחזית לטווח קצר מאוד ברזולוציה גבוהה של משקעים בארצות הברית.
  • ‫EU_PRECIPITATION_CURRENT: תחזית לטווח קצר של משקעים באירופה ברזולוציה גבוהה.

במפת הכיסוי שלמטה מוצגים האזורים שבהם זמינות משבצות של מפת מזג האוויר:

גבולות הכיסוי של קטעי מפת מזג האוויר

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

ה-API משתמש במערכת הקואורדינטות הסטנדרטית של קטעי מפה ב-Web Mercator. הסבר מקיף על קואורדינטות של מפות וקואורדינטות של קטע במפה זמין במאמרים קטעי מפה של מפת דרכים וקואורדינטות של מפות וקטעי מפה.

במערכת הזו:

  • ‫zoom: רמת הזום (0 עד 16). רמת זום 0 מייצגת את כל העולם במשבצת אחת (20 x‏ 20 = משבצת אחת). רמת הזום z מחלקת את העולם לרשת של 2z x 2z משבצות.
  • ‫x: קואורדינטת ה-X (עמודה) של המשבצת, בטווח שבין 0 (הכי מערבית) ל-‎2zoom - 1 (הכי מזרחית).
  • ‫y: קואורדינטת ה-Y (שורה) של המשבצת, בטווח שבין 0 (הכי צפונית) ל-‎2zoom - 1 (הכי דרומית).

הצגת מפת מזג האוויר

כדי להציג את המשבצות האלה באפליקציית אינטרנט באמצעות Google Maps JavaScript API, אפשר ליצור google.maps.ImageMapType בהתאמה אישית:

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

דוגמה לבקשה של מפת מזג אוויר

הדוגמה הבאה מבקשת משבצות של מפת מזג אוויר של משקעים בארה"ב עבור ניו אורלינס:

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

התשובה היא בינארית. ה-wrapper של ה-JSON מופיע רק בהגדרות סריאליזציה ספציפיות, כמו ?alt=json.