Hava Kalitesi API'sini kullanarak Yerler için hava kalitesi farkındalığı

Bu dokümanda, zengin yer arama deneyimleri oluşturmak için Air Quality API'nin nasıl kullanılacağını öğreneceksiniz. Hava kalitesinin, dönüşüm hunisinin başından sonuna kadar kullanıcılar için nasıl bir değer sinyali olabileceğini ve Air Quality API verilerinin mevcut deneyimlere nasıl yerleştirilebileceğini göstereceğiz.

Kullanım alanları ve katma değer

Air Quality API sinyalleri, kullanıcıların ziyaret edecekleri bir konum araması gibi durumlarda çeşitli arama deneyimlerine uygun olabilir. Air Quality API aşağıdakileri sunar:

  • Gerçek zamanlı * ve geçmiş veriler: Geçerli durumu ve saatlik olarak 30 günlük bir zaman dilimi içinde geriye dönük verileri temsil eden doğru ve güncel veriler. (* dışarıdaki hava kalitesinin saatlik anlık görüntüsü)
  • Küresel ve yerel veriler: 100'den fazla ülkedeki bölgelerin tamamını kapsayan ve son derece yerelleştirilmiş (500 milyona kadar) Hava Kalitesi API verileri, kullanıcılara karşılaştırma yapmaları ve en uygun yerle ilgili karar vermeleri için önemli sinyaller sağlar.

Hava kalitesi yakın konumlarda bile büyük ölçüde farklı olabilir

Örnek Adım Adım Açıklamalı Kılavuz

Hava kalitesi verilerini deneyimin başlarında gösterin

Air Quality API verilerini göstermenin iki temel yolu vardır:

Air Quality API verilerini konum raptiyelerinde göster

  • Konum dizininizi seçin: Evrensel HKİ veya Yerel HKİ (70'e kadar farklı Hava Kalitesi Endeksleri (HKİ) mevcuttur). Hava kalitesi endeksi (HKİ), belirli bir ülkenin (ör. ABD EPA) farklı hava kalitesi seviyelerini farklı hesaplama yöntemleri, veri kaynakları ve belirlenen amaçlara göre sınıflandırdığı ölçektir.
  • Doğrudan yer arama deneyiminden yararlanarak ana Air Quality API değerini ve renk kodunu görselleştirmeye başlayın.

Varsayılan ekran yalnızca renk kodunu içerebilir.


Pin seçiminde daha fazla Air Quality API bilgisi görüntüleyin:

  • Evrensel HKİ / Yerel HKİ anlamı.
  • Kirlilik seviyeleri, havadaki parçacık ve gazların ölçümüdür: Baskın kirletici madde, Konsantrasyon, Kaynaklar ve Etkiler.
  • Sağlık önerileri: Mevcut hava kalitesi koşulları için önerilen işlemler.
  • Varsayılan olarak görüntülenen bilgi düzeyini ihtiyaçlarınıza göre ayarlayabilirsiniz. Bir konuma ait veri noktalarının, diğer konumlara kıyasla genellikle yararlı olduğunu unutmayın.

Hava kalitesi bölümü görüntüleme örneği

Hava Kalitesi Yanıtı

{
    "dateTime": "2023-08-09T10:00:00Z",
    "regionCode": "fr",
    "indexes": [
       {
            "code": "uaqi",
            "displayName": "Universal AQI",
            "aqi": 76,
            "aqiDisplay": "76",
            "color": {
                "red": 0.4117647,
                "green": 0.77254903,
                "blue": 0.20392157
            },
            "category": "Good air quality",
            "dominantPollutant": "pm10"
        },
       …
    ],
    "pollutants": [
       {
            "code": "co",
            "displayName": "CO",
            "fullName": "Carbon monoxide",
            "concentration": {
                "value": 95.18,
                "units": "PARTS_PER_BILLION"
            }...
        },
       …
    ],
    "healthRecommendations": -{
        "generalPopulation": "With this level of air quality, you have no limitations. Enjoy the outdoors!",
        "elderly": "If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider red ...",
        "lungDiseasePopulation": …
    }
}

  • Alternatif olarak, Hava Kalitesi verilerini yalnızca bir yerle etkileşimde bulunduğunda sorgulayabilirsiniz.

  • Yakındaki yerleri filtrelemek için Air Quality API dizinini kullanabilirsiniz. Örneğin: Bölgenizdeki parkları arıyorsanız yalnızca hava kalitesi iyi olan parkları görürsünüz.

Hava Kalitesi Yanıtı

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...
RGB'ye dönüştür
  var red = parseInt(colorResponse.red*255)|| 1;
  var green = parseInt(colorResponse.green*255)|| 1;
  var blue = parseInt(colorResponse.blue*255)|| 1; 
  // --> output rgb(241,250,5)

Air Quality API ısı haritası katmanını haritada göster

Isı haritası renkli kutular kullanmak idealdir:

  • bir genel bakış sunulmuştur.
  • böylece o bölgedeki nüansları hemen görebilirsiniz.

Google haritanızın tüm görüntü alanını kaplaması için gereken parçaları tek tek görüntülemek için Haritalar JavaScript API'sini ImateMapType ile birlikte kullanın. Kullanıcılar yatay kaydırarak, yakınlaştırarak veya konumu değiştirerek haritayla etkileşime girdikçe ısı haritası kutuları yenilenir.

İzin verilen yakınlaştırma düzeyi değerinin en fazla 16 olduğunu unutmayın.
Air Quality API ısı haritası parça katmanı, yerel mesafe aramada kaybolabilir.

Sınırlı bir Hava Kalitesi Endeksleri grubunda Isı haritası türleri'ni seçebilirsiniz:

  • UAQI_RED_GREEN - Evrensel Hava Kalitesi İndeksi kırmızı-yeşil palet.
  • UAQI_INDIGO_PERSIAN - Evrensel Hava Kalitesi İndeksi çivit-pers paleti.
  • PM25_INDIGO_PERSIAN - PM2.5 endeksi çivit-pers paleti.
  • GBR_DEFRA - Günlük Hava Kalitesi İndeksi (İngiltere) renk paleti.
  • DEU_UBA - Alman Yerel Hava Kalitesi İndeksi renk paleti.
  • CAN_EC - Kanada Hava Kalitesi Sağlık İndeksi renk paleti.
  • FRA_ATMO - Fransa Hava Kalitesi İndeksi renk paleti.
  • US_AQI - ABD Hava Kalitesi İndeksi renk paleti.

  • Kullanıcıların değeri ve renk sıralamasını anlamaları için renk skalası belirttiğinizden emin olun:

    • gradyan ölçeği UAQI (0-100): Kötü / Mükemmel

    Renk paleti CSS kod snippet'i:

    .gradient-scale { 
    background: linear-gradient(to right, 
        rgb(99, 20, 161) 0%, /* purple */
        rgb(149, 0, 25) 20%, /* red */
        rgb(248, 47, 21) 40%, /* orange */
        rgb(255, 248, 35) 60%, /* yellow */
        rgb(34,163,120) 80%, /* steelblue */
        rgb(255,255,255) 100% /* white */
       );
    }
    

    • UAQI (0-100) ölçeğinde önemli noktayı temsil eden düz renkler: Kötü / Mükemmel

    Sorgu sayısı ve ilişkili maliyet

    • Haritalar JavaScript API'si: Deneyim yüklenirken 1 harita.
    • Air Quality API:
      • Her yer için 1 sorgu (tümü harita yüklenirken veya yalnızca kullanıcı seçiminde).
      • Isı haritası karo katmanı: Her karo resmi 256*256 pikseldir. Mobil cihazda veya web'de sunulan standart bir haritayı örtmek için 12-14 karoya ihtiyacınız vardır. Alınan her blok 1 SKU birimi olarak sayılır.
    • Yakındaki Arama (Yeni) API'si: Görüntülenen her 20 yer için 1 sorgu. Sorgu yanıtının bir parçası olan Yer verilerine göre farklı faturalandırma.

    Sonuç

    Air Quality API'nin, kullanıcıların ziyaret edecekleri yerlere karar vermeleri için önemli bir veri noktası olabileceğini gösterdik. Bu nedenle, Hava Kalitesi verileri, aynı anda görüntülenen bilgi miktarına ve nasıl görünür olduklarına dikkat ederek arama deneyiminde mümkün olan en kısa sürede görünür olmalıdır.

    Sonraki İşlemler

    Önerilen Ek Kaynaklar:

    Katılımcılar

    Bu makale Google tarafından saklanmaktadır. Mesajı ilk olarak aşağıdaki katkıda bulunanlar yazmış.
    Ana yazar:

    Thomas Anglaret | Çözüm Mühendisi