このドキュメントでは、Air Quality API を使用して充実した場所検索エクスペリエンスを構築する方法について説明します。開始からファネルの終盤まで、大気質がユーザーにとっての価値を示すシグナルとなり得ることと、Air Quality API のデータを既存のエクスペリエンスに組み込む方法を紹介します。
ユースケースと付加価値
Air Quality API シグナルは、ユーザーが訪問する場所を探しているときなど、さまざまな検索エクスペリエンスに適応できます。Air Quality API は以下を提供します。
- リアルタイム * および過去のデータ - 現在の状態を表す最新かつ正確なデータと、30 日間の期間内の 1 時間ごとのデータ。（*1 時間ごとの屋外大気質のスナップショット）
- グローバル データとローカルデータ - 100 か国以上の地域全体を網羅し、高度にローカライズされた（最大 5 億）Air Quality API データは、ユーザーが最適な場所を比較して決定するための重要なシグナルを提供します。
大気質は、近くの場所でも大幅に異なる場合があります
サンプルのチュートリアル
エクスペリエンスの早い段階で大気質データを表示します
Air Quality API データを表示するには、主に 2 つの方法があります。
現在の状況 / 時間単位: 地域ごとに表示する個別の値を取得します。
（「場所ピンに Air Quality API データを表示する」セクションに移動）ヒートマップ タイル: 現在の屋外大気質の状態を表す色付きのレイヤを地図上に重ねて表示します。国別のレイヤのインデックスを使用できます。
（「地図に Air Quality API ヒートマップ レイヤを表示する」セクションに移動）
位置を示すピンに Air Quality API データを表示
- ロケーション インデックスは、ユニバーサル AQI またはローカル AQI（最大 70 種類の大気質指数（AQI）から選択できます）。大気質指数（AQI）は、米国 EPA などの特定の国が、さまざまな計算方法、データソース、指定された目的に基づいて、さまざまな大気質レベルを分類する基準です。
- Place Search のエクスペリエンスから、Air Quality API の主な値と色コードを直接視覚化できます。
デフォルト ディスプレイには色コードのみを含めることができます。
ピンの選択に関する Air Quality API の情報をさらに表示します。
- ユニバーサル AQI / ローカル AQI の意味。
- 汚染物質レベル: 大気中の粒子と気体の尺度です。主要汚染物質、濃度、発生源と影響。
- 健康に関する推奨事項: 現在の大気質の状態に対して推奨される対応です。
- デフォルトで表示される情報レベルは、必要に応じて調整できます。ある場所のデータポイントは、他の場所との比較で役に立つことが多い点に留意してください。
大気質セクションの表示例
{
"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": …
}
}
- または、場所とのやり取りでのみ大気質データをクエリすることもできます。
- Air Quality API インデックスを使用して、付近の場所をフィルタできます。たとえば、ある地域の公園を検索すると、大気質が良好な公園のみが表示されます。
大気質レスポンス
...
"color":{
"red": 0.9490196,
"green": 0.98039216,
"blue": 0.019607844
}
...
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)
地図上に Air Quality API ヒートマップ レイヤを表示する
ヒートマップの色付きタイルは、次のような場面で役立ちます。
- を使用して、広範囲の概要を表示できます。
- その領域の微妙な違いをすばやく示すことができます。
Maps JavaScript API を ImateMapType とともに使用して、Google マップのビューポート全体をカバーするために必要な個々のタイルを表示します。ヒートマップ タイルは、ユーザーが地図をパン、ズーム、変更して更新すると更新されます。
ズームレベルの最大値は 16 です。
Air Quality API ヒートマップ タイルレイヤがハイパーローカル検索で表示されなくなることがあります。
一部の大気質指数の中から、ヒートマップのタイプを選択できます。
ユーザーが値とそのカラーランキングを理解できるように、カラースケールを指定します。
- 勾配スケール UAQI（0 ～ 100）: 低い / 非常に良い
カラーパレットの CSS コード スニペット:
.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 */
);
}
- UAQI（0 ～ 100）で重要なポイントを表す単色: 低い / 非常に良い
クエリの数と関連する費用
- Maps JavaScript API: エクスペリエンスの読み込み時に 1 つの地図
- Air Quality API:
- 場所ごとに 1 つのクエリ（すべて地図の読み込み時、またはユーザー選択時のみ）。
- ヒートマップ タイルレイヤ: すべてのタイル画像は 256×256 ピクセルで、モバイル デバイスやウェブに表示される標準的な地図をカバーするには、12 ～ 14 個のタイルが必要です。取得した各タイルは 1 SKU 単位としてカウントされます。
- Nearby Search（新）API: 表示される場所 20 か所ごとに 1 件のクエリを行います。クエリ レスポンスに含まれる場所データに応じて課金が異なる。
おわりに
Air Quality API が、ユーザーが訪問先を決めるための重要なデータポイントになり得ることを示しました。そのため、大気質データは、一度に表示される情報の量と表示方法に応じて、できるだけ早い段階で検索エクスペリエンスで表示されるようにする必要があります。
次のアクション
関連情報:
協力者
この記事は Google が管理しています。最初に書いたのは以下の寄稿者です。
主任著者:
Thomas Anglaret | ソリューション エンジニア