Method: lookupWeather

Bir konumdaki hava durumu koşullarını arama

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

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

enum (UnitsSystem)

İsteğe bağlı. Döndürülen hava durumu koşulları için kullanılacak birim sistemi. Belirtilmezse döndürülen hava durumu koşulları metrik sistemde olur (varsayılan = METRİK).

location

object (Location)

Zorunlu. Hava durumu bilgilerinin alınacağı konum.

capabilities[]

enum (Capability)

İsteğe bağlı. Yanıta dahil edilecek çevresel özellikler.

date

object (Date)

İsteğe bağlı. İstenen çevre bilgilerinin tarihini, location alanında belirtilen konumun yerel saat dilimine göre belirtir. Desteklenen tarih aralıkları, istenen özelliklere bağlıdır: - WEATHER: geçmişte 24 saate kadar (hour de ayarlandığında) ve gelecekte 10 güne (240 saat) kadar (günlük tahminler için bugünden +9 güne kadar). - AIR_QUALITY: Geçmişte 30 güne (720 saat) ve gelecekte 4 güne (96 saat) kadar. - POLLEN: bugünden itibaren +4 gün (bugün dahil en fazla 5 gün; geçmiş tarihler desteklenmez).

hour

integer

İsteğe bağlı. İstenen çevre bilgilerinin saatini, location alanında belirtilen konumun yerel saat dilimine göre 24 saat biçiminde (0-23) belirtir. date değerinin belirtilmesi gerekir. Desteklenen saat aralıkları, istenen özelliklere bağlıdır: - WEATHER: Geçmişte 24 saate kadar ve gelecekte 240 saate (10 gün) kadar. - AIR_QUALITY: Geçmişte 30 güne (720 saat) ve gelecekte 4 güne (96 saat) kadar. - POLLEN: Yalnızca günlük tahminleri döndürür. Polen için hour yoksayılır.

languageCode

string

İsteğe bağlı. Yanıttaki yerelleştirilmiş metnin BCP-47 dil kodu (ör. "en", "ja", "fr-CA"). Belirtilmezse varsayılan olarak "en" kullanılır.

weatherOptions

object (WeatherOptions)

İsteğe bağlı. Hava durumu isteklerine özel seçenekler. weatherOptions.units_system, mevcut arayanlar için geriye dönük uyumluluğu korumak amacıyla üst düzey unitsSystem (etiket 4) ile birlikte desteklenir. Her ikisi de çelişen birim sistemleri belirtirse INVALID_ARGUMENT döndürülür. capabilities içinde WEATHER istenmezse yoksayılır.

airQualityOptions

object (AirQualityOptions)

İsteğe bağlı. Hava kalitesi isteklerine özel seçenekler. capabilities içinde AIR_QUALITY istenmezse yoksayılır.

Yanıt metni

Başarılıysa yanıt metni, LookupWeatherResponse öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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