Trong tài liệu này, bạn sẽ tìm hiểu cách sử dụng API Chất lượng không khí để tạo trải nghiệm tìm kiếm địa điểm phong phú. Chúng tôi sẽ trình bày cách chất lượng không khí có thể là một tín hiệu có giá trị đối với người dùng từ khi bắt đầu cho đến khi kết thúc phễu và cách dữ liệu API Chất lượng không khí có thể được đưa vào những trải nghiệm hiện có.
Trường hợp sử dụng và giá trị gia tăng
Các tín hiệu của API Chất lượng không khí có thể phù hợp với nhiều trải nghiệm tìm kiếm, chẳng hạn như khi người dùng tìm kiếm một địa điểm để ghé thăm. API Chất lượng không khí mang đến:
- Dữ liệu theo thời gian thực * và dữ liệu trong quá khứ – dữ liệu mới, chính xác thể hiện trạng thái hiện tại cũng như dữ liệu trong quá khứ trong khoảng thời gian 30 ngày theo độ phân giải hằng giờ. (* thông tin nhanh hằng giờ về chất lượng không khí ngoài trời)
- Dữ liệu toàn cầu và cục bộ – bao phủ toàn bộ khu vực ở hơn 100 quốc gia nhưng dữ liệu API Chất lượng không khí được bản địa hoá cao (tối đa 500 m) cung cấp các tín hiệu chính để người dùng so sánh và đưa ra quyết định về vị trí phù hợp nhất.
Chất lượng không khí có thể khác nhau đáng kể ngay cả đối với các vị trí gần nhau
Hướng dẫn từng bước về mẫu
Hiển thị dữ liệu chất lượng không khí ngay từ đầu trải nghiệm
Có hai cách chính để hiển thị dữ liệu API Chất lượng không khí:
Tình trạng hiện tại / theo giờ: lấy các giá trị riêng lẻ để hiển thị theo từng vị trí.
(chuyển đến phần: Hiển thị dữ liệu API Chất lượng không khí trên các ghim vị trí)Thẻ thông tin bản đồ nhiệt: phủ một lớp màu đại diện cho điều kiện chất lượng không khí ngoài trời hiện tại lên đầu bản đồ. Có chỉ mục lớp theo quốc gia.
(chuyển đến phần: Hiển thị lớp bản đồ nhiệt của API Chất lượng không khí trên bản đồ)
Hiển thị dữ liệu của API Chất lượng không khí trên ghim vị trí
- Chọn chỉ số theo vị trí: Chỉ số chất lượng không khí chung hoặc Chỉ số chất lượng không khí tại địa phương (có tới 70 Chỉ số chất lượng không khí (AQI) khác nhau). Chỉ số chất lượng không khí (AQI) là thang đo mà một quốc gia cụ thể (ví dụ: EPA của Hoa Kỳ) phân loại các mức chất lượng không khí dựa trên các phương pháp tính toán, nguồn dữ liệu và mục đích được chỉ định.
- Hãy bắt đầu trực quan hoá giá trị chính của API Chất lượng không khí và mã màu sắc ngay trong giao diện tìm kiếm địa điểm.
màn hình mặc định có thể chỉ bao gồm mã màu.
Hiển thị thêm thông tin về API Chất lượng không khí khi chọn ghim:
- Ý nghĩa của Chỉ số chất lượng không khí chung (AQI chung)/Chỉ số chất lượng không khí tại địa phương (AQI tại địa phương).
- Mức độ ô nhiễm, là chỉ số đo lường các hạt và khí trong không khí: Chủ yếu là chất gây ô nhiễm, Nồng độ, Nguồn và Hiệu ứng.
- Đề xuất về sức khoẻ, là những hành động được đề xuất cho điều kiện chất lượng không khí hiện tại.
- Bạn có thể điều chỉnh mức độ thông tin hiển thị theo mặc định để đáp ứng nhu cầu của mình. Xin lưu ý rằng các điểm dữ liệu cho một vị trí thường hữu ích so với những vị trí khác.
Ví dụ về cách hiển thị mục chất lượng không khí
{
"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": …
}
}
- Ngoài ra, bạn chỉ có thể truy vấn dữ liệu về Chất lượng không khí dựa trên hoạt động tương tác với một vị trí.
- Bạn có thể sử dụng chỉ mục API Chất lượng không khí để lọc các địa điểm lân cận, ví dụ: nếu đang tìm kiếm công viên trong khu vực của mình, bạn sẽ chỉ thấy những công viên có chất lượng không khí tốt.
Phản hồi về chất lượng không khí
... "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)
Hiển thị lớp bản đồ nhiệt API Chất lượng không khí trên bản đồ
Ô màu bản đồ nhiệt là một cách tuyệt vời:
- để cung cấp thông tin tổng quan về một khu vực rộng lớn.
- để nhanh chóng hiển thị các sắc thái trong khu vực đó.
Sử dụng API JavaScript của Maps với ImateMapType để hiển thị từng thẻ thông tin cần thiết nhằm bao phủ toàn bộ khung nhìn của bản đồ Google. Thẻ thông tin bản đồ nhiệt sẽ làm mới khi người dùng tương tác với bản đồ bằng cách kéo, thu phóng hoặc thay đổi vị trí.
Xin lưu ý rằng giá trị mức thu phóng được phép là tối đa 16.
Lớp thẻ thông tin dạng ô nhiệt của API Chất lượng không khí có thể biến mất khi tìm kiếm siêu cục bộ.
Bạn có thể chọn Các loại bản đồ nhiệt trong một số Chỉ số chất lượng không khí:
Hãy đảm bảo bạn chỉ định thang màu để người dùng hiểu giá trị và thứ hạng màu sắc của nó:
- UAQI theo thang chuyển màu (0-100): kém / rất tốt
Đoạn mã CSS của bảng màu:
.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 */ ); }
- màu đồng nhất để thể hiện điểm chính theo thang điểm UAQI (0-100): kém / rất tốt
Số lượng truy vấn và chi phí liên quan
- Maps JavaScript API: 1 bản đồ khi tải trải nghiệm.
- Air Quality API (API Chất lượng không khí):
- 1 truy vấn cho mỗi địa điểm (tất cả khi tải bản đồ hoặc chỉ khi người dùng chọn).
- Lớp thẻ thông tin bản đồ nhiệt: mỗi hình ảnh thẻ thông tin có kích thước 256*256px và để bao phủ một bản đồ chuẩn được trình bày trên thiết bị di động hoặc web, bạn cần có 12-14 thẻ thông tin. Mỗi ô được lấy được tính là 1 đơn vị SKU.
- API Tìm kiếm lân cận (Mới): 1 cụm từ tìm kiếm cho mỗi 20 địa điểm hiển thị. Các khoản thanh toán khác nhau theo Dữ liệu địa điểm trong nội dung phản hồi truy vấn.
Kết luận
Chúng tôi đã cho thấy rằng API Chất lượng không khí có thể là một điểm dữ liệu quan trọng để người dùng quyết định nơi sẽ ghé thăm. Do đó, dữ liệu về Chất lượng không khí phải xuất hiện sớm nhất có thể trong trải nghiệm tìm kiếm, đồng thời phải chú ý đến lượng thông tin hiển thị cùng một lúc và cách hiển thị thông tin đó.
Hành động tiếp theo
Tài liệu đọc thêm được đề xuất:
- Cải thiện khả năng khám phá địa phương bằng API Tìm kiếm lân cận (Mới)
- Xem dữ liệu theo thời gian thực bằng tính năng Định kiểu dựa trên dữ liệu
Người đóng góp
Google duy trì bài viết này. Các cộng tác viên sau đây là tác giả ban đầu của bài viết này.
Tác giả chính:
Thomas Anglaret | Kỹ sư giải pháp