使用 Azure 地圖服務氣象服務來要求即時和預報的氣象資料

發行項
08/09/2024

Azure 地圖服務氣象服務是一組 RESTful API，可讓開發人員將高度動態的歷程記錄、即時和預報的氣象資料和視覺效果整合至其解決方案中。

本文示範如何要求即時和預報的氣象資料：

使用取得目前狀況 API 來要求即時 (目前) 氣象資料。
使用取得嚴重氣象警示 API 來要求嚴重氣象警示。
使用取得每日預報 API 來要求每日預報。
使用取得每小時預報 API 來要求每小時預報。
使用取得每分鐘預報 API 來要求每分鐘的預報。

此影片提供對 Azure 地圖服務氣象服務進行 REST 呼叫的範例。

必要條件

重要

在本文中的 URL 範例中，您必須將 {Your-Azure-Maps-Subscription-key} 取代為您的 Azure 地圖服務訂用帳戶金鑰。

本教學課程使用 bruno 應用程式，但您可以選擇不同的 API 開發環境。

要求即時氣象資料

取得目前狀況 API 會傳回指定座標位置的詳細氣象狀況，例如，降雨、溫度和風力。此外，也可以擷取特定位置過去 6 或 24 小時的觀察資料。回應包含的詳細資料，例如觀測日期和時間、氣象狀況的描述、氣象圖示、降雨機率指示器旗標，以及溫度。也會傳回 RealFeel™ 溫度和紫外線 (UV) 指數。

在此範例中，您將使用取得目前狀況 API 來擷取座標位於 Seattle, WA 的目前氣象狀況。

開啟 bruno 應用程式，選取 [ 新增要求 ] 以建立要求。在 [新增要求] 視窗中，將 [類型] 設定為 [HTTP]。輸入要求的 [ 名稱 ]。

在 [URL] 下拉式清單中選取 [GET HTTP 方法]，然後輸入下列 URL：

https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.0&query=47.60357,-122.32945&subscription-key={Your-Azure-Maps-Subscription-key}

選取藍色 的 [建立] 按鈕。

選取 [執行] 按鈕。

顯示 [要求即時天氣數據 URL] 的螢幕快照，其中顯示布魯諾應用程式中醒目提示的執行按鈕。

回應本文包含目前的氣象資訊。

