Đối tượng cơ bản để thể hiện các chỉ số chất lượng không khí. Khi được kết hợp với nhau, những chỉ số này cung cấp thông tin tổng quan nhanh về tình trạng chất lượng không khí hiện tại. Trên thế giới, có nhiều chỉ số đo lường với nhiều mục đích và nhóm quan tâm đến việc đo lường nhiều khía cạnh của chất lượng không khí.
| Biểu diễn dưới dạng JSON |
|---|
{
"code": string,
"displayName": string,
"aqiDisplay": string,
"color": {
object ( |
| Các trường | |
|---|---|
code |
Mã của chỉ mục. Trường này đại diện cho chỉ mục cho mục đích lập trình bằng cách sử dụng chữ viết thường thay vì dấu cách. Ví dụ: "uaqi", "fra_atmo". |
displayName |
Biểu thị tên chỉ mục mà con người có thể đọc được. Ví dụ: "AQI (Hoa Kỳ)" |
aqiDisplay |
Trình bày bằng văn bản của điểm số của chỉ mục, có thể bao gồm các ký hiệu tiền tố hoặc hậu tố, thường thể hiện điểm số chỉ mục kém nhất. Ví dụ: >100 hoặc 10+. Lưu ý: Bạn nên sử dụng trường này khi muốn hiển thị điểm số trong chỉ mục. Đối với chỉ mục không phải số, trường này trống. |
color |
Màu sắc dùng để thể hiện điểm số AQI. |
category |
Phân loại văn bản của việc diễn giải điểm số chỉ mục. Ví dụ: "Chất lượng không khí tuyệt vời". |
dominantPollutant |
Ký hiệu hoá học của chất gây ô nhiễm chủ yếu. Ví dụ: "CO". |
aqi |
Điểm số của chỉ mục. Ví dụ: 10, 100. Giá trị này không được chuẩn hoá và chỉ nên được diễn giải theo ngữ cảnh của chỉ số chất lượng không khí có liên quan. Đối với chỉ mục không phải là số, trường này sẽ không được trả về. Lưu ý: Trường này sẽ được dùng để tính toán, hiển thị biểu đồ, v.v. Để hiển thị điểm chỉ mục, bạn nên sử dụng trường hiển thị AQI. |
Màu
Đại diện cho một màu trong hệ màu RGBA. Bản trình bày này được thiết kế để đơn giản hoá việc chuyển đổi sang và từ các bản trình bày màu sắc bằng nhiều ngôn ngữ hơn là tính nhỏ gọn. Ví dụ: các trường của cách biểu diễn này có thể được cung cấp đơn giản cho hàm khởi tạo của java.awt.Color trong Java; cũng có thể cung cấp thông tin đơn giản cho phương thức +colorWithRed:green:blue:alpha của UIColor trong iOS; và chỉ cần thực hiện một chút thao tác, bạn có thể dễ dàng định dạng chuỗi thành chuỗi CSS rgba() trong JavaScript.
Trang tham khảo này không có thông tin về hệ màu tuyệt đối cần dùng để diễn giải giá trị RGB, ví dụ: sRGB, Adobe RGB, DCI-P3 và BT.2020. Theo mặc định, các ứng dụng phải giả định hệ màu sRGB.
Khi cần quyết định sự cân bằng màu, việc triển khai (trừ phi có tài liệu khác) coi hai màu là như nhau nếu tất cả giá trị đỏ, xanh lục, xanh dương và alpha của các màu đó chênh lệch tối đa là 1e-5.
Ví dụ (Java):
import com.google.type.Color;
// ...
public static java.awt.Color fromProto(Color protocolor) {
float alpha = protocolor.hasAlpha()
? protocolor.getAlpha().getValue()
: 1.0;
return new java.awt.Color(
protocolor.getRed(),
protocolor.getGreen(),
protocolor.getBlue(),
alpha);
}
public static Color toProto(java.awt.Color color) {
float red = (float) color.getRed();
float green = (float) color.getGreen();
float blue = (float) color.getBlue();
float denominator = 255.0;
Color.Builder resultBuilder =
Color
.newBuilder()
.setRed(red / denominator)
.setGreen(green / denominator)
.setBlue(blue / denominator);
int alpha = color.getAlpha();
if (alpha != 255) {
result.setAlpha(
FloatValue
.newBuilder()
.setValue(((float) alpha) / denominator)
.build());
}
return resultBuilder.build();
}
// ...
Ví dụ (iOS / Obj-C):
// ...
static UIColor* fromProto(Color* protocolor) {
float red = [protocolor red];
float green = [protocolor green];
float blue = [protocolor blue];
FloatValue* alpha_wrapper = [protocolor alpha];
float alpha = 1.0;
if (alpha_wrapper != nil) {
alpha = [alpha_wrapper value];
}
return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
}
static Color* toProto(UIColor* color) {
CGFloat red, green, blue, alpha;
if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
return nil;
}
Color* result = [[Color alloc] init];
[result setRed:red];
[result setGreen:green];
[result setBlue:blue];
if (alpha <= 0.9999) {
[result setAlpha:floatWrapperWithValue(alpha)];
}
[result autorelease];
return result;
}
// ...
Ví dụ (JavaScript):
// ...
var protoToCssColor = function(rgb_color) {
var redFrac = rgb_color.red || 0.0;
var greenFrac = rgb_color.green || 0.0;
var blueFrac = rgb_color.blue || 0.0;
var red = Math.floor(redFrac * 255);
var green = Math.floor(greenFrac * 255);
var blue = Math.floor(blueFrac * 255);
if (!('alpha' in rgb_color)) {
return rgbToCssColor(red, green, blue);
}
var alphaFrac = rgb_color.alpha.value || 0.0;
var rgbParams = [red, green, blue].join(',');
return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};
var rgbToCssColor = function(red, green, blue) {
var rgbNumber = new Number((red << 16) | (green << 8) | blue);
var hexString = rgbNumber.toString(16);
var missingZeros = 6 - hexString.length;
var resultBuilder = ['#'];
for (var i = 0; i < missingZeros; i++) {
resultBuilder.push('0');
}
resultBuilder.push(hexString);
return resultBuilder.join('');
};
// ...
| Biểu diễn dưới dạng JSON |
|---|
{ "red": number, "green": number, "blue": number, "alpha": number } |
| Các trường | |
|---|---|
red |
Lượng màu đỏ trong màu dưới dạng một giá trị trong khoảng [0, 1]. |
green |
Lượng màu xanh lục trong màu dưới dạng một giá trị trong khoảng [0, 1]. |
blue |
Lượng màu xanh dương trong màu dưới dạng một giá trị trong khoảng [0, 1]. |
alpha |
Phần màu này sẽ được áp dụng cho pixel. Tức là màu pixel cuối cùng được xác định theo phương trình:
Điều này có nghĩa rằng giá trị 1.0 tương ứng với một màu đồng nhất, trong khi giá trị 0.0 tương ứng với một màu đồng nhất. Thao tác này sử dụng thông báo trình bao bọc thay vì đại lượng vô hướng số thực đơn giản để có thể phân biệt giữa giá trị mặc định và giá trị chưa được đặt. Nếu bị bỏ qua, đối tượng màu này sẽ hiển thị dưới dạng một màu đồng nhất (như thể giá trị alpha đã được chỉ định rõ ràng là 1.0). |