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

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

תנאים

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

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

‫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 שנשמר במטמון

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

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

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

סוגי מפות

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

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

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

כיסוי של אריחי מפת מזג האוויר

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

ה-API משתמש במערכת הקואורדינטות הסטנדרטית של משבצות Web Mercator. הסבר מקיף על קואורדינטות של מפות וקואורדינטות של קטע במפה זמין במאמרים Roadmap tiles ו-Map and Tile Coordinates.

במערכת הזו:

  • ‫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"

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