İzledikleriniz

history uç noktası, belirli bir konum için belirli bir zaman aralığında (en fazla 30 gün) geçmiş saatlik hava kalitesi bilgilerini sağlar. Hangi AQI'ların ve ilgili bilgilerin (kirletici konsantrasyon seviyesi ve sağlık önerileri gibi) döndürüleceğini kontrol edebilirsiniz.

history uç noktasını kullanarak saatlik hava kalitesi geçmişini öğrenmek için aşağıdaki adrese bir HTTP POST isteği gönderebilirsiniz:

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

İstek seçeneklerinizi JSON istek gövdesine ekleyin. İstek gövdesi, saatlik hava kalitesi geçmişini almak istediğiniz konumu ve zaman aralığını içerir. Ayrıca, yanıta hangi hava kalitesi bilgilerinin dahil edileceğini kontrol etmek için çeşitli seçenekler de içerebilir.

API Gezgini, API ve API seçeneklerini tanıyabilmeniz için canlı istekler göndermenize olanak tanır:

Tek saatlik istek örneği

Tek saatlik istek içeriği

Aşağıdaki kodda, history yöntemini kullanarak tek saatlik geçmiş isteği için istek gövdesinin nasıl oluşturulacağı gösterilmektedir. 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'

Tek saatlik yanıt

Yukarıdaki çağrı aşağıdaki JSON yanıtını oluşturur. Yanıt verileri hakkında daha fazla bilgi için Yanıt verileri bölümüne 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 kodda, geçmiş saatlik hava kalitesiyle ilgili birden fazla kayıt döndüren bir history için istek gövdesinin nasıl oluşturulacağı gösterilmektedir.

Bir zaman aralığı (başlangıç ve bitiş zaman damgası) belirterek veya geçerli zamandan geriye doğru saat sayısını belirterek birden fazla kayıt isteyebilirsiniz.

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

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, aşağıdaki biçimde bir JSON yanıtı oluşturur. Yanıt verileri hakkında daha fazla bilgi için Yanıt verileri bölümüne bakın.

Yukarıdaki her iki çağrı da dört saatlik hava kalitesi verilerini ister. Ancak istekte pageSize özelliğini 2 olarak ayarladığınız için yanıtta yalnızca son iki saate ait sonuçlar yer alır.

{
    "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ğini görebilirsiniz. Sonraki iki saatlik verileri içeren sonuçların sonraki sayfasına erişmek için bu mülkü kullanın.

Sonraki sonuç sayfasına erişmek için history uç noktasına ikinci bir istek gönderin ancak bu kez pageToken özelliğini ilk yanıttaki nextPageToken değerine ayarlayın.

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'

Deneyin.

API Gezgini, API ve API seçeneklerini tanıyabilmeniz için örnek istekler göndermenize olanak tanır.

  1. Sayfanın sağ tarafındaki API simgesini api seçin.

  2. İsterseniz istek parametrelerini düzenleyebilirsiniz.

  3. Execute (Yürüt) düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

  4. API Gezgini panelinde, API Gezgini penceresini genişletmek için tam ekran simgesini fullscreen seçin.