- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- CurrentConditionsHistory
Belirli bir konumdaki mevcut hava koşullarını 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ır. 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ıdır. İstemcinin yanıtın dilini seçmesine olanak tanır. Bu 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 durumu koşullarını gösterir.
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 mevcut 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 çiy noktası sıcaklığı. |
heatIndex |
Mevcut ısı endeksi sıcaklığı. |
windChill |
Mevcut rüzgar soğuğu, deriye maruz kalan hava sıcaklığı. |
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. |
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) ile gün batımı (hariç) saatleri arasındaysa doğru değerini döndürür. Aksi takdirde gece (güneşin batışı ile bir sonraki güneşin doğuşu arasında) olur. |
relativeHumidity |
Bağıl nemin mevcut 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). |
cloudCover |
Gökyüzünün bulutlarla kaplı olduğu mevcut yüzde (0-100 arasındaki değerler). |
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 gösterir.
| JSON gösterimi |
|---|
{ "temperatureChange": { object ( |
| Alanlar | |
|---|---|
temperatureChange |
Mevcut sıcaklık ile 24 saat önceki sıcaklık arasındaki fark. |
maxTemperature |
Son 24 saatteki maksimum (yüksek) sıcaklık. |
minTemperature |
Son 24 saatteki minimum (düşük) sıcaklık. |
snowQpf |
Son 24 saat içinde biriken kar miktarı (sıvı su eşdeğeri olarak ölçülür). Not: QPF, Yağış Sayısal Tahmini'nin kısaltmasıdır (daha fazla bilgi için lütfen QuantitativePrecipitationForecast tanımına bakın). |
qpf |
Son 24 saat içinde biriken yağış miktarının sıvı su eşdeğeri olarak ölçülen değeri. Not: QPF, Yağış Sayısal Tahmini'nin kısaltmasıdır (daha fazla bilgi için lütfen QuantitativePrecipitationForecast tanımına bakın). |