Bu dokümanda, zengin yer arama deneyimleri oluşturmak için Hava Kalitesi API'yi nasıl kullanacağınızı inceleyeceksiniz. Huninin en başından sonuna kadar kullanıcılar için hava kalitesinin nasıl bir değer göstergesi olabileceğini ve Hava Kalitesi 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 etmek için bir yer aradığı durumlar gibi çeşitli arama deneyimlerine sığabilir. Air Quality API şunları sunar:
- Gerçek zamanlı * ve geçmiş veriler: Mevcut durumu temsil eden yeni, doğru verilerin yanı sıra 30 günlük bir zaman aralığında saatlik çözünürlükteki geçmişe dönük veriler. (* Dışarıdaki hava kalitesinin saatlik anlık görüntüsü)
- Küresel ve yerel veriler: 100'den fazla ülkedeki tüm alanları kapsayan ancak son derece yerelleştirilmiş (500 m'ye kadar) Hava Kalitesi API verileri, kullanıcıların karşılaştırma yapması ve en uygun yer hakkında karar vermesi için önemli sinyaller sağlar.
Hava kalitesi, yakın konumlar arasında bile önemli ölçüde farklılık gösterebilir
Örnek Adım Adım Açıklamalı Kılavuz
Hava kalitesi verilerini deneyimin başlarında gösterme
Hava Kalitesi API verilerini göstermenin iki ana yolu vardır:
Mevcut koşullar / saatlik: Her konum için gösterilecek ayrı değerler alın.
(Hava Kalitesi API verilerini konum raptiyelerinde görüntüleme bölümüne gidin)Isıtma haritası karoları: Haritanızın üzerine mevcut dış mekan hava kalitesi koşullarını temsil eden renkli bir katman yerleştirin. Ülkeye özgü katman dizinleri kullanılabilir.
(Hava Kalitesi API'si ısı haritası katmanını haritada görüntüleme bölümüne gidin)
Konum raptiyelerinde Hava Kalitesi API verilerini görüntüleme
- Konum indeksinizi seçin: Evrensel HKİ veya yerel HKİ (70'e kadar farklı hava kalitesi indeksi (HKİ) kullanılabilir). Hava kalitesi indeksi (HKİ), ABD EPA gibi belirli bir ülkenin farklı hesaplama yöntemleri, veri kaynakları ve belirlenen amaçlara göre farklı hava kalitesi seviyelerini sınıflandırmak için kullanılan ölçektir.
- Ana Hava Kalitesi API değerini ve renk kodunu doğrudan yer arama deneyiminden görselleştirmeye başlayın.
varsayılan görüntüleme yalnızca renk kodunu içerebilir.
İğne seçimiyle ilgili daha fazla Hava Kalitesi API bilgisi görüntüleme:
- Evrensel HKİ / Yerel HKİ'nin anlamı.
- Havadaki partiküllerin ve gazların ölçümü olan kirliliğe yol açan madde seviyeleri: Baskın kirliliğe yol açan madde, Konsantrasyon, Kaynaklar ve Etkiler.
- Mevcut hava kalitesi koşulları için önerilen işlemler olan sağlık önerileri.
- Varsayılan olarak gösterilen bilgi düzeyini ihtiyaçlarınıza göre ayarlayabilirsiniz. Bir konumun veri noktalarının genellikle diğer konumlara kıyasla yararlı olduğunu unutmayın.
Hava kalitesi bölümü görüntüleme örneği
{
"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 konumla etkileşimde bulunulduğunda sorgulayabilirsiniz.
- Yakınlardaki yerleri filtrelemek için Hava Kalitesi API indeksini kullanabilirsiniz. Örneğin, bölgenizdeki parkları arıyorsanız yalnızca hava kalitesi iyi olan parklar gösterilir.
Hava Kalitesi Yanıtı
... "color":{ "red": 0.9490196, "green": 0.98039216, "blue": 0.019607844 } ...
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)
Hava Kalitesi API'si ısı haritası katmanını haritada görüntüleme
Isı haritası renkli karolar aşağıdakiler için mükemmel bir yöntemdir:
- büyük bir alana genel bakış sunmak için
- tıklayarak bu alandaki ayrıntıları hızlıca gösterebilirsiniz.
Google haritanızın tüm görüntü alanını kapsamak üzere gereken ayrı ayrı blokları görüntülemek için ImateMapType ile birlikte Haritalar JavaScript API'sini kullanın. Kullanıcı haritayı kaydırarak, yakınlaştırarak veya konumu değiştirerek etkileşimde bulunduğunda ısı haritası karoları yenilenir.
İzin verilen yakınlaştırma düzeyi değerinin en fazla 16 olduğunu unutmayın.
Hava Kalitesi API'si ısı haritası karo katmanı, yerel mesafe aramalarında kaybolabilir.
Sınırlı bir hava kalitesi indeksi grubu içinden Isı haritası türleri'ni seçebilirsiniz:
Kullanıcıların değeri ve renk sıralamasını anlayabilmesi için renk ölçeğini 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 temel noktayı temsil eden düz renkler:
Kötü / Mükemmel
İlişkili sorgu sayısı ve maliyet
- Maps JavaScript API: Deneyim yüklenirken 1 harita.
- Hava Kalitesi API'si:
- Her yer için 1 sorgu (harita yüklendiğinde veya yalnızca kullanıcı seçimi yapıldığında tümünü).
- Isı haritası karo katmanı: Her karo resmi 256*256 pikseldir ve mobil cihazda veya web'de sunulan standart bir haritayı kaplamak için 12-14 karoya ihtiyacınız vardır. Çekilen her kutu 1 SKU birimi olarak sayılır.
- Yakındaki Yerler (Yeni) API: Gösterilen her 20 yer için 1 sorgu. Sorgu yanıtının bir parçası olan yer verilerine göre farklı faturalandırma.
Sonuç
Hava Kalitesi API'sinin, kullanıcıların ziyaret edecekleri yere karar vermeleri için önemli bir veri noktası olabileceğini gösterdik. Bu nedenle, hava kalitesi verileri, aynı anda gösterilen bilgi miktarına ve bu bilgilerin nasıl gösterildiğine dikkat edilerek arama deneyiminde mümkün olan en erken zamanda gösterilmelidir.
Sonraki İşlemler
Önerilen Daha Fazla Okuma:
- Yakındaki Arama (Yeni) API'si ile yerel keşfi iyileştirin
- Veri odaklı stilizasyonla verilerinizi anlık olarak görme
Katkıda bulunanlar
Bu makale Google tarafından yönetilmektedir. Bu makaleyi ilk olarak aşağıdaki katkıda bulunanlar yazdı.
Başlıca yazar:
Thomas Anglaret | Çözüm Mühendisi