Method: lookupWeather

Nach dem Wetter an einem Ort suchen

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

enum (UnitsSystem)

Optional. Das Einheitensystem, das für die zurückgegebenen Wetterbedingungen verwendet werden soll. Wenn nicht angegeben, werden die zurückgegebenen Wetterbedingungen im metrischen System angegeben (Standard = METRIC).
location

object (Location)

Erforderlich. Der Ort, für den die Wetterbedingungen abgerufen werden sollen.
capabilities[]

enum (Capability)

Optional. Die Umgebungsfunktionen, die in der Antwort enthalten sein sollen.
date

object (Date)

Optional. Gibt das Datum der angeforderten Umweltinformationen relativ zur lokalen Zeitzone des im Feld location angegebenen Standorts an. Die unterstützten Zeiträume hängen von den angeforderten Funktionen ab: - WEATHER: bis zu 24 Stunden in der Vergangenheit (wenn hour ebenfalls festgelegt ist) und bis zu 10 Tage (240 Stunden) in der Zukunft (heute bis +9 Tage für tägliche Vorhersagen). - AIR_QUALITY: bis zu 30 Tage (720 Stunden) in der Vergangenheit und bis zu 4 Tage (96 Stunden) in der Zukunft. - POLLEN: heute bis +4 Tage (bis zu 5 Tage einschließlich heute; historische Daten werden nicht unterstützt).
hour

integer

Optional. Gibt die Stunde der angeforderten Umweltinformationen im 24-Stunden-Format (0–23) relativ zur lokalen Zeitzone des im Feld location angegebenen Standorts an. Erfordert die Angabe von date. Die unterstützten stündlichen Bereiche hängen von den angeforderten Funktionen ab: - WEATHER: bis zu 24 Stunden in der Vergangenheit und bis zu 240 Stunden (10 Tage) in der Zukunft. - AIR_QUALITY: bis zu 30 Tage (720 Stunden) in der Vergangenheit und bis zu 4 Tage (96 Stunden) in der Zukunft. - POLLEN: Gibt nur tägliche Vorhersagen zurück. hour wird für Pollen ignoriert.
languageCode

string

Optional. Der BCP-47-Sprachcode für lokalisierten Text in der Antwort (z.B. „en“, „ja“, „fr-CA“). Wenn keine Angabe erfolgt, ist die Standardeinstellung „en“.
weatherOptions

object (WeatherOptions)

Optional. Optionen speziell für Wetteranfragen. weatherOptions.units_system wird zusammen mit unitsSystem (Tag 4) auf oberster Ebene unterstützt, um die Abwärtskompatibilität für vorhandene Aufrufer zu gewährleisten. Gibt INVALID_ARGUMENT zurück, wenn beide widersprüchliche Einheitensysteme angeben. Wird ignoriert, wenn WEATHER nicht in capabilities angefordert wird.
airQualityOptions

object (AirQualityOptions)

Optional. Spezifische Optionen für Luftqualitätsanfragen. Wird ignoriert, wenn AIR_QUALITY nicht in capabilities angefordert wird.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von LookupWeatherResponse.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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