İ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. İ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'ye ve API seçeneklerine aşina olabilmeniz için canlı istek göndermenize olanak tanır:

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 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, 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 mevcut 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. Sonuçların bir sonraki sayfasına (sonraki iki saate ait verileri içerir) erişmek için bu mülkü 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'

Deneyin!

API Gezgini, API'ye ve API seçeneklerine aşina olabilmeniz 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 panelinde, API Gezgini penceresini genişletmek için tam ekran simgesini tam ekran seçin.