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:
Mevcut koşullar / saatlik: Her konumda görüntülenecek ayrı değerleri alın.
(Konum raptiyelerinde Air Quality API verilerini gösterme bölümüne gidin)Isı haritası karoları: Haritanızın üzerine, dış mekandaki mevcut hava kalitesi koşullarını temsil eden renkli bir katman bindirir. Ülkeye özel katman dizinleri mevcuttur.
(Haritada Görüntülü Reklam Ağı Kalitesi API'si ısı haritası katmanı bölümüne gidin)
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
{ "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:
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:
- Etrafımda Arama (Yeni) API'si ile yerel keşfi iyileştirme
- Veriye dayalı stil ile verilerinizi gerçek zamanlı olarak görün
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