Nhận biết về chất lượng không khí tại các địa điểm sử dụng API Chất lượng không khí

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í để xây dựng trải nghiệm tìm kiếm phong phú về địa điểm. Chúng tôi sẽ giải thích cách chất lượng không khí có thể là một tín hiệu đánh giá giá trị cho người dùng từ đầu cho đến cuối phễu, cũng như cách dữ liệu API Chất lượng không khí có thể được nhúng vào các trải nghiệm hiện có.

Trường hợp sử dụng và giá trị gia tăng

Tín hiệu của API Chất lượng không khí có thể xuất hiện trong nhiều trải nghiệm tìm kiếm, chẳng hạn như khi người dùng đang tìm kiếm một địa điểm để ghé thăm. Air Quality API (API Chất lượng không khí) mang lại:

  • 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 ngược thời gian trong khoảng thời gian 30 ngày theo độ phân giải hằng giờ. (* thông tin tổng quan nhanh hằng giờ về chất lượng không khí ngoài trời)
  • Dữ liệu toàn cầu và địa phương: bao gồm 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 (lên đến 500 triệu) 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ề địa điểm phù hợp nhất.

Chất lượng không khí có thể thay đổi đáng kể ngay cả ở những địa điểm gần

Hướng dẫn từng bước về mẫu

Hiển thị dữ liệu chất lượng không khí sớm trong chế độ trải nghiệm

Có hai cách chính để hiển thị dữ liệu của API Chất lượng không khí:

Hiện dữ liệu của API Chất lượng không khí trên ghim vị trí

  • Chọn chỉ số vị trí của bạn: Chỉ số chất lượng không khí (AQI) toàn cầu hoặc AQI của địa phương (hiện có tối đa 70 Chỉ số chất lượng không khí (AQI)). Chỉ số chất lượng không khí (AQI) là thang đo mà theo đó, một quốc gia nhất định, chẳng hạn như U.S. EPA, phân loại các mức chất lượng không khí khác nhau, 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 ngay từ trải nghiệm 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êm thông tin về API Chất lượng không khí trên lựa chọn mã pin:

  • Ý nghĩa của AQI toàn cầu / Chỉ số chất lượng không khí (AQI) tại địa phương.
  • Mức ô nhiễm, là thước đo các hạt và khí trong không khí: Chất gây ô nhiễm chủ yếu, Nồng độ, Nguồn và tác động.
  • Đề xuất về sức khoẻ, là các 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 cấp độ thông tin được hiển thị theo mặc định để phục vụ nhu cầu của mình. Hãy nhớ rằng các điểm dữ liệu cho một vị trí thường hữu ích so với các vị trí khác.

Ví dụ về cách trình bày mục chất lượng không khí

Phản hồi về 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 Chất lượng không khí khi có sự tương tác với một vị trí.

  • Bạn có thể sử dụng chỉ số API Chất lượng không khí để lọc các địa điểm lân cận, tức là: nếu đang tìm công viên trong khu vực của mình, bạn sẽ chỉ hiển thị 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
}
...
Chuyển đổi sang RGB 
  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 của API Chất lượng không khí trên bản đồ

Các ô màu có bản đồ nhiệt là một cách tuyệt vời:

  • để cung cấp tổng quan về khu vực rộng lớn.
  • để nhanh chóng hiển thị sắc thái trong khu vực đó.

Sử dụng API JavaScript của Maps cùng với ImateMapType để hiển thị các ô riêng lẻ cần thiết để bao phủ toàn bộ khung nhìn của bản đồ Google của bạn. Các ô 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 bản đồ, thu phóng hoặc thay đổi vị trí.

Xin lưu ý rằng giá trị mức thu phóng được phép tối đa là 16.
Lớp ô bản đồ 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 địa phương.

Bạn có thể chọn Các loại bản đồ nhiệt trong một nhóm Chỉ số chất lượng không khí nhất định:

  • UAQI_RED_GREEN – Chỉ số chất lượng không khí toàn cầu có bảng màu xanh lục đỏ.
  • UAQI_INDIGO_PERSIAN – Chỉ số chất lượng không khí toàn cầu màu chàm-Persian.
  • PM25_INDIGO_PERSIAN - chỉ số PM2.5 bảng màu chàm-persian.
  • GBR_DEFRA – Bảng màu của Chỉ số chất lượng không khí hằng ngày (Vương quốc Anh).
  • DEU_UBA – Bảng màu của Chỉ số chất lượng không khí địa phương của Đức.
  • CAN_EC – Bảng màu Chỉ số sức khoẻ theo chất lượng không khí của Canada.
  • FRA_ATMO – Bảng màu của Chỉ số chất lượng không khí của Pháp.
  • US_AQI – Bảng màu Chỉ số chất lượng không khí của Hoa Kỳ.

    • Hãy nhớ chỉ định thang màu để người dùng hiểu được giá trị và thứ hạng màu của giá trị đó:

    • UAQI thang độ dốc (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 để biểu thị điểm chính trong thang UAQI (0-100): Kém / Rất tốt

    Số lượng truy vấn và chi phí được liên kết

    • API JavaScript của Maps: 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ả đều trên tải bản đồ hoặc chỉ khi người dùng chọn).
      • Lớp ô bản đồ nhiệt: mỗi hình ảnh ô có kích thước 256*256px và để 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 12-14 ô. Mỗi thẻ thông tin được kéo sẽ được tính là 1 đơn vị SKU.
    • API Tìm kiếm lân cận (mới): Cứ 20 địa điểm được hiển thị thì có 1 cụm từ tìm kiếm. Phương thức thanh toán khác nhau tuỳ thuộc vào Dữ liệu về địa điểm trong phản hồi cụm từ tìm kiếm.

    Kết luận

    Chúng tôi đã chỉ ra rằng API Chất lượng không khí có thể là một điểm dữ liệu quan trọng giúp người dùng quyết định địa điểm ghé thăm. Do đó, dữ liệu về Chất lượng không khí phải hiển thị sớm nhất có thể trong trải nghiệm tìm kiếm một cách cẩn trọng với lượng thông tin xuất hiện cùng 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:

    Người đóng góp

    Google duy trì bài viết này. Những cộng tác viên sau đây ban đầu đã viết bài đăng này.
    Tác giả chính:

    Thomas Anglaret | Kỹ sư giải pháp