Method: publicAlerts.lookup

Retorna alertas públicos de clima para um determinado local.

Solicitação HTTP

GET https://weather.googleapis.com/v1/publicAlerts:lookup

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
location

object (LatLng)

Obrigatório. O local para receber alertas meteorológicos públicos. O serviço vai retornar alertas cuja área afetada se cruza com esse local.
pageSize

integer

Opcional. O número máximo de registros de alertas meteorológicos públicos a serem retornados por página.
pageToken

string

Opcional. Um token de página recebido de uma chamada publicAlerts.lookup anterior. Forneça isso para recuperar a página subsequente. Ao paginar, todos os outros parâmetros fornecidos para publicAlerts.lookup precisam corresponder à chamada que forneceu o token da página.
languageCode

string

Opcional. Permite que o cliente escolha o idioma da resposta. Se não for possível fornecer dados para esse idioma, a API usará a correspondência mais próxima. Os valores permitidos dependem do padrão IETF BCP-47. O valor padrão é "en".

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para a RPC publicAlerts.lookup.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Campos
weatherAlerts[]

object (PublicAlerts)

Os registros públicos de alerta meteorológico, de acordo com o número de alertas e o tamanho da página especificados na solicitação.
regionCode

string

O código ISO_3166-1 alfa-2 da região correspondente ao local fornecido na solicitação. A região é indicada usando ISO_3166-1_alpha-2.
nextPageToken

string

Um token que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

PublicAlerts

Representa os alertas públicos de clima.

Representação JSON 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
Campos
alertId

string

O identificador exclusivo do alerta.
alertTitle

object (LocalizedText)

O título localizado do alerta.
eventType

enum (WeatherEventType)

O tipo de evento climático.
areaName

string

O nome da área em que o alerta é emitido.
instruction[]

string

Instruções recomendadas pelo editor. Embora esse campo deva ser localizado, não há garantia de que isso vai acontecer.
safetyRecommendations[]

object (SafetyRecommendation)

Diretiva de recomendações de segurança ao usuário, que pode ser fornecida pelo editor ou por outras autoridades.
timezoneOffset

string

A diferença de fuso horário do UTC para o local do alerta. O valor é formatado como uma string que termina em "s", por exemplo, "-14400s" para 4 horas atrás do UTC.
startTime

string (Timestamp format)

O horário de início do evento.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
expirationTime

string (Timestamp format)

O horário de expiração do evento.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
dataSource

object (DataSource)

Detalhes do editor que emitiu o alerta.
polygon

string

Uma representação GeoJSON das áreas em que o alerta é emitido.

Os dados GeoJSON precisam estar no formato RFC 7946 e representar um polígono (para uma única área contígua) ou um multipolígonos (para várias áreas distintas).

Exemplo:

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

Uma amostra de string GeoJson MultiPolygon tem esta aparência:

{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

O texto mais recente que descreve o alerta emitido pela autoridade oficial. Embora esse campo deva ser localizado, não há garantia de que isso vai acontecer.
severity

enum (Severity)

O nível de gravidade do alerta.
certainty

enum (Certainty)

A certeza do alerta.
urgency

enum (Urgency)

A urgência do alerta.

WeatherEventType

O tipo de evento climático.

Tipos enumerados
WEATHER_EVENT_TYPE_UNSPECIFIED Tipo de evento climático não especificado.
ACID_RAIN Evento de chuva ácida.
AFTERSHOCK Evento de tremor secundário.
AVALANCHE Evento de avalanche.
BLIZZARD Evento de nevasca.
BLOWING_SNOW Rajadas de vento com neve.
BUSHFIRE Incêndio florestal.
COASTAL_FLOOD Inundação costeira.
COASTAL_HAZARD Evento de risco costeiro.
COLD Evento de cold path.
CYCLONE Evento de ciclone.
DROUGHT Evento de seca.
DUST_STORM Evento de tempestade de poeira.
EARTHQUAKE Terremoto.
EXTRATROPICAL_CYCLONE Evento de ciclone extratropical.
FIRE Disparar evento.
FIRE_WEATHER Evento de clima de incêndio.
FLASH_FLOOD Enchente relâmpago.
FLOOD Evento de inundação.
FOG Evento de neblina.
FREEZING Evento de congelamento.
FREEZING_AIR_TEMPERATURE Evento de temperatura do ar congelante.
FREEZING_DRIZZLE Evento de garoa congelada.
FREEZING_RAIN_EVENT Evento de chuva congelante.
FROST Evento de geada.
GALE Evento de vendaval.
GLAZE Evento de esmalte.
HAIL Evento de granizo.
HAZARDOUS_SEAS Evento de mar perigoso.
HEAT Evento de calor.
HUMIDITY Evento de umidade.
HURRICANE Evento de furacão.
ICE_STORM Evento de tempestade de gelo.
INDUSTRIAL_FIRE Incêndio industrial.
LAKE_EFFECT_SNOW Evento de neve relacionada ao "efeito do lago".
LANDSLIDE Deslizamento de terra.
MONSOON Evento de monção.
MUDDY_FLOOD Inundação com lama.
OUTFLOW Evento de saída.
RADIATION Evento de radiação.
RAIN_EVENT Evento de chuva.
RIVER_FLOODING Inundação de rio.
SEVERE_THUNDERSTORM_WARNING Evento de alerta de tempestade severa com trovões.
SNOWSQUALL Evento de nevasca.
SNOW_EVENT Evento de neve.
STORM Evento de tempestade.
STORM_SURGE Evento de maré de tempestade.
THUNDER Evento de trovão.
THUNDERSTORM Evento de tempestade.
TORNADO Evento de tornado.
TORNADO_WARNING Evento de alerta de tornado.
TROPICAL_CYCLONE Evento de ciclone tropical.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Evento de alertas e avisos de ciclones tropicais.
TROPICAL_DISTURBANCE Evento de perturbação tropical.
TROPICAL_STORM Evento de tempestade tropical.
TSUNAMI Tsunami.
TYPHOON Evento de tufão.
VOLCANIC_ASH Evento de cinzas vulcânicas.
VOLCANIC_ERUPTION Evento de erupção vulcânica.
WILDFIRE Incêndio florestal.
WIND Evento de vento.
WIND_CHILL Evento de resfriamento pelo vento.
WIND_WAVE Evento de ondas de vento.
WINTER_STORM Evento de tempestade de inverno.

Gravidade

O código que indica a gravidade do evento principal da mensagem de alerta.

Tipos enumerados
SEVERITY_UNKNOWN Gravidade desconhecida.
EXTREME Ameaça extraordinária à vida ou à propriedade.
SEVERE Ameaça significativa à vida ou à propriedade.
MODERATE Possível ameaça à vida ou à propriedade.
MINOR Ameaça leve à vida ou à propriedade.

Certeza

O código que indica a certeza do evento principal da mensagem de alerta.

Tipos enumerados
CERTAINTY_UNKNOWN Certeza desconhecida.
OBSERVED Determinado como tendo ocorrido ou estando em andamento.
VERY_LIKELY Muito provavelmente.
LIKELY Provável (p > ~50%).
POSSIBLE Possível, mas não provável (p <= ~50%).
UNLIKELY Improvável (p ~ 0%).

Urgência

O código que indica a urgência do evento principal da mensagem de alerta.

Tipos enumerados
URGENCY_UNKNOWN Urgência desconhecida.
IMMEDIATE Uma ação responsiva DEVE ser tomada imediatamente.
EXPECTED Uma ação responsiva PRECISA ser tomada em breve (na próxima hora).
FUTURE Uma ação responsiva DEVE ser tomada em breve.
PAST Não é mais necessário fazer nada.

SafetyRecommendation

Representa uma recomendação de segurança.

Representação JSON 
{
  "directive": string,
  "subtext": string
}
Campos
directive

string

Uma diretiva para o usuário. Embora esse campo deva ser localizado, não há garantia de que isso vai acontecer.
subtext

string

Um subtexto opcional para a diretiva, que pode conter contexto adicional para o usuário. Embora esse campo deva ser localizado, não há garantia de que isso vai acontecer.

DataSource

Representa um link para uma fonte de dados.

Representação JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Campos
publisher

enum (Publisher)

O editor do alerta.
name

string

Nome oficial do editor. Embora esse campo deva ser localizado, não há garantia de que isso vai acontecer.
authorityUri

string

O URL do site da autoridade.

Editor

O editor do alerta.

Tipos enumerados
PUBLISHER_UNSPECIFIED Editor não especificado.
AUSTRALIA_ACT_ESA Austrália, Território da Capital Australiana
AUSTRALIA_NSW_RFS Nova Gales do Sul
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS Austrália do Sul
METEO_ALARM_AT Meteoalarm / EUMETNET Áustria
METEO_ALARM_BS Bósnia
BRAZIL_CENAD Agência de desastres do Brasil
BRAZIL_INMET Agência de Meteorologia no Brasil
UK_ENV_AGENCY Reino Unido
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgária
METEO_ALARM_CR Croácia
METEO_ALARM_CY Chipre
METEO_ALARM_CS República Tcheca
METEO_ALARM_DK Dinamarca
EC_INAMHI Equador
METEO_ALARM_FI Meteoalarm / EUMETNET Finlândia
METEO_ALARM_FR França
DE_DWD Alemanha
METEO_ALARM_GB Meteoalarm / EUMETNET Grã-Bretanha
METEO_ALARM_GR Grécia
METEO_ALARM_HU Hungria
METEO_ALARM_IS Islândia
METEO_ALARM_IE Irlanda
METEO_ALARM_IT Itália
JM_JMS Jamaica
JMA Japão
METEO_ALARM_NL Meteoalarm / EUMETNET Países Baixos
METEO_ALARM_LV Letônia
METEO_ALARM_LT Lituânia
METEO_ALARM_LU Luxemburgo
MEXICO_CIRES México México CIRES
NZ_GEONET Nova Zelândia: GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET Macedônia do Norte
METEO_ALARM_NO Noruega
PHILIPPINES_PAGASA Filipinas
METEO_ALARM_PL Meteoalarm / EUMETNET Poland
METEO_ALARM_PT Portugal
METEO_ALARM_RO Romênia
METEO_ALARM_RS Sérvia
SG_MSS Singapura
METEO_ALARM_SK Meteoalarm / EUMETNET Eslováquia
METEO_ALARM_SI Eslovênia
SB_MET Ilhas Salomão
METEO_ALARM_ES Meteoalarm / EUMETNET Espanha
METEO_ALARM_SE Suécia
METEO_ALARM_CH Suíça
TAIWAN_NCDR Taiwan
NOAA NOAA dos Estados Unidos
WCATWC National Tsunami Warning Center