このドキュメントでは、Air Quality API を使用してリッチな場所検索エクスペリエンスを構築する方法 について説明します。大気質がファネルの最初から最後までユーザーにとって価値のあるシグナルとなり得る方法と、Air Quality API データを既存のエクスペリエンスに埋め込む方法について説明します。
ユースケースと付加価値
Air Quality API シグナルは、ユーザーが訪問する場所を探しているときなど 、さまざまな検索エクスペリエンスに組み込むことができます。Air Quality API は次の機能を提供します。
- リアルタイム * データと過去のデータ - 現在の状態を表す最新の正確なデータと、過去 30 日間のデータを 1 時間単位で取得できます。（* 屋外の大気質の 1 時間ごとのスナップショット）
- グローバル データとローカルデータ - 100 か国以上の全地域をカバーし、高度にローカライズされた（最大 500 m）Air Quality API データは、ユーザーが最適な場所を比較して決定するための重要なシグナルを提供します。
大気質は、近くの場所でも大きく異なる場合があります。
サンプルアプリ
エクスペリエンスの早い段階で大気質データを表示する
Air Quality API データを表示するには、主に次の 2 つの方法があります。
現在の状況 / 1 時間ごと: 個々の値を取得して、各場所に対して表示します。
（場所のピンに Air Quality API データを表示するセクションに移動）ヒートマップ タイル: 現在の屋外の大気質を表す色付きのレイヤを地図の上に重ねます。国固有のレイヤ インデックスを使用できます。
（地図に Air Quality API ヒートマップ レイヤを表示するセクションに移動）
場所のピンに Air Quality API データを表示する
- 場所のインデックスを選択します。世界共通 AQI またはローカル AQI（最大 70 種類の大気質指数（AQI）を使用できます）。大気質指数（AQI）は、米国環境保護庁（EPA）などの特定の国が、さまざまな計算方法、データソース、指定された目的に基づいて、さまざまな大気質レベルを分類する尺度です。
- 場所検索エクスペリエンスから直接、メインの 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 } ...
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 x 256 ピクセルで、モバイル デバイスまたはウェブに表示される標準的な地図をカバーするには 12 ～ 14 個のタイルが必要です。取得したタイルごとに 1 SKU ユニットとしてカウントされます。
- Nearby Search（新版）API: 表示される 20 か所ごとに 1 つのクエリ。クエリ レスポンスに含まれる場所データに応じて料金が異なります。
まとめ
Air Quality API は、ユーザーが訪問する場所を決定するうえで重要なデータポイントとなることを示しました。そのため、Air Quality データは、検索エクスペリエンスでできるだけ早く表示する必要があります。ただし、一度に表示される情報の量と、どのように表示されるかに注意する必要があります。
次のステップ
おすすめのドキュメント:
コントリビューター
Google がこの記事を管理しています。以下に、この記事の執筆者を示します。
主な執筆者:
Thomas Anglaret | ソリューション エンジニア