נקודת הקצה currentConditions מספקת מידע על תנאי מזג האוויר הנוכחיים במיקום ספציפי. ה-API מחזיר את הנתונים הבאים:
- תיאור של תנאי מזג האוויר הנוכחיים עם סמל מתאים
- הטמפרטורה הנוכחית
- הטמפרטורה המורגשת
- נקודת הטל
- מדד החום
- צינת רוח
- לחות יחסית
- מדד קרינת UV
- הסבירות, האחוז וסוג המשקעים
- סבירות לסופות רעמים
- לחץ בגובה פני הים
- כיוון הרוח, המהירות והמשבים
- חשיפה וכיסוי עננים
- נתונים היסטוריים מ-24 השעות האחרונות, כולל שינויים בטמפרטורה, טמפרטורות מקסימליות ומינימליות וכמויות משקעים
APIs Explorer מאפשר לכם לשלוח בקשות בזמן אמת כדי להכיר את ה-API ואת האפשרויות שלו:
מידע על בקשות לגבי התנאים הנוכחיים
כדי לבקש את התנאים הנוכחיים, שולחים בקשת HTTP GET אל:
https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE
כוללים בבקשה את קואורדינטות קו האורך וקו הרוחב של המיקום בפרמטרים של כתובת ה-URL.
דוגמאות לבקשות של תנאים נוכחיים
בדוגמה הבאה מוצגת בקשה למידע על התנאים הנוכחיים במאונטן וויו, קליפורניה:
curl -X GET "https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=37.4220& location.longitude=-122.0841"
התשובה היא בפורמט:
{ "currentTime": "2025-01-28T22:04:12.025273178Z", "timeZone": { "id": "America/Los_Angeles" }, "isDaytime": true, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/sunny", "description": { "text": "Sunny", "languageCode": "en" }, "type": "CLEAR" }, "temperature": { "degrees": 13.7, "unit": "CELSIUS" }, "feelsLikeTemperature": { "degrees": 13.1, "unit": "CELSIUS" }, "dewPoint": { "degrees": 1.1, "unit": "CELSIUS" }, "heatIndex": { "degrees": 13.7, "unit": "CELSIUS" }, "windChill": { "degrees": 13.1, "unit": "CELSIUS" }, "relativeHumidity": 42, "uvIndex": 1, "precipitation": { "probability": { "percent": 0, "type": "RAIN" }, "qpf": { "quantity": 0, "unit": "MILLIMETERS" } }, "thunderstormProbability": 0, "airPressure": { "meanSeaLevelMillibars": 1019.16 }, "wind": { "direction": { "degrees": 335, "cardinal": "NORTH_NORTHWEST" }, "speed": { "value": 8, "unit": "KILOMETERS_PER_HOUR" }, "gust": { "value": 18, "unit": "KILOMETERS_PER_HOUR" } }, "visibility": { "distance": 16, "unit": "KILOMETERS" }, "cloudCover": 0, "currentConditionsHistory": { "temperatureChange": { "degrees": -0.6, "unit": "CELSIUS" }, "maxTemperature": { "degrees": 14.3, "unit": "CELSIUS" }, "minTemperature": { "degrees": 3.7, "unit": "CELSIUS" }, "qpf": { "quantity": 0, "unit": "MILLIMETERS" } } }
ציון מערכת יחידות
כברירת מחדל, הנתונים שמוחזרים מ-Weather API הם בשיטה המטרית. כדי לבקש נתוני מזג אוויר באמצעות המערכת האימפריאלית, מציינים את הפרמטר unitsSystem בבקשה.
בדוגמה הבאה מוצגת בקשה לנתוני מזג אוויר של מאונטן וויו, קליפורניה, ביחידות מידה אימפריאליות:
curl -X GET "https://weather.googleapis.com/v1/currentConditions:lookup?key=YOUR_API_KEY&location.latitude=37.4220& location.longitude=-122.0841&unitsSystem=IMPERIAL"
התשובה היא בפורמט:
{ "currentTime": "2025-01-28T22:13:56.723468335Z", "timeZone": { "id": "America/Los_Angeles" }, "isDaytime": true, "weatherCondition": { "iconBaseUri": "https://maps.gstatic.com/weather/v1/sunny", "description": { "text": "Sunny", "languageCode": "en" }, "type": "CLEAR" }, "temperature": { "degrees": 56.6, "unit": "FAHRENHEIT" }, "feelsLikeTemperature": { "degrees": 55.7, "unit": "FAHRENHEIT" }, "dewPoint": { "degrees": 33.9, "unit": "FAHRENHEIT" }, "heatIndex": { "degrees": 56.6, "unit": "FAHRENHEIT" }, "windChill": { "degrees": 55.7, "unit": "FAHRENHEIT" }, "relativeHumidity": 42, "uvIndex": 1, "precipitation": { "probability": { "percent": 0, "type": "RAIN" }, "qpf": { "quantity": 0, "unit": "INCHES" } }, "thunderstormProbability": 0, "airPressure": { "meanSeaLevelMillibars": 1019.12 }, "wind": { "direction": { "degrees": 335, "cardinal": "NORTH_NORTHWEST" }, "speed": { "value": 5, "unit": "MILES_PER_HOUR" }, "gust": { "value": 11, "unit": "MILES_PER_HOUR" } }, "visibility": { "distance": 10, "unit": "MILES" }, "cloudCover": 0, "currentConditionsHistory": { "temperatureChange": { "degrees": -1.2, "unit": "FAHRENHEIT" }, "maxTemperature": { "degrees": 57.8, "unit": "FAHRENHEIT" }, "minTemperature": { "degrees": 38.6, "unit": "FAHRENHEIT" }, "qpf": { "quantity": 0, "unit": "INCHES" } } }
רוצה לנסות?
הכלי APIs Explorer מאפשר לכם לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות שלו.
בצד שמאל של הדף, לוחצים על סמל ה-API api.
אפשר לערוך את פרמטרים של הבקשה.
לוחצים על הכפתור Execute (הפעלה). בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.
בחלונית APIs Explorer, לוחצים על סמל המסך המלא מסך מלא כדי להרחיב את החלון של APIs Explorer.