Compartilhar via


Solicitar dados meteorológicos em tempo real e previstos usando os serviços Clima do Azure Mapas

Os serviços Clima do Azure Mapas são um conjunto de APIs RESTful que permite aos desenvolvedores integrar dados meteorológicos históricos, em tempo real e previstos e visualizações nas suas soluções.

Este artigo demonstra como solicitar dados meteorológicos e de previsão em tempo real:

Este vídeo fornece exemplos para fazer chamadas REST para os serviços Clima do Azure Mapas.



Pré-requisitos

Importante

Nos exemplos de URL neste artigo, você precisará substituir {Your-Azure-Maps-Subscription-key} pela chave de assinatura do Azure Mapas.

Este tutorial usa o aplicativo bruno, mas é possível escolher outro ambiente de desenvolvimento de APIs.

Solicitar dados meteorológicos em tempo real

A API para obter condições atuais retorna condições de clima detalhadas, como precipitação, temperatura e vento para um determinado local de coordenadas. Além disso, as observações das últimas 6 ou 24 horas para um local específico podem ser recuperadas. A resposta inclui detalhes como data e hora de observação, breve descrição das condições climáticas, ícone de clima, sinalizadores de indicador de precipitação e temperatura. Temperatura RealFeel™ e índice UV (ultravioleta) também são retornados.

Neste exemplo, você usará a API Get Current Conditions para recuperar as condições climáticas atuais em coordenadas localizadas em Seattle, WA.

  1. Abra o aplicativo bruno e selecione NOVA SOLICITAÇÃO para criar a solicitação. Na janela NOVA SOLICITAÇÃO, defina Tipo como HTTP. Digite um Nome para a solicitação.

  2. Selecione o método HTTP GET na lista suspensa URL e insira o seguinte URL:

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

  4. Selecione o botão executar.

    Uma captura de tela mostrando o URL de solicitação de dados meteorológicos em tempo real com o botão “Executar” realçado no aplicativo bruno.

    O corpo da resposta contém informações sobre o clima atual.

    {
      "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
              }
            }
          }
        }
      ]
    }
    

Solicitar alertas de clima severo

A API Get Severe Weather Alerts do Azure Mapas retorna os alertas de clima severo que estão disponíveis em todo o mundo de órgãos meteorológicos governamentais oficiais e provedores de alerta de clima global a regional. O serviço retorna detalhes como tipo de alerta, categoria e nível. O serviço também retorna descrições detalhadas sobre os alertas severos ativos para o local solicitado, como furacões, tempestades, raios, ondas de calor ou incêndios florestais. Por exemplo, gerentes de logística podem visualizar condições de clima severo em um mapa, juntamente com locais de negócios e rotas planejadas, além de coordenar ainda mais com os motoristas e funcionários locais.

Neste exemplo, você usará a API Get Severe Weather Alerts para recuperar as condições climáticas atuais em coordenadas localizadas em Cheyenne, WY.

Observação

Este exemplo recupera alertas de clima severo no momento da redação deste artigo. É provável que não haja mais nenhum alerta de clima severo no local solicitado. Para recuperar dados de alerta grave real ao executar este exemplo, você precisará recuperar dados em um local de coordenadas diferente.

  1. No aplicativo bruno, selecione NOVA SOLICITAÇÃO para criar a solicitação. Na janela NOVA SOLICITAÇÃO, defina Tipo como HTTP. Digite um Nome para a solicitação.

  2. Selecione o método HTTP GET na lista suspensa URL e insira o seguinte 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}
    
  3. Selecione o botão azul Criar.

  4. Selecione o botão executar.

    Uma captura de tela mostrando o URL de solicitação de alertas de clima severo com o botão “Executar” realçado no aplicativo bruno.

    Se não houver nenhum alerta de clima severo, o corpo da resposta conterá uma matriz results[] vazia. Se houver alertas de clima severo, o corpo da resposta conterá algo semelhante à seguinte resposta 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"
                }
            ]
            },...
        ]
    }
    

Solicitar dados de previsão do tempo diária

A API para obter previsão diária retorna uma previsão do tempo diária detalhada, como temperatura e vento. A solicitação pode especificar quantos dias para retornar: 1, 5, 10, 15, 25 ou 45 dias para um determinado local de coordenadas. A resposta inclui detalhes como temperatura, vento, precipitação, qualidade do ar e índice UV. Neste exemplo, solicitamos cinco dias configurando duration=5.

Importante

No tipo de preço S0, você pode solicitar uma previsão diária para os próximos 1, 5, 10 e 15 dias. No tipo de preço Gen1 (S1) ou Gen2, você pode solicitar a previsão diária para os próximos 25 dias e 45 dias.

