MCP Tools Reference: mapstools.googleapis.com

Ferramenta: lookup_weather

Recupera informações ambientais abrangentes de um local, incluindo clima, qualidade do ar (IQA e poluentes) e pólen (níveis de alérgenos de árvores, grama, ervas daninhas e espécies de plantas): condições atuais, previsões/histórico por hora e previsões diárias de clima e qualidade do ar. O pólen é apenas uma previsão diária (de hoje até +4 dias, sem dados por hora ou anteriores). Domínios e recursos ambientais disponíveis (capabilities: WEATHER, AIR_QUALITY, POLLEN — CRÍTICO): * Seleção explícita obrigatória: você PRECISA incluir pelo menos um dos seguintes valores: WEATHER, AIR_QUALITY ou POLLEN em capabilities em cada chamada. NÃO é permitido omitir capabilities. * Consultas externas amplas/ambíguas (conjunto completo de ambiente externo): se o usuário fizer uma pergunta geral sobre atividades ao ar livre, viagens ou situações sem restringir a um domínio específico (por exemplo, "Como estão as condições externas agora para uma corrida?"), inclua explicitamente os três recursos (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]) para retornar o conjunto completo de ambiente externo (clima + qualidade do ar + pólen). Para um date/hour anterior, deixe de fora POLLEN, que não tem histórico. * Seleção de domínio segmentado (consultas específicas): se o usuário pedir especificamente apenas um ou dois domínios (por exemplo, "Qual é o IQA em Seattle agora?"), inclua apenas os recursos solicitados (WEATHER, AIR_QUALITY e/ou POLLEN). Somente os domínios solicitados serão executados e retornados. Dados específicos disponíveis por domínio: * Clima (weather): temperatura (atual, sensação térmica, máxima/mínima, índice de calor), vento (velocidade, rajadas, direção), eventos celestes (nascer/pôr do sol, fase da lua), precipitação (tipo, probabilidade, quantidade/QPF) e condições atmosféricas (índice UV, umidade, cobertura de nuvens, probabilidade de tempestade, pressão do ar). * Qualidade do ar (air_quality): índices de qualidade do ar (IQA) universais e locais (valor do IQA, categoria, poluente dominante), recomendações de saúde para sete grupos de sensibilidade e concentrações de poluentes (include_pollutant_concentration: true). Cada índice tem o próprio poluente dominante. Informe-o por índice (por exemplo, não use o poluente do IQA universal para o IQA dos EUA). * Pólen (pollen): Índice Universal de Pólen (UPI, na sigla em inglês, de 0 a 5) diário por categoria de árvore, grama e erva daninha e por espécie de planta (index.value com o index.category, por exemplo, 1 = "Muito baixo"), status de temporada, reações cruzadas e recomendações de saúde. * Campos de pólen ausentes: um in_season ausente significa que não está para esta temporada. Não mencione as espécies de plantas retornadas sem um index, a menos que o usuário pergunte sobre essa planta. Nesse caso, diga que não há dados de pólen informados para ela hoje (não deduza um nível). Regras de local (CRÍTICO): a região de segmentação PRECISA ser especificada em location usando APENAS UM dos seguintes subcampos de oneof: 1. Coordenadas geográficas (lat_lng): use quando as coordenadas exatas de latitude/longitude forem conhecidas. * Exemplo: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. ID de lugar (place_id): * Um ID de lugar inequívoco do Google Maps (por exemplo, obtido em search_places ou resolve_names). * Exemplo: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. String de endereço (address): uma cidade/região, bairro, ponto de referência ou de interesse, endereço ou código postal, de preferência com a cidade/país. * Exemplo: {"location": {"address": "Paris, France"}} Modos de horário e uso (date e hour — CRÍTICO): * Referência de fuso horário local: todas as entradas de date ({year, month, day}) e hour (0-23) PRECISAM ser expressas no fuso horário civil local do location solicitado (por exemplo, uma consulta para "Paris tomorrow at 13:00" usa a data e hora local de Europe/Paris 13), nunca o UTC ou o fuso horário do autor da chamada. * 1. Condições atuais (date omitido E hour omitido): * Forneça location e o capabilities de destino (WEATHER, AIR_QUALITY, POLLEN). NÃO especifique date ou hour. * Retorna as condições atuais (CC) em tempo real para os domínios solicitados (clima atual, qualidade do ar na hora atual e/ou previsão de pólen para hoje). * Para Qualidade do ar, as condições atuais são de uma única hora: NÃO use isso sozinho para responder a perguntas sobre a qualidade do ar ou sobre o clima externo em geral de hoje como um todo (use as consultas diárias abaixo). * 2. Previsão/histórico por hora (date especificado E hour especificado 0-23): * Forneça location, date ({year, month, day}), hour (0-23) e o destino capabilities. Se os minutos forem mencionados, arredonde para baixo até a hora mais próxima. * RESTRIÇÃO CRÍTICA (date é OBRIGATÓRIO quando hour é definido): fornecer hour sem date (date omitido, hour definido) NÃO é permitido e vai resultar em um erro. Mesmo quando o usuário perguntar sobre um horário específico de hoje (por exemplo, "at 13:00 today"), você PRECISA preencher date (data de hoje às location) e hour. * Executa uma consulta por hora para o clima e/ou a qualidade do ar solicitados em YYYY-MM-DD-HH e uma consulta diária para o pólen solicitado em YYYY-MM-DD. * Perguntas sobre "quando" em relação ao clima: para perguntas sobre clima que perguntam quando / que horas / melhor horário (por exemplo, "what time will it stop raining?"), use chamadas de WEATHER por hora (date + hour) para as horas relevantes. Uma previsão do tempo diária não tem valores por hora. Para perguntas gerais sobre atividades ao ar livre do tipo "quando / melhor horário" (por exemplo, "when is the best time to go walking today?"), faça estas chamadas de WEATHER por hora, além da chamada de dia inteiro para qualidade do ar (e pólen) descrita em "Consultas diárias". * 3. Consultas diárias (date especificado E hour omitido): * Forneça location, date ({year, month, day} no horário civil local do location solicitado) sem hour e o capabilities de destino para consultas de dia inteiro (por exemplo, "weather and pollen in London tomorrow"). * Perguntas sobre qualidade do ar e atividades ao ar livre em geral para hoje: para perguntas sobre qualidade do ar e atividades ao ar livre em geral (que incluem qualidade do ar) para hoje (por exemplo, "how will the air quality change today", "is today a good day for a picnic?"), defina date como a data de hoje em location (hora omitida) para receber a série de qualidade do ar por hora do dia. Uma chamada de condições atuais retorna apenas a hora atual da qualidade do ar e não é suficiente. Você pode adicionar uma se o usuário também perguntar sobre "agora". * Janelas de tempo de qualidade do ar: para uma pergunta sobre a qualidade do ar em uma janela de um dia (por exemplo, "air quality between noon and 6 PM"), prefira uma chamada diária para essa data e leia as horas da janela na série de qualidade do ar, em vez de amostrar horas individuais. Se você usar chamadas por hora, cubra todas as horas do período. * Retorna previsões diárias para Clima e/ou Pólen solicitados, além da série de Qualidade do ar por hora do dia, cobrindo todo o dia local (00:00–23:00 local): 24 horas históricas para uma data passada, 24 horas previstas para uma data futura e, para hoje, as horas anteriores (histórico), a hora atual e as horas restantes (previsão). Horizontes de tempo aceitos por domínio: * Clima: de hora em hora, de 24 horas atrás até 240 horas (10 dias) à frente (as horas passadas precisam de date e hour); diariamente até 10 dias, incluindo hoje (de hoje até +9 dias); sem histórico diário. * Qualidade do ar: de hora em hora, de 720 horas (30 dias) atrás até 96 horas (4 dias) à frente. Uma chamada de dia inteiro precisa se encaixar nessa janela (na prática, de 29 dias atrás até 3 dias à frente). * Pólen: somente diário, de hoje até +4 dias (5 dias, incluindo hoje). Sem datas passadas, e hour é ignorado. * Observação: se vários recursos forem solicitados e o date/hour estiver fora de um dos intervalos, a chamada ainda será bem-sucedida e retornará apenas os recursos compatíveis. * Solicitações fora do intervalo: se uma data ou hora solicitada estiver fora do intervalo aceito de um domínio acima (por exemplo, Pollen para uma data anterior), ainda chame lookup_weather para a data/hora solicitada. O estado de erro indica o intervalo aceito. Não use uma data, hora ou domínio diferente como substituto. Opções de domínio e atribuição: * Idioma (language_code): código de idioma BCP-47 opcional (por exemplo, "fr"). O padrão é "en". * Unidades de clima (weather_options.units_system ou units_system): o padrão é METRIC. Defina como IMPERIAL (Fahrenheit/mph) se o usuário sugerir padrões dos EUA ou solicitar explicitamente unidades imperiais. Compatível com weather_options.units_system (preferencial) e units_system de nível superior. Se ambos forem especificados, eles não poderão entrar em conflito. * Opções de qualidade do ar (air_quality_options): defina include_pollutant_concentration: true quando forem necessárias concentrações específicas de poluentes (PM2.5, PM10, O3, NO2, SO2, CO). Se quiser, defina index_region_code (código ISO de duas letras do país, por exemplo, "US") para solicitar uma escala de IQA regional específica. Por padrão, a resposta inclui o IQA universal e o IQA regional do local. * Atribuição: a saída embasada PRECISA ser atribuída à fonte usando o campo attribution dentro de cada contêiner de domínio retornado (weather.attribution, air_quality.attribution, pollen.attribution). * Horários retornados: os valores de qualidade do ar date_time já estão no horário local do local (utc_offset incluído). Apresente-os como estão. O clima date_time (atual e por hora) e os horários do nascer/pôr do sol estão em UTC. Converta-os para o horário local do local usando time_zone. Rotule todos os horários como locais.

