İzledikleriniz

history uç noktası, belirli bir konum için geçmiş saatlik hava kalitesi bilgileri zaman aralığı (en fazla 30 gün). Hangi HKİ'lerin ve alakalı bilgiler (ör. kirliliğe yol açan maddelerin konsantrasyon seviyesi ve sağlık önerileri alın.

Saatlik hava kalitesi geçmişini şu ayarı kullanarak isteyebilirsiniz: history uç noktası için şu adrese bir HTTP POST isteği gönderin:

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

İstek seçeneklerinizi JSON dosyasına ekleyin istek gövdesi. İsteğin içeriği verilerini almak istediğiniz konumu ve zaman aralığını saatlik hava kalitesi geçmişi Kontrol, e-posta ve tıklama gibi yanıta hangi hava kalitesi bilgilerinin eklenmesi gerektiği.

API Gezgini, canlı isteklerde bulunur. Bu sayede API ve API seçenekleri:

Deneyin.

Tek saatlik istek örneği

Tek saatlik istek gövdesi

Aşağıdaki kod, tek bir saat için istek gövdesinin nasıl oluşturulacağını gösterir kullanan geçmiş isteği history yöntemini kullanabilirsiniz. Bu örnekte, konumu ve geçmiş zaman damgasını ayarlarsınız.

curl -X POST -d '{
  "dateTime": "2023-06-26T15:01:23Z",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

Bir saatte yanıt

Yukarıdaki çağrı şu işlemi oluşturur: JSON yanıtı. Yanıt verileri hakkında daha fazla bilgi için Yanıt verileri başlıklı makaleye bakın.

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-26T15:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 73,
                    "aqiDisplay": "73",
                    "color": {
                        "red": 118,
                        "green": 202,
                        "blue": 51,
                        "alpha": 255
                    },
                    "category": "Good air quality",
                    "dominantPollutant": "pm10"
                }
            ]
        }
    ],
    "regionCode": "us"
}

Zaman aralığı isteği örneği

Zaman aralığı isteği

Aşağıdaki kod, Birden çok değer döndüren history Geçmiş saatlik hava kalitesinin kayıtları

Bir zaman aralığı belirterek birden çok kayıt isteğinde bulunabilirsiniz. Bu, kayıt için başlangıç ve bitiş zaman damgası veya geçerli günden kaç saat sonra gerekir.

Aşağıdaki örnekte, sayfa boyutunu 2 olarak ayarladığınız için dört saatlik hava kalitesi geçmişi, iki sayfa halinde döndürülür. Her sayfanın iki saatlik veri içeriyor.

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

Başlangıç ve bitiş zaman damgalarını ileterek benzer bir istekte bulunabilirsiniz:

curl -X POST -d '{
  "period": {
      "startTime":"2023-06-15T08:00:00Z",
      "endTime":"2023-06-15T12:00:00Z"
  },
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

Zaman aralığı yanıtı

Yukarıdaki çağrılar, Formdaki JSON yanıtı bölümüne göz atın. Yanıt verileri hakkında daha fazla bilgi için bkz. Yanıt verileri.

Yukarıdaki her iki aramada da dört saatlik hava kalitesi verisi istenir. Ancak, pageSize özelliğini istekte 2 olarak tanımlarsanız yanıt yalnızca şunu içerir: son iki saat için sonuçları görebilirsiniz.

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-15T11:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 83,
                    "aqiDisplay": "83",
                    "color": {
                        "red": 74,
                        "green": 185,
                        "blue": 54,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        },
        {
            "dateTime": "2023-06-15T10:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 89,
                    "aqiDisplay": "89",
                    "color": {
                        "red": 48,
                        "green": 175,
                        "blue": 55,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        }
    ],
    "regionCode": "us",
    "nextPageToken": "ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA"
}

Yanıtın nextPageToken özelliğini de içerdiğine dikkat edin. Bunu kullan özelliğini kullanarak sonraki iki sayfayı içeren sonuçlar saatlik veri.

Bir sonraki sonuç sayfasına erişmek için history uç noktası, ancak bu kez pageToken özelliğini ilk yanıttaki nextPageToken değeri.

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'