Bu belgede, zengin yer arama deneyimleri oluşturmak için Air Quality API'yi nasıl kullanacağınızı öğreneceksiniz. Hava kalitesinin, dönüşüm hunisinin başından sonuna kadar kullanıcılar için nasıl değerli bir sinyal olabileceğini ve Hava Kalitesi API'si verilerinin mevcut deneyimlere nasıl yerleştirilebileceğini göstereceğiz.
Kullanım alanları ve katma değer
Hava Kalitesi API'si sinyalleri, kullanıcıların ziyaret edilecek bir yer aradığı gibi çeşitli arama deneyimlerine uyabilir. Air Quality API'nin sunduğu özellikler:
- Gerçek zamanlı * ve geçmiş veriler: Mevcut durumu temsil eden güncel ve doğru verilerin yanı sıra saatlik çözünürlükte 30 günlük bir zaman aralığındaki geçmiş veriler. (* dışarıdaki hava kalitesinin saatlik anlık görüntüsü)
- Global 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 en uygun yerle ilgili karşılaştırma yapıp 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şında gösterin
Hava Kalitesi API'si verilerini göstermenin iki ana yolu vardır:
Mevcut koşullar / saatlik: Her konumda gösterilecek ayrı değerler alın.
(Bölüme git: Konum işaretlerinde hava kalitesi API verilerini görüntüleme)Isı haritası karoları: Mevcut dış mekan hava kalitesi koşullarını temsil eden renkli bir katmanı haritanızın üzerine yerleştirin. Ülkeye özgü katman indeksleri mevcuttur.
(bölüme git: Hava Kalitesi API'si ısı haritası katmanını haritada görüntüleme)
Konum işaretlerinde 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İ) mevcuttur). Hava kalitesi indeksi (HKİ), örneğin ABD EPA gibi belirli bir ülkenin farklı hesaplama yöntemlerine, veri kaynaklarına ve belirlenen amaçlara göre farklı hava kalitesi seviyelerini sınıflandırdığı ölçeklerdir.
- Hava Kalitesi API'sinin ana değerini ve renk kodunu doğrudan yer arama deneyiminden görselleştirmeye başlayın.
varsayılan gösterimde yalnızca renk kodu yer alabilir.
Pin seçimi sırasında daha fazla hava kalitesi API bilgisi gösterin:
- Evrensel HKİ / Yerel HKİ anlamı.
- Havadaki partiküllerin ve gazların ölçüsü olan kirlilik seviyeleri: Baskın kirletici, konsantrasyon, kaynaklar ve etkiler.
- Sağlık önerileri: Mevcut hava kalitesi koşulları için önerilen işlemler.
- Varsayılan olarak gösterilen bilgi düzeyini ihtiyaçlarınıza göre ayarlayabilirsiniz. Bir konumla ilgili veri noktalarının genellikle diğer konumlarla karşılaştırıldığında faydalı 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ındaki yerleri filtrelemek için hava kalitesi API'si 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 parçalar şu amaçlar için idealdir:
- geniş bir alanın genel görünümünü sağlamak için.
- bu alandaki nüansları hızlıca göstermek için kullanılır.
Google Haritanızın tüm görüntü alanını kaplamak için gereken bağımsız parçaları görüntülemek üzere Maps JavaScript API'yi ImateMapType ile birlikte kullanın. Kullanıcılar haritayla etkileşimde bulundukça (ör. kaydırma, yakınlaştırma veya konum değiştirme) ısı haritası kutucukları yenilenir.
İzin verilen yakınlaştırma düzeyi değerinin en fazla 16 olduğunu unutmayın.
Hava Kalitesi API'si ısı haritası döşeme katmanı, hiper yerel arama sırasında kaybolabilir.
Sınırlı bir hava kalitesi indeksi grubunda ısı haritası türlerini seçebilirsiniz:
Kullanıcıların değeri ve renk sıralamasını anlaması için renk ölçeğini belirttiğinizden emin olun:
- UAQI gradyan ölçeği (0-100):
Kötü / Mükemmel
Renk paleti CSS kodu 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ğindeki önemli noktaları temsil eden düz renkler:
Kötü / Mükemmel
Sorgu sayısı ve ilişkili maliyet
- Maps JavaScript API: Deneyim yüklenirken 1 harita.
- Air Quality API (Hava Kalitesi API'si):
- Her yerde 1 sorgu (tümü harita yüklenirken veya yalnızca kullanıcı seçimiyle).
- Isı haritası döşeme katmanı: Her döşeme resmi 256*256 pikseldir ve mobil cihazda veya web'de sunulan standart bir haritayı kapsamak için 12-14 döşeme gerekir. Çekilen her kutu, 1 SKU birimi olarak sayılır.
- Nearby Search (New) 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 edilecek yerlere karar vermesinde önemli bir veri noktası olabileceğini gösterdik. Bu nedenle, hava kalitesi verileri, arama deneyiminde mümkün olan en kısa sürede görünür olmalıdır. Aynı anda gösterilen bilgi miktarına ve bilgilerin nasıl görünür hale getirildiğine dikkat edilmelidir.
Sonraki İşlemler
Önerilen Ek Okumalar:
- Nearby Search (Yeni) API ile yerel keşfi iyileştirme
- Veriye dayalı stil ile verilerinizi anlık olarak görme
Katkıda bulunanlar
Bu makale Google tarafından yönetilir. Bu makale ilk olarak aşağıdaki katkıda bulunanlar tarafından yazılmıştır.
Başlıca yazar:
Thomas Anglaret | Çözüm Mühendisi