Method: lookupWeather

wyszukiwać informacje o pogodzie w danej lokalizacji,

Żądanie HTTP

POST https://mapstools.googleapis.com/v1:lookupWeather

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
Pola
unitsSystem

enum (UnitsSystem)

Opcjonalnie. System jednostek, który ma być używany w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tego parametru, warunki pogodowe będą podawane w systemie metrycznym (wartość domyślna = METRIC).
location

object (Location)

Wymagane. Lokalizacja, dla której chcesz sprawdzić warunki pogodowe.
capabilities[]

enum (Capability)

Opcjonalnie. Możliwości środowiskowe, które mają być uwzględnione w odpowiedzi.
date

object (Date)

Opcjonalnie. Określa datę żądanych informacji o środowisku, względem lokalnej strefy czasowej lokalizacji określonej w polu location. Obsługiwane zakresy dat zależą od żądanych funkcji: – WEATHER: do 24 godzin wstecz (gdy ustawiono również hour) i do 10 dni (240 godzin) w przyszłość (od dziś do +9 dni w przypadku prognoz dziennych). - AIR_QUALITY: do 30 dni (720 godzin) wstecz i do 4 dni (96 godzin) do przodu. - POLLEN: od dziś do 4 dni do przodu (maksymalnie 5 dni, wliczając dzisiejszy; daty historyczne nie są obsługiwane).
hour

integer

Opcjonalnie. Określa godzinę, dla której mają zostać podane informacje o środowisku, w formacie 24-godzinnym (0–23) w lokalnej strefie czasowej lokalizacji określonej w polu location. Wymaga określenia parametru date. Obsługiwane zakresy godzinowe zależą od żądanych możliwości: - WEATHER: do 24 godzin w przeszłości i do 240 godzin (10 dni) w przyszłości. - AIR_QUALITY: do 30 dni (720 godzin) wstecz i do 4 dni (96 godzin) do przodu. - POLLEN: zwraca tylko prognozy dzienne; parametr hour jest ignorowany w przypadku pyłków.
languageCode

string

Opcjonalnie. Kod języka w standardzie BCP-47 dla zlokalizowanego tekstu w odpowiedzi (np. „en”, „ja”, „fr-CA”). Jeśli nie zostanie podany, domyślnie przyjmuje się „en”.
weatherOptions

object (WeatherOptions)

Opcjonalnie. Opcje dotyczące zapytań o pogodę. weatherOptions.units_system jest obsługiwany w połączeniu z unitsSystem najwyższego poziomu (tag 4), aby zachować zgodność wsteczną z istniejącymi elementami wywołującymi. Jeśli oba te elementy określają sprzeczne systemy jednostek, zwracany jest błąd INVALID_ARGUMENT. Ignorowane, jeśli nie zażądano WEATHER w capabilities.
airQualityOptions

object (AirQualityOptions)

Opcjonalnie. Opcje dotyczące żądań związanych z jakością powietrza. Ignorowane, jeśli nie zażądano AIR_QUALITY w capabilities.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu LookupWeatherResponse.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools