O endpoint
publicAlerts
fornece detalhes sobre alertas de eventos climáticos específicos emitidos por
agências nacionais e internacionais autorizadas. Esses alertas fornecem informações cruciais
que podem salvar vidas.
O endpoint retorna alertas meteorológicos em tempo real para uma determinada latitude e longitude. Os eventos climáticos compatíveis incluem:
- Precipitação: chuva, neve, granizo, secas e muito mais
- Temperaturas extremas: frio, calor, congelamento, geada, sensação térmica e umidade
- Eventos de vento e tempestade: nevascas, furacões, tornados, tempestades tropicais, tempestades e muito mais
- Prejuízos à visibilidade: neblina, tempestades de poeira e rajadas de neve
- Riscos relacionados à água: inundações, tsunamis, tempestades, riscos costeiros e muito mais
- Eventos geofísicos e geológicos: terremotos, deslizamentos de terra e atividade vulcânica
- Incêndios: incêndios florestais, condições climáticas propícias a incêndios e muito mais
Para ver uma lista completa de eventos climáticos compatíveis, consulte Tipos de eventos climáticos.
Os alertas podem ou não conter descrições localizadas, dependendo do que está disponível na fonte de dados. Devido a restrições da fonte de dados, as informações são veiculadas como estão (conteúdo bruto). Para mais informações sobre as fontes de alertas meteorológicos, consulte Fontes de dados.
A API retorna as seguintes informações para um determinado alerta meteorológico:
- O tipo de evento climático associado ao alerta
- Uma lista de áreas afetadas com coordenadas que definem os limites geográficos dessas áreas.
- Um resumo em uma frase do evento climático
- Níveis de gravidade, certeza e urgência
- Uma descrição das instruções de recomendação de ação para o público-alvo
- Recomendações de segurança
- Horários de início e término do alerta
- O nome e o site da autoridade de publicação
O APIs Explorer permite fazer solicitações em tempo real para que você se familiarize com a API e as opções dela:
Sobre as solicitações de alerta de clima
Para solicitar informações de alerta de clima, envie uma solicitação GET HTTP para:
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
Inclua as coordenadas de latitude e longitude do local nos parâmetros de URL da solicitação.
Sobre as respostas aos alertas meteorológicos
A API Weather retorna os seguintes campos no corpo da resposta:
| Campo | Tipo | Descrição | Obrigatório ou opcional |
|---|---|---|---|
alertId |
String | O ID do alerta. Isso também pode ser encontrado no site do provedor de dados. | Obrigatório |
alertTitle |
String | O título do alerta, que descreve o evento climático. Observação: essa é a única string traduzida quando um parâmetro de código de idioma é incluído na solicitação. |
Obrigatório |
eventType |
Enumeração | O tipo de evento climático associado ao alerta. Para uma lista completa de eventos climáticos compatíveis, consulte Tipos de eventos climáticos. |
Obrigatório |
areaName |
String | O nome da área geográfica afetada pelo alerta, que inclui o local solicitado. | Obrigatório |
polygon |
String | Coordenadas que definem uma área dimensional fechada do alerta. | Opcional |
description |
String | Uma frase curta que resume a descrição do evento no idioma especificado (por exemplo, "Alerta de tornado"). | Opcional |
severity |
Enumeração | O nível de gravidade do alerta:
|
Opcional |
certainty |
Enumeração | O nível de certeza do alerta:
|
Opcional |
urgency |
Enumeração | O nível de urgência do alerta:
|
Opcional |
instruction |
String | Descrição das instruções de ação responsiva para o público-alvo. | Opcional |
safetyRecommendations |
String | Recomendações de segurança com base em códigos de autoridades públicas. Inclui diretrizes de nível superior e subtexto com informações adicionais. | Opcional |
timezoneOffset |
String | O deslocamento de fuso horário do evento, no formato +/-HH:MM. | Obrigatório |
startTime |
DateTime | A data e hora da época (horário UTC) em que as informações na mensagem de alerta entram em vigor. | Opcional |
expirationTime |
DateTime | A data e hora da época (horário UTC) em que um alerta deve terminar. Pode ser nulo para eventos de duração indefinida. Nesse caso, o título vai indicar que o evento está "em vigor". | Opcional |
dataSource |
Enumeração | Detalhes da autoridade, incluindo editor, nome e URL. | Obrigatório |
regionCode |
Enumeração | Código da região do local solicitado. | Opcional |
Fontes de dados
O endpoint de alertas meteorológicos retorna dados publicados pelos provedores listados na tabela a seguir. Com base nas coordenadas de latitude e longitude fornecidas na solicitação, o corpo da resposta mostra dados da autoridade local apropriada.
Os provedores incluídos no feed seguem as diretrizes de Avisos Públicos do Google. O Google pode atualizar a lista de provedores a qualquer momento.
Atribuição
Em todas as telas em que os dados são apresentados, o aplicativo do cliente precisa
incluir uma atribuição à fonte original usando o campo dataSource:
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
A atribuição precisa incluir o nome completo da fonte de dados (conforme fornecido no campo name) e um hiperlink para a fonte de dados usando o URL fornecido no campo authorityUri (por exemplo, "National Weather Service").
Tipos de eventos climáticos
Os seguintes tipos de eventos climáticos são aceitos:
| Tipos de eventos climáticos | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
Comportamento da tradução de respostas
O Google fornece traduções apenas para o campo alertTitle. Outros campos, como
eventType, areaName, instruction e safetyRecommendations, também podem
ser traduzidos, dependendo do suporte ao idioma da fonte de dados original.
No entanto, o Google não pode fornecer traduções independentes para esses campos.
Com base no parâmetro languageCode incluído na solicitação, os seguintes
comportamentos são esperados para o campo alertTitle:
languageCodecompatível: se olanguageCodesolicitado for fornecido e compatível, a resposta será retornada no idioma solicitado.- Não compatível
languageCode: nos casos em que olanguageCodesolicitado não é compatível e não é possível encontrar uma alternativa próxima, o endpoint retorna a resposta em inglês por padrão. - Nenhum
languageCodefornecido: o endpoint retorna a resposta em inglês por padrão.
Exemplo de solicitação de alerta meteorológico
O exemplo a seguir solicita informações de alerta meteorológico para uma cidade na Carolina do Norte:
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635 &location.longitude=-78.3168047 &languageCode=en"
O corpo da resposta é assim:
{ "weatherAlerts": [ { "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1", "alertTitle": { "text": "Flash Flood Warning", "languageCode": "en" }, "eventType": "FLASH_FLOOD", "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC", "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],[-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000], [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000], [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000], [-78.350000,35.940000],[-78.450000,35.820000]]]}", "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for... \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina... \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina... \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen. \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding. Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas, highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include... \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.", "severity": "SEVERE", "certainty": "LIKELY", "urgency": "IMMEDIATE", "instruction": [ "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles." ], "safetyRecommendations": [ { "directive": "Build an emergency kit and make a family communications plan.", "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan." }, { "directive": "Be aware that flash flooding can occur. ", "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move." }, ... ], "timezoneOffset": "-14400s", "startTime": "2025-08-06T18:24:00Z", "expirationTime": "2025-08-06T21:30:00Z", "dataSource": { "publisher": "NOAA", "name": "National Weather Service", "authorityUri": "https://www.weather.gov/" } } ], "regionCode": "US" }
Confira!
Com o APIs Explorer, é possível fazer solicitações de amostra para se familiarizar com a API e as opções dela.
Selecione o ícone da API api no lado direito da página.
Se quiser, edite os parâmetros da solicitação.
Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.
No painel do APIs Explorer, selecione o ícone de tela cheia fullscreen para expandir a janela do APIs Explorer.