- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- CurrentConditionsHistory
- Deneyin.
Belirli bir konumdaki mevcut hava durumunu döndürür.
HTTP isteği
GET https://weather.googleapis.com/v1/currentConditions:lookup
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler | |
|---|---|
location |
Zorunlu. Mevcut hava durumu koşullarının alınacağı konum. |
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 = METRIC). |
languageCode |
İsteğe bağlı. İstemcinin yanıt dilini seçmesine olanak tanır. Söz konusu dil için veri sağlanamıyorsa API en yakın eşleşmeyi kullanır. İzin verilen değerler, IETF BCP-47 standardına dayanır. Varsayılan değer "en"dir. |
İstek metni
İstek metni boş olmalıdır.
Yanıt metni
currentConditions.lookup RPC'si için yanıt: İstenen konumdaki mevcut hava koşullarını temsil eder.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
|---|
{ "currentTime": string, "timeZone": { object ( |
| Alanlar | |
|---|---|
currentTime |
Döndürülen verilerle ilişkili geçerli saat (UTC). Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
timeZone |
İstenen konumdaki saat dilimi. |
weatherCondition |
Mevcut hava durumu. |
temperature |
Mevcut sıcaklık. |
feelsLikeTemperature |
İstenen konumda sıcaklığın şu anda nasıl hissedildiğinin ölçüsü. |
dewPoint |
Mevcut çiğlenme noktası sıcaklığı. |
heatIndex |
Mevcut ısı endeksi sıcaklığı. |
windChill |
Mevcut rüzgar soğutması, cildin maruz kaldığı hava sıcaklığı. Not: Bu alan, Japonya ve Güney Kore'deki konumlar için boş bir nesne döndürür. |
precipitation |
Mevcut yağış olasılığı ve son bir saatte biriken yağış miktarı. |
airPressure |
Mevcut hava basıncı koşulları. |
wind |
Mevcut rüzgar koşulları. |
visibility |
Mevcut görünürlük. Not: Bu alan, Japonya ve Güney Kore'deki konumlar için boş bir nesne döndürür. |
currentConditionsHistory |
Son 24 saat içinde mevcut koşullarda meydana gelen değişiklikler. |
isDaytime |
İstenen konumdaki geçerli saat, yerel gün doğumu (dahil) ve gün batımı (hariç) saatleri arasındaysa True (Doğru) değerini döndürür. Aksi takdirde gece (gün batımı ile bir sonraki gün doğumu arasında) olur. |
relativeHumidity |
Mevcut bağıl nem yüzdesi (0 ile 100 arasındaki değerler). |
uvIndex |
Mevcut ultraviyole (UV) indeksi. |
thunderstormProbability |
Mevcut gök gürültülü fırtına olasılığı (0 ile 100 arasındaki değerler). Not: Bu alan, Japonya ve Güney Kore'deki konumlar için yanıttan çıkarılır. |
cloudCover |
Gökyüzünün bulutlarla kaplı olan mevcut yüzdesi (0 ile 100 arasındaki değerler). Not: Bu alan, Japonya ve Güney Kore'deki konumlar için yanıttan çıkarılır. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
CurrentConditionsHistory
Son 24 saat içinde mevcut koşullarda yapılan bir dizi değişikliği temsil eder.
| JSON gösterimi |
|---|
{ "temperatureChange": { object ( |
| Alanlar | |
|---|---|
temperatureChange |
Mevcut sıcaklıktan 24 saat önceki sıcaklığın çıkarılmasıyla elde edilen değer. |
maxTemperature |
Son 24 saatteki maksimum (yüksek) sıcaklık. |
minTemperature |
Son 24 saatteki minimum (en düşük) sıcaklık. |
snowQpf |
Erime veya sıkışma olmadığı varsayılarak belirli bir süre içinde yağacağı tahmin edilen kar miktarı. Not: Bu, sıvı su eşdeğeri değil, gerçek kar miktarıdır. QPF, Nicel Yağış Tahmini'nin kısaltmasıdır (daha fazla bilgi için lütfen QuantitativePrecipitationForecast tanımına bakın). |
qpf |
Belirli bir süre boyunca yağması tahmin edilen tüm yağışların (yağmur, kar, buz vb.) toplam sıvı su eşdeğeri. Not: QPF, Nicel Yağış Tahmini'nin kısaltmasıdır (daha fazla bilgi için lütfen QuantitativePrecipitationForecast tanımına bakın). |