O endpoint
publicAlerts
fornece detalhes sobre alertas de eventos climáticos específicos emitidos por
agências nacionais e internacionais confiáveis. Esses alertas fornecem informações cruciais que podem salvar vidas.
O endpoint retorna alertas de clima 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 com raios e muito mais
- Problemas de visibilidade:neblina, tempestades de poeira e rajadas de neve
- Perigos relacionados à água:inundações, tsunamis, tempestades, perigos costeiros e muito mais
- Eventos geofísicos e geológicos:terremotos, deslizamentos de terra e atividade vulcânica
- Incêndios:incêndios florestais, clima favorável a incêndios e muito mais
Para 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 de clima, consulte Fontes de dados.
A API retorna as seguintes informações para um determinado alerta de clima:
- 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 de 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
Com o APIs Explorer, você pode fazer solicitações em tempo real para se familiarizar com a API e as opções dela:
Sobre solicitações de alertas meteorológicos
Para solicitar informações de alerta de clima, envie uma solicitação HTTP GET 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 de 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. Essa informação também pode ser encontrada 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 responsivas para o público-alvo. | Opcional |
safetyRecommendations |
String | Recomendações de segurança com base em códigos de autoridades públicas. Inclui diretivas de nível superior e subtexto com mais informações. | Opcional |
timezoneOffset |
String | A compensação de fuso horário do evento, no formato +/-HH:MM. | Obrigatório |
startTime |
DateTime | A data e hora efetivas da época (horário UTC) das informações na mensagem de alerta. | Opcional |
expirationTime |
DateTime | A data e a 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 ela 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 compatíveis:
| 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 de tradução de respostas
O Google oferece traduções apenas para o campo alertTitle. Outros campos, como eventType, areaName, instruction e safetyRecommendations, também podem ser traduzidos, dependendo do suporte a idiomas 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:
languageCodeaceito:se olanguageCodesolicitado for fornecido e aceito, a resposta será retornada no idioma solicitado.languageCodenão compatível:quando olanguageCodesolicitado não é compatível e não é possível encontrar uma alternativa semelhante, 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, você pode 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.