このページは Cloud Translation API によって翻訳されました。

AirQualityIndex

JSON 表現
Color
- 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 では java.awt.Color のコンストラクタに簡単に指定できます。また、iOS では UIColor の +colorWithRed:green:blue:alpha メソッドにも簡単に指定できます。さらに、少しの作業で、JavaScript で CSS rgba() 文字列にフォーマットするのも簡単です。

このリファレンスページには、RGB 値の解釈に使用する絶対色空間に関する情報がありません（例: sRGB、Adobe RGB、DCI-P3、BT.2020）。デフォルトでは、アプリケーションは sRGB 色空間を想定する必要があります。

色の等価性を決定する必要がある場合、実装では、特に記載のない限り、赤、緑、青、アルファの値のすべてが最大で 1e-5 だけ異なる場合、2 つの色を等しいものとして扱います。

例（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 は透明色に相当します。これは、単純な浮動小数点スカラーではなくラッパーメッセージを使用します。これにより、デフォルト値が設定されたのか未設定値だったのかを区別できます。省略した場合、このカラーオブジェクトは単色としてレンダリングされます（アルファ値に 1.0 の値が明示的に指定されている場合と同様です）。