İzledikleriniz

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

Aşağıdaki HTTP POST isteğini göndererek history uç noktasını kullanarak saatlik hava kalitesi geçmişini isteyebilirsiniz:

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

İstek seçeneklerinizi JSON istek gövdesine ekleyin. İstek gövdesinde, saatlik hava kalitesi geçmişini almak istediğiniz konum ve zaman aralığı yer alır. 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çenekleri hakkında bilgi edinmek için canlı isteklerde bulunmanıza olanak tanır:

Tek saatlik istek örneği

Tek saatlik istek gövdesi

Aşağıdaki kodda, history yöntemi kullanılarak tek saatlik bir 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'

Bir saat içinde 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 başlıklı makaleyi inceleyin.

{
    "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, saatlik geçmiş hava kalitesine ait 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ı belirterek birden fazla kayıt isteğinde bulunabilirsiniz.

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 sayfa iki saatlik veri içerir.

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 başlıklı makaleyi inceleyin.

Yukarıdaki her iki çağrı da dört saatlik hava kalitesi verisi istiyor. 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 unutmayın. Sonuçların bir sonraki sayfasına erişmek için bu özelliği kullanın. Bu sayfada, verilerin sonraki iki saatlik kısmı yer alır.

Sonuçların bir sonraki 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çeneklerine alışabilmeniz için örnek istekler göndermenize olanak tanır.

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

  2. İsteğe bağlı olarak istek parametrelerini düzenleyin.

  3. 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 penceresini genişletmek için API Gezgini panelinde tam ekran simgesini fullscreen seçin.