O exemplo de código a seguir mostra como usar curl para chamar a ferramenta MCP lookup_weather.

Solicitação curl 
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Solicitação para o método LookupWeather, que representa as condições climáticas no local solicitado.

LookupWeatherRequest

Representação JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.

  // Union field _language_code can be only one of the following:
  "languageCode": string
  // End of list of possible types for union field _language_code.

  // Union field _weather_options can be only one of the following:
  "weatherOptions": {
    object (WeatherOptions)
  }
  // End of list of possible types for union field _weather_options.

  // Union field _air_quality_options can be only one of the following:
  "airQualityOptions": {
    object (AirQualityOptions)
  }
  // End of list of possible types for union field _air_quality_options.
}
Campos
unitsSystem

enum (UnitsSystem)

Opcional. O sistema de unidades que será usado para as condições climáticas retornadas. Se não for fornecido, as condições climáticas retornadas serão no sistema métrico (padrão = METRIC).
location

object (Location)

Obrigatório. O local para o qual as condições climáticas serão consultadas.
capabilities[]

enum (Capability)

Opcional. Os recursos ambientais que serão incluídos na resposta.

Campo de união _date.

_date pode ser apenas de um dos tipos a seguir:
date

object (Date)

Opcional. Especifica a data das informações ambientais solicitadas, em relação ao fuso horário local do local especificado no campo location. Os períodos aceitos dependem dos recursos solicitados: - WEATHER: até 24 horas no passado (quando hour também está definido) e até 10 dias (240 horas) no futuro (de hoje até +9 dias para previsões diárias). - AIR_QUALITY: até 30 dias (720 horas) no passado e até 4 dias (96 horas) no futuro. - POLLEN: de hoje até +4 dias (até 5 dias, incluindo hoje; datas históricas não são aceitas).

Campo de união _hour.

_hour pode ser apenas de um dos tipos a seguir:
hour

integer

Opcional. Especifica a hora das informações ambientais solicitadas, no formato de 24 horas (0 a 23), em relação ao fuso horário local do local especificado no campo location. Requer que date seja especificado. Os intervalos por hora aceitos dependem dos recursos solicitados: - WEATHER: até 24 horas no passado e até 240 horas (10 dias) no futuro. - AIR_QUALITY: até 30 dias (720 horas) no passado e até 4 dias (96 horas) no futuro. - POLLEN: retorna apenas previsões diárias. hour é ignorado para pólen.

Campo de união _language_code.

_language_code pode ser apenas de um dos tipos a seguir:
languageCode

string

Opcional. O código de idioma BCP-47 para texto localizado na resposta (por exemplo, "en", "ja", "fr-CA"). O padrão será "en" se não houver nada especificado.

Campo de união _weather_options.

_weather_options pode ser apenas de um dos tipos a seguir:
weatherOptions

object (WeatherOptions)

Opcional. Opções específicas para solicitações de clima. weather_options.units_system é compatível com units_system de nível superior (tag 4) para preservar a compatibilidade com versões anteriores para autores de chamadas atuais. Retorna INVALID_ARGUMENT se ambos especificarem sistemas de unidades conflitantes. Ignorado se WEATHER não for solicitado em capabilities.

Campo de união _air_quality_options.

_air_quality_options pode ser apenas de um dos tipos a seguir:
airQualityOptions

object (AirQualityOptions)

Opcional. Opções específicas para solicitações de qualidade do ar. Ignorado se AIR_QUALITY não for solicitado em capabilities.

Data

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

Local

Representação JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Campos
Campo de união location_type. Diferentes maneiras de representar um local. location_type pode ser apenas de um dos tipos a seguir:
latLng

object (LatLng)

Um ponto especificado usando coordenadas geográficas.
placeId

string

O ID de lugar associado ao local.
address

string

Endereço legível por humanos (por exemplo, rua, cidade ou código postal).

LatLng

Representação JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].
longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

WeatherOptions

Representação JSON 
{
  "unitsSystem": enum (UnitsSystem)
}
Campos
unitsSystem

enum (UnitsSystem)

Opcional. O sistema de unidades que será usado para as condições climáticas retornadas. Se não for fornecido, as condições climáticas retornadas serão no sistema métrico (padrão = METRIC).

AirQualityOptions

Representação JSON 
{

  // Union field _include_pollutant_concentration can be only one of the
  // following:
  "includePollutantConcentration": boolean
  // End of list of possible types for union field
  // _include_pollutant_concentration.

  // Union field _index_region_code can be only one of the following:
  "indexRegionCode": string
  // End of list of possible types for union field _index_region_code.
}
Campos