Desativação do tipo de preço Gen1 do Azure Mapas

O tipo de preço Gen1 foi preterido e será desativado em 15/09/26. O tipo de preço Gen2 substitui o Gen1 (S0 e S1). Se em sua conta do Azure Mapas estiver selecionado o tipo de preço Gen1, você poderá alternar para o Gen2 antes da desativação, caso contrário, ele será atualizado automaticamente. Para obter mais informações, consulte Gerenciar o tipo de preço de sua conta Azure Mapas.

Neste exemplo, você usará a API Get Daily Forecast API para recuperar a previsão do tempo de cinco dias para as coordenadas localizadas em Seattle, WA.

  1. No aplicativo bruno, selecione NOVA SOLICITAÇÃO para criar a solicitação. Na janela NOVA SOLICITAÇÃO, defina Tipo como HTTP. Digite um Nome para a solicitação.

  2. Selecione o método HTTP GET na lista suspensa URL e insira o seguinte 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}
    
  3. Selecione o botão azul Criar.

  4. Selecione o botão executar.

    Uma captura de tela mostrando o URL de solicitação de dados de previsão do tempo diária com o botão “Executar” realçado no aplicativo bruno.

    O corpo da resposta contém os dados de previsão do tempo de cinco dias. Para fins de brevidade, a resposta JSON abaixo mostra a previsão para o primeiro dia.

    {
      "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"
          ]
        }
      ]
    }
    

Solicitar dados de previsão do tempo por hora

A API para obter previsão por hora retorna a previsão do tempo detalhada por hora para as próximas 1, 12, 24 (1 dia), 72 (3 dias), 120 (5 dias) e 240 horas (10 dias) para o local de coordenadas fornecido. A API retorna detalhes como temperatura, umidade, vento, precipitação e índice UV.

Importante

No tipo de preço Gen1 (S0), você pode solicitar uma previsão por hora para as próximas 1, 12, 24 horas (1 dia) e 72 horas (3 dias). No tipo de preço Gen1 (S1) ou Gen2, você pode solicitar a previsão por hora para as próximas 120 horas (5 dias) e 240 horas (10 dias).

Neste exemplo, você usará a API Get Hourly Forecast API para recuperar a previsão do tempo por hora para as próximas 12 horas nas coordenadas localizadas em Seattle, WA.

  1. No aplicativo bruno, selecione NOVA SOLICITAÇÃO para criar a solicitação. Na janela NOVA SOLICITAÇÃO, defina Tipo como HTTP. Digite um Nome para a solicitação.

  2. Selecione o método HTTP GET na lista suspensa URL e insira o seguinte 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}
    
  3. Selecione o botão azul Criar.

  4. Selecione o botão executar.

    Uma captura de tela mostrando o URL de solicitação de dados de previsão do tempo por hora com o botão “Executar” realçado no aplicativo bruno.

    O corpo da resposta contém dados de previsão do tempo para as próximas 12 horas. Este exemplo de resposta JSON mostra apenas a primeira hora:

    {
      "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
          }
        }
      ]
    }
    

Solicitar dados de previsão do tempo de minuto a minuto

A API para obter previsão por minuto retorna previsões de minuto a minuto para um determinado local nos próximos 120 minutos. Os usuários podem solicitar previsões do tempo em intervalos de 1, 5 e 15 minutos. A resposta inclui detalhes como o tipo de precipitação (como chuva, neve ou uma mistura delas), hora de início e valor de intensidade de precipitação (dBZ).

Neste exemplo, você usará a API Get Minute Forecast para recuperar a previsão do tempo por minuto nas coordenadas localizadas em Seattle, WA. A previsão do tempo é dada para os próximos 120 minutos. Nossa consulta solicita que a previsão seja fornecida em intervalos de 15 minutos, mas você pode ajustar o parâmetro para ter 1 ou 5 minutos.

  1. No aplicativo bruno, selecione NOVA SOLICITAÇÃO para criar a solicitação. Na janela NOVA SOLICITAÇÃO, defina Tipo como HTTP. Digite um Nome para a solicitação.

  2. Selecione o método HTTP GET na lista suspensa URL e insira o seguinte 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}
    
  3. Selecione o botão azul Criar.

  4. Selecione o botão executar.

    Uma captura de tela mostrando o URL de solicitação de dados de previsão do tempo minuto a minuto com o botão “Executar” realçado no aplicativo bruno.

    O corpo da resposta contém dados de previsão do tempo para os próximos 120 minutos, em intervalos de 15 minutos.

    {
      "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
        }
      ]
    }
    

Próximas etapas