{
  "results": [
    {
      "dateTime": "2024-08-08T09:22:00-07:00",
      "phrase": "Sunny",
      "iconCode": 1,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 19.5,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 23.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 19.4,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 81,
      "dewPoint": {
        "value": 16.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 0,
          "localizedDescription": "N"
        },
        "speed": {
          "value": 2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 3.8,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 4,
      "uvIndexPhrase": "Moderate",
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 5,
      "ceiling": {
        "value": 12192,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1015.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "past24HourTemperatureDeparture": {
        "value": 3,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 20,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 19.4,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 17.5,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "past3Hours": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "past6Hours": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "past9Hours": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "past12Hours": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "past18Hours": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "past24Hours": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "past6Hours": {
          "minimum": {
            "value": 16,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 19.5,
            "unit": "C",
            "unitType": 17
          }
        },
        "past12Hours": {
          "minimum": {
            "value": 16,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 20.4,
            "unit": "C",
            "unitType": 17
          }
        },
        "past24Hours": {
          "minimum": {
            "value": 16,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 26.4,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

要求嚴重氣象警示

Azure 地圖服務取得嚴重氣象警示 API 會傳回從官方政府氣象機構和領先全球的區域性氣象警示提供者提供的嚴重氣象警示。服務會傳回警示類型、類別、層級等詳細資料。此服務也會傳回有關要求位置作用中嚴重警示的詳細描述，例如颶風、雷暴、閃電、熱浪或森林火災。例如，物流經理可以在地圖上將嚴重氣象狀況，連同商務位置和規劃路線視覺化，並與司機和當地工作人員進一步協調。

在此範例中，您要使用取得嚴重氣象警示 API 來擷取座標位於 Cheyenne, WY 的目前氣象狀況。

注意

本範例在撰寫本文時擷取嚴重的氣象警示。在要求的位置上，可能不再有任何嚴重的氣象警示。若要在執行此範例時擷取實際的嚴重警示資料，您必須在不同的座標位置擷取資料。

在布魯諾應用程式中，選取 [ 新增要求 ] 以建立要求。在 [新增要求] 視窗中，將 [類型] 設定為 [HTTP]。輸入要求的 [ 名稱 ]。

在 [URL] 下拉式清單中選取 [GET HTTP 方法]，然後輸入下列 URL：

https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.0&query=41.161079,-104.805450&subscription-key={Your-Azure-Maps-Subscription-key}

選取藍色 的 [建立] 按鈕。

選取 [執行] 按鈕。

顯示 [要求嚴重天氣警示 URL] 的螢幕快照，其中顯示布魯諾應用程式中醒目提示的執行按鈕。

如果沒有嚴重的氣象警示，回應本文將包含空白的 results[] 陣列。如果有嚴重的氣象警示，回應本文會包含類似下列 JSON 回應的內容：

{
"results": [
    {
        "countryCode": "US",
        "alertId": 2194734,
        "description": {
            "localized": "Red Flag Warning",
            "english": "Red Flag Warning"
        },
        "category": "FIRE",
        "priority": 54,
        "source": "U.S. National Weather Service",
        "sourceId": 2,
        "alertAreas": [
            {
                "name": "Platte/Goshen/Central and Eastern Laramie",
                "summary": "Red Flag Warning in effect until 7:00 PM MDT. Source: U.S. National Weather Service",
                "startTime": "2020-10-05T15:00:00+00:00",
                "endTime": "2020-10-06T01:00:00+00:00",
                "latestStatus": {
                    "localized": "Continue",
                    "english": "Continue"
                },
                "alertDetails": "...RED FLAG WARNING REMAINS IN EFFECT FROM 9 AM THIS MORNING TO\n7 PM MDT THIS EVENING FOR STRONG GUSTY WINDS AND LOW HUMIDITY...\n\n* WHERE...Fire weather zones 303, 304, 305, 306, 307, 308, 309,\n  and 310 in southeast Wyoming. Fire weather zone 313 in Nebraska.\n\n* WIND...West to northwest 15 to 30 MPH with gusts around 40 MPH.\n\n* HUMIDITY...10 to 15 percent.\n\n* IMPACTS...Any fires that develop will likely spread rapidly.\n  Outdoor burning is not recommended.\n\nPRECAUTIONARY/PREPAREDNESS ACTIONS...\n\nA Red Flag Warning means that critical fire weather conditions\nare either occurring now...or will shortly. A combination of\nstrong winds...low relative humidity...and warm temperatures can\ncontribute to extreme fire behavior.\n\n&&",
                "alertDetailsLanguageCode": "en"
            }
        ]
        },...
    ]
}

要求每日氣象預報資料

取得每日預報 API 會傳回詳細的每天氣象預報，例如溫度和風力。要求可以指定要對指定座標位置傳回的天數：1、5、10、15、25 或 45 天。回應包括溫度、風力、降雨、空氣品質和 UV 指數等詳細資料。在此範例中，我們會藉由設定 duration=5 來要求五天。

重要

在 S0 定價層中，您可以要求未來 1、5、10 和 15 天的每日預報。在 Gen1 (S1) 或 Gen2 定價層中，您可以要求未來 25 天和 45 天的每日預報。

Azure 地圖服務 Gen1 定價層淘汰

Gen1 定價層現已遭取代，且將於 2026/9/15 淘汰。 Gen2 定價層會取代 Gen1 (S0 和 S1) 定價層。如果 Azure 地圖服務帳戶已選取 Gen1 定價層，您可以在淘汰之前切換至 Gen2 定價，否則將會自動更新。如需詳細資訊，請參閱管理 Azure 地圖服務帳戶的定價層。

在此範例中，您要使用取得每日預報 API 來擷取座標位於 Seattle, WA 的五天氣象預報。

在布魯諾應用程式中，選取 [ 新增要求 ] 以建立要求。在 [新增要求] 視窗中，將 [類型] 設定為 [HTTP]。輸入要求的 [ 名稱 ]。

在 [URL] 下拉式清單中選取 [GET HTTP 方法]，然後輸入下列 URL：

https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.0&query=47.60357,-122.32945&duration=5&subscription-key={Your-Azure-Maps-Subscription-key}

選取藍色 的 [建立] 按鈕。

選取 [執行] 按鈕。

顯示 [要求每日氣象預報數據 URL] 的螢幕快照，其中以布魯諾應用程式中醒目提示的執行按鈕。

回應本文包含五天的氣象預報資料。為了簡潔起見，下方 JSON 回應會顯示第一天的預報。

{
  "summary": {
    "startDate": "2024-08-09T08:00:00-07:00",
    "endDate": "2024-08-09T20:00:00-07:00",
    "severity": 7,
    "phrase": "Very warm tomorrow",
    "category": "heat"
  },
  "forecasts": [
    {
      "date": "2024-08-08T07:00:00-07:00",
      "temperature": {
        "minimum": {
          "value": 16.2,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 28.9,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 16.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 29.8,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperatureShade": {
        "minimum": {
          "value": 16.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 27.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "hoursOfSun": 12.9,
      "degreeDaySummary": {
        "heating": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 5,
          "unit": "C",
          "unitType": 17
        }
      },
      "airAndPollen": [
        {
          "name": "AirQuality",
          "value": 56,
          "category": "Moderate",
          "categoryValue": 2,
          "type": "Nitrogen Dioxide"
        },
        {
          "name": "Grass",
          "value": 2,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Mold",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Ragweed",
          "value": 5,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Tree",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "UVIndex",
          "value": 7,
          "category": "High",
          "categoryValue": 3
        }
      ],
      "day": {
        "iconCode": 2,
        "iconPhrase": "Mostly sunny",
        "hasPrecipitation": false,
        "shortPhrase": "Mostly sunny",
        "longPhrase": "Mostly sunny; wildfire smoke will cause the sky to be hazy",
        "precipitationProbability": 0,
        "thunderstormProbability": 0,
        "rainProbability": 0,
        "snowProbability": 0,
        "iceProbability": 0,
        "wind": {
          "direction": {
            "degrees": 357,
            "localizedDescription": "N"
          },
          "speed": {
            "value": 11.1,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 354,
            "localizedDescription": "N"
          },
          "speed": {
            "value": 29.6,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "totalLiquid": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "rain": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "snow": {
          "value": 0,
          "unit": "cm",
          "unitType": 4
        },
        "ice": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "hoursOfPrecipitation": 0,
        "hoursOfRain": 0,
        "hoursOfSnow": 0,
        "hoursOfIce": 0,
        "cloudCover": 10
      },
      "night": {
        "iconCode": 35,
        "iconPhrase": "Partly cloudy",
        "hasPrecipitation": false,
        "shortPhrase": "Partly cloudy",
        "longPhrase": "Partly cloudy; wildfire smoke will cause the sky to be hazy",
        "precipitationProbability": 1,
        "thunderstormProbability": 0,
        "rainProbability": 1,
        "snowProbability": 0,
        "iceProbability": 0,
        "wind": {
          "direction": {
            "degrees": 7,
            "localizedDescription": "N"
          },
          "speed": {
            "value": 9.3,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 3,
            "localizedDescription": "N"
          },
          "speed": {
            "value": 20.4,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "totalLiquid": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "rain": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "snow": {
          "value": 0,
          "unit": "cm",
          "unitType": 4
        },
        "ice": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "hoursOfPrecipitation": 0,
        "hoursOfRain": 0,
        "hoursOfSnow": 0,
        "hoursOfIce": 0,
        "cloudCover": 26
      },
      "sources": [
        "AccuWeather"
      ]
    }
  ]
}

要求每小時氣象預報資料

取得每小時預報 API 會傳回指定座標位置未來 1 小時、12小時、24 小時 (1 天)、72 小時 (3 天)、120 小時 (5 天)，以及 240 小時 (10 天) 的詳細氣象預報。 API 會傳回詳細資料，例如溫度、濕度、風力、降雨和 UV 指數。

重要

在 Gen1 (S0) 定價層中，您可以要求未來 1、12、24 小時 (1 天)，以及 72 小時 (3 天) 的每小時預報。在 Gen1 (S1) 或 Gen2 定價層中，您可以要求未來 120 小時 (5 天) 和 240 小時 (10 天) 的每小時預報。

在此範例中，您要使用取得每小時預報 API，以擷取未來 12 小時座標位於 Seattle, WA 的每小時氣象預報。

在布魯諾應用程式中，選取 [ 新增要求 ] 以建立要求。在 [新增要求] 視窗中，將 [類型] 設定為 [HTTP]。輸入要求的 [ 名稱 ]。

在 [URL] 下拉式清單中選取 [GET HTTP 方法]，然後輸入下列 URL：

https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.0&query=47.60357,-122.32945&duration=12&subscription-key={Your-Azure-Maps-Subscription-key}

選取藍色 的 [建立] 按鈕。

選取 [執行] 按鈕。

顯示 [要求每小時天氣預報數據 URL] 的螢幕快照，其中顯示布魯諾應用程式中醒目提示的執行按鈕。

回應本文包含未來 12 小時的氣象預報資料。下列範例 JSON 回應只會顯示第一個小時：

{
  "forecasts": [
    {
      "date": "2024-08-07T15:00:00-07:00",
      "iconCode": 2,
      "iconPhrase": "Mostly sunny",
      "hasPrecipitation": false,
      "isDaylight": true,
      "temperature": {
        "value": 24.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 26.4,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 18.1,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 14.5,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 340,
          "localizedDescription": "NNW"
        },
        "speed": {
          "value": 14.8,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 24.1,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 53,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 11,
      "ceiling": {
        "value": 10211,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 5,
      "uvIndexPhrase": "Moderate",
      "precipitationProbability": 0,
      "rainProbability": 0,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

要求每分鐘氣象預報資料

取得每分鐘預報 API 會傳回指定位置未來 120 分鐘的每分鐘預報。使用者可以以 1、5 和 15 分鐘的間隔要求氣象預報。回應包含詳細資料，例如降雨類型 (包括降雨、降雪，或兩者的混合)、開始時間和降雨強度值 (dBZ)。

在此範例中，您要使用取得每分鐘預報 API 來擷取座標位於 Seattle, WA 的每分鐘氣象預報。提供未來 120 分鐘的氣象預報。我們的查詢要求以 15 分鐘間隔提供預報，但您可以將參數調整為 1 或 5 分鐘。

在布魯諾應用程式中，選取 [ 新增要求 ] 以建立要求。在 [新增要求] 視窗中，將 [類型] 設定為 [HTTP]。輸入要求的 [ 名稱 ]。

在 [URL] 下拉式清單中選取 [GET HTTP 方法]，然後輸入下列 URL：

https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.0&query=47.60357,-122.32945&interval=15&subscription-key={Your-Azure-Maps-Subscription-key}

選取藍色 的 [建立] 按鈕。

選取 [執行] 按鈕。

此螢幕快照顯示 [要求逐分鐘] 氣象預報數據 URL，並在布魯諾應用程式中醒目提示 [執行] 按鈕。

回應本文包含未來 120 分鐘的氣象預報資料，間隔為 15 分鐘。

{
  "summary": {
    "briefPhrase60": "No precipitation for at least 60 min",
    "shortPhrase": "No precip for 120 min",
    "briefPhrase": "No precipitation for at least 120 min",
    "longPhrase": "No precipitation for at least 120 min",
    "iconCode": 1
  },
  "intervalSummaries": [
    {
      "startMinute": 0,
      "endMinute": 119,
      "totalMinutes": 120,
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "iconCode": 1
    }
  ],
  "intervals": [
    {
      "startTime": "2024-08-08T05:58:00-07:00",
      "minute": 0,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 1,
      "cloudCover": 7
    },
    {
      "startTime": "2024-08-08T06:13:00-07:00",
      "minute": 15,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 1,
      "cloudCover": 3
    },
    {
      "startTime": "2024-08-08T06:28:00-07:00",
      "minute": 30,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 1,
      "cloudCover": 2
    },
    {
      "startTime": "2024-08-08T06:43:00-07:00",
      "minute": 45,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 1,
      "cloudCover": 2
    },
    {
      "startTime": "2024-08-08T06:58:00-07:00",
      "minute": 60,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 1,
      "cloudCover": 1
    },
    {
      "startTime": "2024-08-08T07:13:00-07:00",
      "minute": 75,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 1,
      "cloudCover": 1
    },
    {
      "startTime": "2024-08-08T07:28:00-07:00",
      "minute": 90,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 1,
      "cloudCover": 0
    },
    {
      "startTime": "2024-08-08T07:43:00-07:00",
      "minute": 105,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 1,
      "cloudCover": 0
    }
  ]
}

下一步

氣象服務概念

氣象服務

共用方式為

使用 Azure 地圖服務氣象服務來要求即時和預報的氣象資料

必要條件

要求即時氣象資料

要求嚴重氣象警示

要求每日氣象預報資料

要求每小時氣象預報資料

要求每分鐘氣象預報資料

下一步

意見反應

其他資源