Campo de união _include_pollutant_concentration.

_include_pollutant_concentration pode ser apenas de um dos tipos a seguir:
includePollutantConcentration

boolean

Opcional. Se for verdadeiro, inclui concentrações detalhadas de poluentes e informações adicionais (fontes e efeitos) na resposta de qualidade do ar.

Campo de união _index_region_code.

_index_region_code pode ser apenas de um dos tipos a seguir:
indexRegionCode

string

Opcional. Código de país/região ISO 3166-1 alfa-2 de duas letras (por exemplo, "US", "FR", "CN") usado para selecionar a escala do índice de qualidade do ar (IQA) local preferencial junto com o IQA universal (UAQI). Se não for especificado, o padrão será a região do local solicitado.

UnitsSystem

Representa o sistema de unidades usado para medir valores.

Tipos enumerados
UNITS_SYSTEM_UNSPECIFIED O sistema de unidades não foi especificado.
IMPERIAL O sistema de unidades imperiais (por exemplo, Fahrenheit, milhas etc.).
METRIC O sistema de unidades métricas (por exemplo, Celsius, quilômetros etc.).

Capacidade

Recursos ambientais que podem ser solicitados em LookupWeatherRequest.

Tipos enumerados
CAPABILITY_UNSPECIFIED Capacidade não especificada.
WEATHER Condições climáticas (temperatura, precipitação, vento, UV etc.).
AIR_QUALITY Informações sobre a qualidade do ar (IQA, poluentes e recomendações de saúde).
POLLEN Informações sobre pólen (níveis de alérgenos de árvores, grama, ervas daninhas e espécies de plantas).

Esquema de saída

Resposta para o RPC LookupWeather: representa as condições climáticas no local solicitado.

Essa resposta representa informações por hora e diárias. Portanto, ela é dividida em três seções: por hora, diária e compartilhada. Os campos Only-Hourly e Only-Daily são marcados como opcionais. Alguns campos compartilhados entre as informações por hora e diárias estão sempre presentes, então não são marcados como opcionais. Os demais são marcados como opcionais porque nem sempre estão disponíveis.

LookupWeatherResponse

Representação JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.

  // Union field _weather can be only one of the following:
  "weather": {
    object (WeatherResultData)
  }
  // End of list of possible types for union field _weather.

  // Union field _air_quality can be only one of the following:
  "airQuality": {
    object (AirQualityResultData)
  }
  // End of list of possible types for union field _air_quality.

  // Union field _pollen can be only one of the following:
  "pollen": {
    object (PollenResultData)
  }
  // End of list of possible types for union field _pollen.

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.
}
Campos
weatherCondition

object (WeatherCondition)

A condição climática
precipitation

object (Precipitation)

A probabilidade de precipitação e a quantidade de precipitação acumulada
wind

object (Wind)

As condições do vento
returnedLocation

object (Location)

Obrigatório. O local em que as informações meteorológicas são retornadas. Esse local é idêntico ao da solicitação, mas pode ser diferente se o local solicitado for um endereço de texto livre que se refere a uma localização aproximada (por exemplo, "Mountain View, CA").
attribution

object (Attribution)

Atribuição obrigatória para mostrar com o clima.

Campo de união _temperature.

_temperature pode ser apenas de um dos tipos a seguir:
temperature

object (Temperature)

A temperatura por hora

Campo de união _feels_like_temperature.

_feels_like_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeTemperature

object (Temperature)

A medição por hora da sensação térmica.

Campo de união _heat_index.

_heat_index pode ser apenas de um dos tipos a seguir:
heatIndex

object (Temperature)

A temperatura do índice de calor por hora.

Campo de união _air_pressure.

_air_pressure pode ser apenas de um dos tipos a seguir:
airPressure

object (AirPressure)

As condições de pressão do ar por hora.

Campo de união _max_temperature.

_max_temperature pode ser apenas de um dos tipos a seguir:
maxTemperature

object (Temperature)

A temperatura máxima (alta) ao longo do dia.

Campo de união _min_temperature.

_min_temperature pode ser apenas de um dos tipos a seguir:
minTemperature

object (Temperature)

A temperatura mínima (baixa) ao longo do dia.

Campo de união _feels_like_max_temperature.

_feels_like_max_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeMaxTemperature

object (Temperature)

A sensação térmica máxima (alta) ao longo do dia.

Campo de união _feels_like_min_temperature.

_feels_like_min_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeMinTemperature

object (Temperature)

A sensação térmica mínima (baixa) ao longo do dia.

Campo de união _max_heat_index.

_max_heat_index pode ser apenas de um dos tipos a seguir:
maxHeatIndex

object (Temperature)

A temperatura máxima do índice de calor ao longo do dia.

Campo de união _sun_events.

_sun_events pode ser apenas de um dos tipos a seguir:
sunEvents

object (SunEvents)

Os eventos relacionados ao sol (por exemplo, nascer e pôr do sol).

Campo de união _moon_events.

_moon_events pode ser apenas de um dos tipos a seguir:
moonEvents

object (MoonEvents)

Os eventos relacionados à lua (por exemplo, nascer e pôr da lua).

Campo de união _relative_humidity.

_relative_humidity pode ser apenas de um dos tipos a seguir:
relativeHumidity

integer

A porcentagem de umidade relativa (valores de 0 a 100).

Campo de união _uv_index.

_uv_index pode ser apenas de um dos tipos a seguir:
uvIndex

integer

O índice máximo de ultravioleta (UV).

Campo de união _thunderstorm_probability.

_thunderstorm_probability pode ser apenas de um dos tipos a seguir:
thunderstormProbability

integer

A probabilidade de tempestade (valores de 0 a 100).

Campo de união _cloud_cover.

_cloud_cover pode ser apenas de um dos tipos a seguir:
cloudCover

integer

A porcentagem do céu coberta por nuvens (valores de 0 a 100).

Campo de união _weather.

_weather pode ser apenas de um dos tipos a seguir:
weather

object (WeatherResultData)

Condições climáticas no local solicitado.

Campo de união _air_quality.

_air_quality pode ser apenas de um dos tipos a seguir:
airQuality

object (AirQualityResultData)

Informações sobre a qualidade do ar no local solicitado.

Campo de união _pollen.

_pollen pode ser apenas de um dos tipos a seguir:
pollen

object (PollenResultData)

Informações sobre pólen no local solicitado.

Campo de união _time_zone.

_time_zone pode ser apenas de um dos tipos a seguir:
timeZone

string

String de fuso horário da IANA resolvida para o local (por exemplo, "America/New_York", "Asia/Tokyo").

Temperatura

