İ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 HKİ değerlerinin ve ilgili bilgilerin (kirliliğe yol açan maddelerin konsantrasyon seviyesi ve sağlıkla ilgili öneriler gibi) döndürüleceğini kontrol edebilirsiniz.

Aşağıdaki uç noktaya bir HTTP POST isteği 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 içeriğine ekleyin. İsteğin gövdesinde, saatlik hava kalitesi geçmişini almak istediğiniz konum ve zaman aralığı bulunur. 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'ye ve API seçeneklerine aşina olabilmeniz için canlı istek göndermenize olanak tanır:

Deneyin.

Tek saatlik istek örneği

Tek saatlik istek metni

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

Başlangıç ve bitiş zaman damgası anlamına gelen bir zaman aralığı belirterek veya geçerli zamandan geriye doğru kaç saat olduğunu belirterek birden fazla kayıt isteğinde bulunabilirsiniz.

Aşağıdaki örnekte, sayfa boyutunu 2 olarak ayarladığınızda dört saatlik hava kalitesi geçmişi isteğiniz iki sayfa halinde 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 istek gönderebilirsiniz:

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 verileri ister. Ancak, istekte pageSize mülkünü 2 olarak ayarladığınız için yanıt yalnızca en son iki saate ait sonuçları içerir.

{
    "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ıtta nextPageToken özelliğinin de yer aldığını unutmayın. Sonraki iki saate ait verileri içeren sonuçların bir sonraki sayfasına erişmek için bu özelliği kullanın.

Sonuçların bir sonraki sayfasına erişmek için history uç noktasına ikinci bir istek gönderin ancak bu kez pageToken mülkünü 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'