AirQualityIndex

• การแสดง JSON
• สี
  • การแสดง JSON

วัตถุพื้นฐานสำหรับการแสดงเมตริกคุณภาพอากาศที่แตกต่างกัน เมื่อนำมารวมกัน เมตริกเหล่านี้จะแสดงภาพรวมเกี่ยวกับสภาวะคุณภาพอากาศปัจจุบัน โลกมีดัชนีหลายชนิดที่รองรับวัตถุประสงค์และกลุ่มต่างๆ ที่สนใจในการวัดคุณภาพอากาศในด้านต่างๆ

การแสดง JSON
{ "code": string, "displayName": string, "aqiDisplay": string, "color": { object (Color) }, "category": string, "dominantPollutant": string, "aqi": integer }

ช่อง
code	string โค้ดของดัชนี ฟิลด์นี้แสดงดัชนีสำหรับจุดประสงค์ในการเขียนโปรแกรมโดยใช้ลักษณะตัวพิมพ์ของงูแทนการเว้นวรรค เช่น "uaqi", "fra_atmo"
displayName	string การแสดงชื่อดัชนีที่มนุษย์อ่านได้ ตัวอย่างเช่น "AQI (สหรัฐอเมริกา)"
aqiDisplay	string ข้อความแสดงคะแนนตัวเลขของดัชนี ซึ่งอาจมีสัญลักษณ์นำหน้าหรือต่อท้าย ซึ่งมักแสดงถึงคะแนนดัชนีที่แย่ที่สุด ตัวอย่างเช่น >100 หรือ 10+ หมายเหตุ: ควรใช้ฟิลด์นี้เมื่อคุณต้องการแสดงคะแนนดัชนี สำหรับดัชนีที่ไม่ใช่ตัวเลข ช่องนี้จะว่างเปล่า
color	object (Color) สีที่ใช้แสดงคะแนนตัวเลข AQI
category	string การจัดประเภทแบบข้อความของการแปลค่าตัวเลขดัชนี เช่น "คุณภาพอากาศดีเยี่ยม"
dominantPollutant	string สัญลักษณ์ทางเคมีของสารมลพิษที่โดดเด่น เช่น "CO"
aqi	integer คะแนนที่เป็นตัวเลขของดัชนี เช่น 10, 100 โปรดทราบว่าค่าดังกล่าวไม่ได้ทําให้เป็นมาตรฐาน และควรตีความในบริบทของดัชนีคุณภาพอากาศที่เกี่ยวข้องเท่านั้น สำหรับดัชนีที่ไม่ใช่ตัวเลข ระบบจะไม่แสดงผลช่องนี้ หมายเหตุ: ควรใช้ฟิลด์นี้สำหรับการคำนวณ การแสดงกราฟ ฯลฯ สำหรับการแสดงคะแนนดัชนี คุณควรใช้ฟิลด์การแสดงผล AQI

สี

แสดงสีในพื้นที่สี RGBA การนำเสนอนี้ออกแบบมาเพื่อความเรียบง่ายในการแปลงไปเป็นและเปลี่ยนจากการแสดงสีในภาษาต่างๆ มากกว่าความกะทัดรัด ตัวอย่างเช่น ช่องของการนำเสนอนี้สามารถใส่ลงในตัวสร้างของ java.awt.Color ใน Java ได้ ช่องเหล่านี้ยังสามารถใส่ลงในเมธอด +colorWithRed:green:blue:alpha ของ UIColor ใน iOS ได้เพียงเล็กน้อย และสามารถจัดรูปแบบให้เป็นสตริง CSS rgba() ใน JavaScript ได้โดยง่าย ด้วยการทำงานเพียงเล็กน้อย

หน้าอ้างอิงนี้ไม่มีข้อมูลเกี่ยวกับพื้นที่สีสัมบูรณ์ที่ควรใช้เพื่อตีความค่า RGB เช่น sRGB, Adobe RGB, DCI-P3 และ BT.2020 โดยค่าเริ่มต้น แอปพลิเคชันควรใช้พื้นที่สี sRGB

เมื่อต้องตัดสินใจเรื่องความเท่าเทียมของสี การติดตั้งใช้งานจะถือว่า 2 สีเท่ากันหากค่าสีแดง เขียว น้ำเงิน และอัลฟ่าทั้งหมดแตกต่างกันไม่เกิน 1e-5 สี

ตัวอย่าง (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();
 }
 // ...

ตัวอย่าง (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;
}
// ...

ตัวอย่าง (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('');
};

// ...

การแสดง JSON
{ "red": number, "green": number, "blue": number, "alpha": number }

ช่อง
red	number จํานวนสีแดงในสีเป็นค่าในช่วง [0, 1]
green	number ปริมาณสีเขียวในสีเป็นค่าในช่วง [0, 1]
blue	number จํานวนสีน้ำเงินในสีเป็นค่าในช่วง [0, 1]
alpha	number ส่วนของสีนี้ที่ควรนำไปใช้กับพิกเซล นั่นคือ สีพิกเซลสุดท้ายจะกำหนดด้วยสมการต่อไปนี้ pixel color = alpha * (this color) + (1.0 - alpha) * (background color) หมายความว่าค่า 1.0 หมายถึงสีทึบ ขณะที่ค่า 0.0 หมายถึงสีที่โปร่งใสทั้งหมด การดำเนินการนี้จะใช้ข้อความ Wrapper แทนสเกลาร์ลอยตัวแบบง่ายเพื่อให้แยกความแตกต่างระหว่างค่าเริ่มต้นและค่าที่ยังไม่ได้ตั้งค่าได้ หากไม่ระบุ วัตถุสีนี้จะแสดงเป็นสีทึบ (เสมือนว่าค่าอัลฟ่าได้รับการกำหนดไว้อย่างชัดแจ้งเป็น 1.0)