Representação JSON 
{
  "unit": enum (Unit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
Campos
unit

enum (Unit)

Opcional. O código da unidade usada para medir o valor da temperatura.

Campo de união _degrees.

_degrees pode ser apenas de um dos tipos a seguir:
degrees

number

O valor da temperatura (em graus) na unidade especificada.

AirPressure

Representação JSON 
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
Campos

Campo de união _mean_sea_level_millibars.

_mean_sea_level_millibars pode ser apenas de um dos tipos a seguir:
meanSeaLevelMillibars

number

A pressão média do ar no nível do mar em milibares.

SunEvents

Representação JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Campos
sunriseTime

string (Timestamp format)

O horário em que o sol nasce.

OBSERVAÇÃO: em alguns casos específicos (por exemplo, ao norte do círculo polar ártico), pode não haver um horário de nascer do sol para um dia. Nesses casos, esse campo não será definido.

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".
sunsetTime

string (Timestamp format)

O horário em que o sol se põe.

OBSERVAÇÃO: em alguns casos específicos (por exemplo, ao norte do círculo polar ártico), pode não haver um horário de pôr do sol para um dia. Nesses casos, esse campo não será definido.

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".

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799, inclusive (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999.

MoonEvents

Representação JSON 
{
  "moonPhase": enum (Phase),
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ]
}
Campos
moonPhase

enum (Phase)

Opcional. A fase da lua (também conhecida como fase lunar).
moonriseTimes[]

string (Timestamp format)

O momento em que a parte superior da lua aparece acima do horizonte (consulte https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

OBSERVAÇÃO: na maioria dos casos, há um único horário de nascer da lua por dia. Em outros casos, a lista pode estar vazia (por exemplo, quando a lua nasce depois da meia-noite do dia seguinte). No entanto, em casos específicos (por exemplo, em regiões polares), a lista pode conter mais de um valor. Nesses casos, os valores são classificados em ordem crescente.

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".
moonsetTimes[]

string (Timestamp format)

O momento em que o limbo superior da lua desaparece abaixo do horizonte (consulte https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

OBSERVAÇÃO: na maioria dos casos, há um único horário de pôr da lua por dia. Em outros casos, a lista pode estar vazia (por exemplo, quando a lua se põe após a meia-noite do dia seguinte). No entanto, em casos específicos (por exemplo, em regiões polares), a lista pode conter mais de um valor. Nesses casos, os valores são classificados em ordem crescente.

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".

WeatherCondition

Representação JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Campos
iconBaseUri

string

O URI de base do ícone, sem a extensão do tipo de arquivo. Para exibir o ícone, anexe um tema, se quiser, e a extensão do tipo de arquivo (.png ou .svg) a esse URI. Por padrão, o ícone tem um tema claro, mas _dark pode ser adicionado ao final para o modo escuro. Por exemplo: "https://maps.gstatic.com/weather/v1/dust.svg" ou "https://maps.gstatic.com/weather/v1/dust_dark.svg", em que icon_base_uri é "https://maps.gstatic.com/weather/v1/dust".
description

object (LocalizedText)

A descrição textual dessa condição climática (localizada).
type

enum (Type)

O tipo de condição climática.

LocalizedText

Representação JSON 
{
  "text": string,
  "languageCode": string
}
Campos
text

string

String localizada no idioma correspondente a google.type.LocalizedText.language_code abaixo.
languageCode

string

O código de idioma BCP-47 do texto, como "en-US" ou "sr-Latn".

Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Precipitação

Representação JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Campos
probability

object (PrecipitationProbability)

A probabilidade de precipitação (valores de 0 a 100).
snowQpf

object (QuantitativePrecipitationForecast)

A quantidade de neve, medida como equivalente de água líquida, que se acumulou durante um período. Observação: QPF é uma abreviação de Quantitative Precipitation Forecast (consulte a definição de QuantitativePrecipitationForecast para mais detalhes).
qpf

object (QuantitativePrecipitationForecast)

A quantidade de chuva, medida como equivalente de água líquida, que se acumulou durante um período. Observação: QPF é uma abreviação de Quantitative Precipitation Forecast (consulte a definição de QuantitativePrecipitationForecast para mais detalhes).

PrecipitationProbability

Representação JSON 
{
  "type": enum (Type),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
Campos
type

enum (Type)

Opcional. Um código que indica o tipo de precipitação.

Campo de união _percent.

_percent pode ser apenas de um dos tipos a seguir:
percent

integer

Uma porcentagem de 0 a 100 que indica as chances de precipitação.

QuantitativePrecipitationForecast

Representação JSON 
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
Campos
unit

enum (Unit)

O código da unidade usada para medir a quantidade de precipitação acumulada.

Campo de união _quantity.

_quantity pode ser apenas de um dos tipos a seguir:
quantity

number

A quantidade de precipitação, medida como equivalente de água líquida, que se acumulou durante um período.

Wind

Representação JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Campos
direction

object (WindDirection)

A direção do vento, o ângulo de onde ele vem.
speed

object (WindSpeed)

A velocidade do vento.
gust

object (WindSpeed)

A rajada de vento (aumento repentino na velocidade do vento).

WindDirection

Representação JSON 
{
  "cardinal": enum (Cardinal),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
Campos
cardinal

enum (Cardinal)

Opcional. O código que representa o ponto cardeal de onde o vento está soprando.

Campo de união _degrees.

_degrees pode ser apenas de um dos tipos a seguir:
degrees

integer

A direção do vento em graus (valores de 0 a 360).

WindSpeed

Representação JSON 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Campos
unit

enum (Unit)

Opcional. O código que representa a unidade usada para medir a velocidade do vento.

Campo de união _value.

_value pode ser apenas de um dos tipos a seguir:
value

number

O valor da velocidade do vento.

Local

Representação JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Campos
Campo de união location_type. Diferentes maneiras de representar um local. location_type pode ser apenas de um dos tipos a seguir:
latLng

object (LatLng)

Um ponto especificado usando coordenadas geográficas.
placeId

string

O ID de lugar associado ao local.
address

string

Endereço legível por humanos (por exemplo, rua, cidade ou código postal).

LatLng

Representação JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].
longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

Atribuição

Representação JSON 
{
  "title": string,
  "url": string
}
Campos
title

string

O título a ser exibido para a atribuição.
url

string

O URL para vincular à atribuição.

WeatherResultData

Representação JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _date_time can be only one of the following:
  "dateTime": string
  // End of list of possible types for union field _date_time.

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
Campos
weatherCondition

object (WeatherCondition)

A condição climática.
precipitation

object (Precipitation)

A probabilidade de precipitação e a quantidade de precipitação acumulada.
wind

object (Wind)

As condições do vento.
attribution

object (Attribution)

Atribuição obrigatória para mostrar com o clima.

Campo de união _date_time.

_date_time pode ser apenas de um dos tipos a seguir:
dateTime

string (Timestamp format)

O carimbo de data/hora da entrada de clima atual ou por hora.

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".

Campo de união _temperature.

_temperature pode ser apenas de um dos tipos a seguir:
temperature

object (Temperature)

A temperatura por hora.

Campo de união _feels_like_temperature.

_feels_like_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeTemperature

object (Temperature)

A medição por hora da sensação térmica.

Campo de união _heat_index.

_heat_index pode ser apenas de um dos tipos a seguir:
heatIndex

object (Temperature)

A temperatura do índice de calor por hora.

Campo de união _air_pressure.

_air_pressure pode ser apenas de um dos tipos a seguir:
airPressure

object (AirPressure)

As condições de pressão do ar por hora.

Campo de união _date.

_date pode ser apenas de um dos tipos a seguir:
date

object (Date)

Data do calendário civil da previsão do tempo diária.

Campo de união _max_temperature.

_max_temperature pode ser apenas de um dos tipos a seguir:
maxTemperature

object (Temperature)

A temperatura máxima (alta) ao longo do dia.

Campo de união _min_temperature.

_min_temperature pode ser apenas de um dos tipos a seguir:
minTemperature

object (Temperature)

A temperatura mínima (baixa) ao longo do dia.

Campo de união _feels_like_max_temperature.

_feels_like_max_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeMaxTemperature

object (Temperature)

A sensação térmica máxima (alta) ao longo do dia.

Campo de união _feels_like_min_temperature.

_feels_like_min_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeMinTemperature

object (Temperature)

A sensação térmica mínima (baixa) ao longo do dia.

Campo de união _max_heat_index.

_max_heat_index pode ser apenas de um dos tipos a seguir:
maxHeatIndex

object (Temperature)

A temperatura máxima do índice de calor ao longo do dia.

Campo de união _sun_events.

_sun_events pode ser apenas de um dos tipos a seguir:
sunEvents

object (SunEvents)

Os eventos relacionados ao sol (por exemplo, nascer e pôr do sol).

Campo de união _moon_events.

_moon_events pode ser apenas de um dos tipos a seguir:
moonEvents

object (MoonEvents)

Os eventos relacionados à lua (por exemplo, nascer e pôr da lua).

Campo de união _relative_humidity.

_relative_humidity pode ser apenas de um dos tipos a seguir:
relativeHumidity

integer

A porcentagem de umidade relativa (valores de 0 a 100).

Campo de união _uv_index.

_uv_index pode ser apenas de um dos tipos a seguir:
uvIndex

integer

O índice máximo de ultravioleta (UV).

Campo de união _thunderstorm_probability.

_thunderstorm_probability pode ser apenas de um dos tipos a seguir:
thunderstormProbability

integer

A probabilidade de tempestade (valores de 0 a 100).

Campo de união _cloud_cover.

_cloud_cover pode ser apenas de um dos tipos a seguir:
cloudCover

integer

A porcentagem do céu coberta por nuvens (valores de 0 a 100).

Data

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

AirQualityResultData

Representação JSON 
{
  "hourlyResults": [
    {
      object (AirQualityHourlyResult)
    }
  ],
  "attribution": {
    object (Attribution)
  }
}
Campos
hourlyResults[]

object (AirQualityHourlyResult)

Dados de qualidade do ar por hora para o horário solicitado (contém uma entrada para as condições atuais ou consultas de uma única hora, até 24 entradas para uma consulta de data passada ou futura ou as horas atuais + restantes quando a data é hoje).
attribution

object (Attribution)

Atribuição obrigatória para mostrar com os dados de qualidade do ar.

AirQualityHourlyResult

Representação JSON 
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
Campos
indexes[]

object (AirQualityIndex)

Índices de qualidade do ar (por exemplo, IQA universal e local).
pollutants[]

object (Pollutant)

Informações detalhadas sobre poluentes, preenchidas quando air_quality_options.include_pollutant_concentration é verdadeiro.
healthRecommendations

object (HealthRecommendations)

Recomendações de saúde para diferentes grupos populacionais.
dateTime

object (DateTime)

A data e a hora locais no fuso horário do local para essa entrada de qualidade do ar por hora (composta por year, month, day, hours, minutes, seconds e utc_offset).

AirQualityIndex

Representação JSON 
{
  "displayName": string,
  "valueDisplay": string,
  "category": string,
  "dominantPollutant": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Campos
displayName

string

O nome de exibição do índice (por exemplo, "IQA universal", "IQA da EPA dos EUA").
valueDisplay

string

Representação de string formatada do valor do IQA.
category

string

Categoria textual de qualidade do ar (por exemplo, "Qualidade do ar boa", "Qualidade do ar moderada").
dominantPollutant

string

O código do poluente dominante (por exemplo, "pm25", "o3").

Campo de união _value.

_value pode ser apenas de um dos tipos a seguir:
value

integer

Valor numérico do IQA.

Poluente

Representação JSON 
{
  "displayName": string,
  "fullName": string,
  "concentration": {
    object (Concentration)
  },
  "additionalInfo": {
    object (AdditionalInfo)
  }
}
Campos
displayName

string

Nome de exibição curto do poluente (por exemplo, "PM2.5", "O3").
fullName

string

Nome químico completo ou comum do poluente (por exemplo, "Partículas em suspensão finas (<2,5μm)", "Ozônio").
concentration

object (Concentration)

Concentração medida do poluente.
additionalInfo

object (AdditionalInfo)

Informações adicionais sobre as fontes do poluente e os efeitos dele na saúde.

Concentração

Representação JSON 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Campos
unit

enum (Unit)

Unidade de medida da concentração.

Campo de união _value.

_value pode ser apenas de um dos tipos a seguir:
value

number

Valor numérico da concentração.

AdditionalInfo

Representação JSON 
{
  "sources": string,
  "effects": string
}
Campos
sources

string

Principais fontes de emissão do poluente.
effects

string

Possíveis efeitos na saúde da exposição ao poluente.

HealthRecommendations

Representação JSON 
{
  "generalPopulation": string,
  "elderly": string,
  "lungDiseasePopulation": string,
  "heartDiseasePopulation": string,
  "athletes": string,
  "pregnantWomen": string,
  "children": string
}
Campos
generalPopulation

string

Orientações para a população geral.
elderly

string

Orientações para a população idosa.
lungDiseasePopulation

string

Orientações para pessoas com doenças pulmonares ou respiratórias.
heartDiseasePopulation

string

Orientações para pessoas com doenças cardiovasculares ou cardíacas.
athletes

string

Orientações para atletas e pessoas que praticam atividades ao ar livre.
pregnantWomen

string

Orientações para gestantes.
children

string

Orientação para crianças.

DateTime

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
Campos
year

integer

Opcional. Ano da data. Precisa ser de 1 a 9.999 ou 0 se for especificar uma data e hora sem ano.
month

integer

Opcional. Mês do ano. Precisa ser de 1 a 12, ou 0 se estiver especificando uma data e hora sem um mês.
day

integer

Opcional. Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 se for especificada uma data e hora sem um dia.
hours

integer

Opcional. Horas do dia no formato de 24 horas. Deve ser de 0 a 23, o padrão é 0 (meia-noite). Uma API pode permitir o valor "24:00:00" para o horário de fechamento da empresa, por exemplo.
minutes

integer

Opcional. Minutos da hora do dia. Precisa ser de 0 a 59. O padrão é 0.
seconds

integer

Opcional. Segundos do minutos do horário. Normalmente, precisa ser de 0 a 59, com o padrão 0. Uma API pode permitir o valor 60 se permitir segundos bissextos.
nanos

integer

Opcional. Frações de segundos em nanossegundos. Precisa ser de 0 a 999.999.999. O padrão é 0.
Campo de união time_offset. Opcional. Especifica o deslocamento UTC ou o fuso horário do DateTime. Escolha com cuidado, considerando que os dados de fuso horário podem mudar no futuro (por exemplo, um país modifica as datas de início/término do horário de verão, e os DateTimes futuros no intervalo afetado já foram armazenados). Se omitido, o DateTime será considerado no horário local. time_offset pode ser apenas de um dos tipos a seguir:
utcOffset

string (Duration format)

Deslocamento de UTC. Precisa ser em segundos inteiros, entre -18 horas e +18 horas. Por exemplo, um deslocamento UTC de -4:00 seria representado como { seconds: -14400 }.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
timeZone

object (TimeZone)

Fuso horário.

Duração

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Segundos assinados do período. Precisa ser de -315.576.000.000 a +315.576.000.000, inclusive. Observação: esses limites são calculados da seguinte forma: 60 s/min * 60 min/h * 24 h/dia * 365,25 dias/ano * 10.000 anos
nanos

integer

Frações assinadas de um segundo com resolução de nanossegundos do período. As durações menores que um segundo são representadas com um campo seconds de 0 e um campo nanos positivo ou negativo. Para durações de um segundo ou mais, um valor diferente de zero para o campo nanos precisa ter o mesmo sinal que o campo seconds. O valor precisa ser de -999.999.999 a +999.999.999.

TimeZone

Representação JSON 
{
  "id": string,
  "version": string
}
Campos
id

string

Fuso horário do banco de dados de fusos horários da IANA. Por exemplo, "America/New_York".
version

string

Opcional. Número da versão do banco de dados de fuso horário da IANA. Por exemplo, "2019a".

PollenResultData

Representação JSON 
{
  "dailyForecast": {
    object (DailyPollenForecast)
  },
  "attribution": {
    object (Attribution)
  }
}
Campos
dailyForecast

object (DailyPollenForecast)

Previsão diária de pólen para a data solicitada.
attribution

object (Attribution)

Atribuição obrigatória para mostrar com os dados de pólen.

DailyPollenForecast

Representação JSON 
{
  "date": {
    object (Date)
  },
  "categories": [
    {
      object (PollenCategoryInfo)
    }
  ],
  "plantSpecies": [
    {
      object (PlantSpeciesInfo)
    }
  ]
}
Campos
date

object (Date)

Data do calendário civil da previsão.
categories[]

object (PollenCategoryInfo)

Detalhamento amplo das categorias de pólen (árvores, gramíneas, ervas daninhas).
plantSpecies[]

object (PlantSpeciesInfo)

Detalhamento granular de espécies de plantas.

PollenCategoryInfo

Representação JSON 
{
  "displayName": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "healthRecommendations": [
    string
  ]
}
Campos
displayName

string

Nome de exibição da categoria (por exemplo, "Árvore", "Grama", "Erva daninha").
inSeason

boolean

Se essa categoria de pólen está florescendo ativamente na região.
index

object (PollenIndex)

Medição do Índice Universal de Pólen (UPI, na sigla em inglês) para essa categoria.
healthRecommendations[]

string

Conselhos de saúde práticos para grupos sensíveis ao pólen.

PollenIndex

Representação JSON 
{
  "category": string,
  "description": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Campos
category

string

Classificação localizada da categoria (por exemplo, "Nenhuma", "Muito baixa", "Baixa", "Moderada", "Alta", "Muito alta").
description

string

Descrição do nível de risco de pólen.

Campo de união _value.

_value pode ser apenas de um dos tipos a seguir:
value

integer

Valor numérico do UPI (escala de 0 a 5).

PlantSpeciesInfo

Representação JSON 
{
  "code": string,
  "displayName": string,
  "family": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "season": string,
  "crossReactions": string
}
Campos
code

string

Código de espécie legível por máquina (por exemplo, "BIRCH", "JAPANESE_CEDAR", "RAGWEED").
displayName

string

Nome de exibição localizado da espécie de planta (por exemplo, "Bétula").
family

string

Nome da família botânica (por exemplo, "Betulaceae (família da bétula)").
inSeason

boolean

Se esta espécie de planta está para esta temporada.
index

object (PollenIndex)

Medição do Índice Universal de Pólen (UPI, na sigla em inglês) para essa espécie.
season

string

Descrição da estação de floração típica (por exemplo, "Fim do inverno, primavera").
crossReactions

string

Alérgenos de reação cruzada conhecidos (por exemplo, "pólen de almieiro, aveleira, faia e carvalho").

Unidade

Representa uma unidade usada para medir temperaturas.

Tipos enumerados
UNIT_UNSPECIFIED A unidade de temperatura não foi especificada.
CELSIUS A temperatura é medida em Celsius.
FAHRENHEIT A temperatura é medida em Fahrenheit.

Fase

Marca a fase da lua.

Tipos enumerados
PHASE_UNSPECIFIED Fase da lua não especificada.
NEW_MOON A lua não é iluminada pelo sol.
WAXING_CRESCENT A lua é iluminada de 0% a 50% no lado direito no hemisfério norte 🌒 e no lado esquerdo no hemisfério sul 🌘.
FIRST_QUARTER A lua está 50,1% iluminada no lado direito no hemisfério norte 🌓 e no lado esquerdo no hemisfério sul 🌗.
WAXING_GIBBOUS A lua está iluminada de 50% a 100% no lado direito no hemisfério norte 🌔 e no lado esquerdo no hemisfério sul 🌖.
FULL_MOON A lua está totalmente iluminada.
WANING_GIBBOUS A lua está iluminada de 50% a 100% no lado esquerdo no hemisfério norte 🌖 e no lado direito no hemisfério sul 🌔.
LAST_QUARTER A lua está 50,1% iluminada no lado esquerdo no hemisfério norte 🌗 e no lado direito no hemisfério sul 🌓.
WANING_CRESCENT A lua está iluminada de 0% a 50% no lado esquerdo no hemisfério norte 🌘 e no lado direito no hemisfério sul 🌒.

Tipo

Marca o tipo de condição climática no contexto de um elemento de previsão.

Observação: as condições com valores de 42 a 139 são retornadas apenas para locais no Japão e na Coreia.

Tipos enumerados
TYPE_UNSPECIFIED A condição climática não foi especificada.
CLEAR Sem nuvens.
MOSTLY_CLEAR Períodos nublados.
PARTLY_CLOUDY Parcialmente nublado (algumas nuvens).
MOSTLY_CLOUDY Predominantemente nublado (mais nuvens do que sol).
CLOUDY Nublado (apenas nuvens, sem sol).
WINDY Vento forte.
WIND_AND_RAIN Vento forte com precipitação.
LIGHT_RAIN_SHOWERS Chuva fraca intermitente.
CHANCE_OF_SHOWERS Chance de chuva intermitente.
SCATTERED_SHOWERS Chuva intermitente.
RAIN_SHOWERS As pancadas de chuva são consideradas precipitações de menor duração do que a chuva e são caracterizadas por início e fim repentinos, além de mudanças rápidas de intensidade.
HEAVY_RAIN_SHOWERS Pancadas intensas de chuva.
LIGHT_TO_MODERATE_RAIN Chuva (quantidade fraca a moderada).
MODERATE_TO_HEAVY_RAIN Chuva (moderada a intensa).
RAIN Chuva moderada.
LIGHT_RAIN Chuva fraca.
HEAVY_RAIN Chuva intensa.
RAIN_PERIODICALLY_HEAVY Chuva, com períodos mais fortes.
LIGHT_SNOW_SHOWERS Neve fraca que cai em intensidades variadas por breves períodos.
CHANCE_OF_SNOW_SHOWERS Possibilidade de pancadas de neve.
SCATTERED_SNOW_SHOWERS Neve que cai com intensidades variadas por breves períodos.
SNOW_SHOWERS Pancadas de neve.
HEAVY_SNOW_SHOWERS Pancadas intensas de neve.
LIGHT_TO_MODERATE_SNOW Neve fraca a moderada.
MODERATE_TO_HEAVY_SNOW Neve moderada a intensa.
SNOW Neve moderada.
LIGHT_SNOW Neve fraca.
HEAVY_SNOW Neve intensa.
SNOWSTORM Neve com possibilidade de trovões e relâmpagos.
SNOW_PERIODICALLY_HEAVY Neve, com períodos mais intensos.
HEAVY_SNOW_STORM Neve intensa com possíveis trovões e relâmpagos.
BLOWING_SNOW Neve com vento intenso.
RAIN_AND_SNOW Mistura de chuva e neve.
HAIL Granizo.
HAIL_SHOWERS Granizo que cai com intensidades variadas por breves períodos.
THUNDERSTORM Tempestade.
THUNDERSHOWER Uma chuva acompanhada de trovões e relâmpagos.
LIGHT_THUNDERSTORM_RAIN Chuva com trovadas leves.
SCATTERED_THUNDERSTORMS Tempestades com chuva de várias intensidades por breves períodos.
HEAVY_THUNDERSTORM Tempestade intensa.
CLEAR_AFTER_FOG_IN_THE_MORNING Céu claro após neblina pela manhã.
CLEAR_BUT_LATER_TURNING_CLOUDY Céu limpo seguido de tempo nublado.
CLEAR_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Céu limpo seguido de neve e chuva, com predomínio de chuva.
CLEAR_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Céu limpo seguido de neve e chuva, com predomínio de neve.
CLEAR_BUT_THUNDERSTORMS_LATER Céu claro, mas seguido de tempestades.
CLEAR_IN_THE_MORNING_BUT_CLOUDY_IN_THE_EVENING Céu claro pela manhã, mas nublado no início da noite.
CLEAR_IN_THE_MORNING_WITH_BRIEF_RAIN_IN_THE_EVENING Céu claro pela manhã com breves períodos de chuva no início da noite.
CLEAR_MORNING_WITH_BRIEF_RAIN Céu limpo ao amanhecer com breves períodos de chuva.
CLEAR_WITH_BRIEF_RAIN Céu claro com breves períodos de chuva.
CLEAR_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Céu limpo com breves períodos de neve e chuva, mas predomínio de chuva.
CLEAR_WITH_BRIEF_RAIN_LATER Céu limpo seguido de breves períodos de chuva.
CLEAR_WITH_BRIEF_SNOW Céu limpo com breves períodos de neve.
CLEAR_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Céu limpo com breves períodos de neve e chuva, mas predomínio de neve.
CLEAR_WITH_BRIEF_SNOW_LATER Céu limpo seguido de breves períodos de neve.
CLEAR_WITH_PERIODIC_CLOUDS_LATER Céu limpo seguido de períodos nublados.
CLEAR_WITH_PERIODIC_RAIN Céu claro com períodos de chuva.
CLEAR_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Céu limpo com períodos de chuva acompanhada de trovoadas.
CLEAR_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Céu limpo com períodos de neve e chuva, mas predomínio de chuva.
CLEAR_WITH_PERIODIC_RAIN_LATER Céu limpo seguido de períodos de chuva.
CLEAR_WITH_PERIODIC_SNOW Céu limpo com períodos de neve.
CLEAR_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Céu limpo com períodos de neve e chuva, mas predomínio de neve.
CLEAR_WITH_PERIODIC_SNOW_LATER Céu limpo seguido de períodos de neve.
CLEAR_WITH_RAIN_AFTER_MIDNIGHT Céu limpo com chuva após a meia-noite.
CLEAR_WITH_RAIN_IN_THE_NIGHT Céu limpo com chuva à noite.
CLEAR_WITH_RAIN_LATER Céu limpo seguido de chuva.
CLEAR_WITH_SNOW_ALONG_THE_MOUNTAINS Céu claro com neve ao longo das montanhas.
CLEAR_WITH_SNOW_LATER Céu claro seguido de neve.
CLEAR_WITH_THUNDERSTORMS_ALONG_THE_MOUNTAINS Céu limpo com tempestades nas montanhas.
CLEAR_WITH_THUNDERSTORMS_IN_THE_AFTERNOON Céu claro com tempestades à tarde.
CLOUDY_BUT_CLEAR_LATER Céu nublado seguido de tempo aberto.
CLOUDY_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Céu nublado seguido de neve e chuva, com predomínio de chuva.
CLOUDY_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Céu nublado seguido de neve e chuva, com predomínio de neve.
CLOUDY_BUT_PERIODICALLY_CLEAR_LATER Céu nublado seguido de períodos de abertura.
CLOUDY_BUT_THUNDERSTORMS_LATER Céu nublado seguido de tempestades.
CLOUDY_MORNING_WITH_BRIEF_RAIN Céu nublado pela manhã com breves períodos de chuva.
CLOUDY_PERIODICALLY_CLEAR Céu nublado com períodos de abertura.
CLOUDY_SNOWING_IN_THE_EVENING Céu nublado com neve no início da noite.
CLOUDY_SNOWING_IN_THE_NIGHT Céu nublado com neve à noite.
CLOUDY_WITH_BRIEF_RAIN Céu nublado com breves períodos de chuva.
CLOUDY_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Céu nublado com breves períodos de neve e chuva, mas predomínio de chuva.
CLOUDY_WITH_BRIEF_RAIN_LATER Céu nublado seguido de breves períodos de chuva.
CLOUDY_WITH_BRIEF_SNOW Céu nublado com breves períodos de neve.
CLOUDY_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Céu nublado com breves períodos de neve e chuva, mas predomínio de neve.
CLOUDY_WITH_BRIEF_SNOW_LATER Céu nublado seguido de breves períodos de neve.
CLOUDY_WITH_BRIEF_THUNDERSTORM Nublado com breves períodos de tempestade.
CLOUDY_WITH_FOG_ON_THE_OCEAN_AND_AT_THE_SEASHORE Céu nublado com neblina no oceano e na costa.
CLOUDY_WITH_PERIODIC_RAIN Nublado com períodos de chuva.
CLOUDY_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Céu nublado com períodos de chuva acompanhada de trovoadas.
CLOUDY_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Céu nublado com períodos de neve e chuva, mas predomínio de chuva.
CLOUDY_WITH_PERIODIC_RAIN_LATER Céu nublado seguido de períodos de chuva.
CLOUDY_WITH_PERIODIC_SNOW Céu nublado com períodos de neve.
CLOUDY_WITH_PERIODIC_SNOW_ACCOMPANIED_BY_THUNDER Nublado com períodos de neve acompanhada de trovoadas.
CLOUDY_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Céu nublado com períodos de neve e chuva, mas predomínio de neve.
CLOUDY_WITH_PERIODIC_SNOW_LATER Nublado com períodos de neve.
CLOUDY_WITH_RAIN_AFTER_MIDNIGHT Céu nublado com chuva após a meia-noite.
CLOUDY_WITH_RAIN_FROM_ABOUT_NOON Céu nublado com chuva por volta do meio-dia.
CLOUDY_WITH_RAIN_FROM_EVENING Nublado com chuva a partir do anoitecer.
CLOUDY_WITH_RAIN_LATER Nublado com chuva.
CLOUDY_WITH_SNOW_FROM_AROUND_NOON Céu nublado com neve por volta do meio-dia.
CLOUDY_WITH_SNOW_LATER Céu nublado seguido de neve.
FOG Neblina.
RAINSNOW_MIX_LATER_BECOMING_CLEAR_RAIN_AS_MAIN Mistura de chuva e neve, com predomínio de chuva, seguida de céu limpo.
RAINSNOW_MIX_RAIN_AS_MAIN Mistura de chuva e neve, com predomínio de chuva.
RAINY_BUT_PERIODICALLY_CLEAR Chuva, com períodos de abertura.
RAIN_ACCOMPANIED_BY_LIGHTNING Chuva acompanhada de relâmpagos.
RAIN_ACCOMPANIED_BY_WINDSTORM Chuva acompanhada de ventania.
RAIN_CLEAR_AT_NIGHT Chuva, mas céu limpo à noite.
RAIN_CLEAR_FROM_AROUND_EVENING Chuva, mas céu limpo no início da noite.
RAIN_CLEAR_FROM_AROUND_NOON Chuva, mas céu limpo por volta do meio-dia.
RAIN_LATER_BECOMING_CLEAR Chuva seguida de céu limpo.
RAIN_LATER_BECOMING_CLOUDY Chuva seguida de céu nublado.
RAIN_LATER_BECOMING_SNOW Chuva seguida de neve.
RAIN_LATER_WITH_PERIODIC_SNOW Chuva seguida de períodos de neve.
RAIN_SNOW_AT_NIGHT Chuva e neve à noite.
RAIN_SNOW_IN_THE_EVENING Chuva e neve no início da noite.
RAIN_TEMPORARILY_BECOMING_SLEET Chuva temporariamente seguida de granizo.
RAIN_THAT_PERIODICALLY_STOPS Chuva em intervalos.
RAIN_WITH_BRIEF_SNOW Chuva com breves períodos de neve.
RAIN_WITH_PERIODIC_SNOW Chuva com períodos de neve.
SNOWRAIN_MIX_LATER_BECOMING_CLEAR_SNOW_AS_MAIN Mistura de neve e chuva, com predomínio de neve, seguida de céu limpo.
SNOWRAIN_MIX_LATER_BECOMING_CLOUDY_SNOW_AS_MAIN Mistura de neve e chuva, com predomínio de neve, seguida de céu nublado.
SNOWRAIN_MIX_SNOW_AS_MAIN Mistura de neve e chuva, com predomínio de neve.
SNOW_ACCOMPANIED_BY_LIGHTNING Neve acompanhada de relâmpagos.
SNOW_BECOMING_SLEET Neve seguida de granizo.
SNOW_LATER_CLEAR Neve seguida de céu limpo.
SNOW_LATER_CLOUDY Neve seguida de céu nublado.
SNOW_LATER_RAIN Neve seguida de chuva.
SNOW_PERIODICALLY_CLEAR Neve com períodos de céu aberto.
SNOW_THAT_PERIODICALLY_STOPS Neve com períodos de interrupção.
SNOW_TURNING_TO_RAIN_AROUND_NOON Neve seguida de chuva por volta do meio-dia.
SNOW_TURNING_TO_RAIN_IN_THE_EVENING Neve seguida de chuva no início da noite.
SNOW_TURNING_TO_RAIN_IN_THE_NIGHT Neve seguida de chuva à noite.
SNOW_WITH_BRIEF_RAIN Neve com breves períodos de chuva.
SNOW_WITH_BRIEF_SLEET Neve com breves períodos de granizo.
SNOW_WITH_PERIODIC_RAIN Neve com períodos de chuva.
VERY_HOT Muito quente.
SLEET Chuva congelada.
HEAVY_RAIN_TO_RAINSTORM Chuva forte a tempestade.

Tipo

Representa o tipo de precipitação em um determinado local.

Tipos enumerados
TYPE_UNSPECIFIED Tipo de precipitação não especificado.
NONE Sem precipitação.
SNOW Precipitação de neve.
RAIN Precipitação de chuva.
LIGHT_RAIN Precipitação de chuva leve.
HEAVY_RAIN Precipitação de chuva intensa.
RAIN_AND_SNOW Precipitações de chuva e neve.
SLEET Precipitação de granizo.
FREEZING_RAIN Precipitação de chuva congelante.
PRECIPITATION_TYPE_HAIL Precipitação de granizo.

Unidade

Representa a unidade usada para medir a quantidade de precipitação acumulada.

Tipos enumerados
UNIT_UNSPECIFIED Unidade de precipitação não especificada.
MILLIMETERS A quantidade de precipitação é medida em milímetros.
INCHES A quantidade de precipitação é medida em polegadas.

Cardinal

Representa uma direção cardinal (incluindo direções ordinais).

Tipos enumerados
CARDINAL_UNSPECIFIED A direção cardinal não foi especificada.
NORTH A direção cardeal norte.
NORTH_NORTHEAST A direção intercardinal secundária norte-nordeste.
NORTHEAST A direção intercardinal nordeste.
EAST_NORTHEAST A direção intercardinal secundária leste-nordeste.
EAST A direção leste.
EAST_SOUTHEAST A direção intercardinal secundária leste-sudeste.
SOUTHEAST A direção intercardinal sudeste.
SOUTH_SOUTHEAST A direção intercardinal secundária sul-sudeste.
SOUTH A direção cardeal sul.
SOUTH_SOUTHWEST A direção intercardinal secundária sul-sudoeste.
SOUTHWEST A direção intercardinal sudoeste.
WEST_SOUTHWEST A direção intercardinal secundária oeste-sudoeste.
WEST O ponto cardeal oeste.
WEST_NORTHWEST A direção intercardinal secundária oeste-noroeste.
NORTHWEST A direção intercardinal noroeste.
NORTH_NORTHWEST A direção intercardinal secundária norte-noroeste.

Unidade

Representa a unidade usada para medir a velocidade.

Tipos enumerados
UNIT_UNSPECIFIED A unidade de velocidade não foi especificada.
KILOMETERS_PER_HOUR A velocidade é medida em quilômetros por hora.
MILES_PER_HOUR A velocidade é medida em milhas por hora.

Unidade

Unidades usadas para medir a concentração de poluentes.

Tipos enumerados
UNIT_UNSPECIFIED Unidade de concentração não especificada.
PARTS_PER_BILLION Partes por bilhão (ppb).
MICROGRAMS_PER_CUBIC_METER Microgramas por metro cúbico (µg/m³).

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando uma solicitação de confirmação pode ser enviada a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas:

  • readOnlyHint: se for verdadeiro, a ferramenta não vai modificar o ambiente. (Padrão: falso).
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. (Padrão: falso).
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ✅ | Dica de jogos de mundo aberto: ❌