Google Maps Pinboard実装ガイド

はじめに

Google Maps PinboardのAppをインストールしていただきありがとうございます。このガイドは、このAppをご自身のデータと接続するためのサポートを目的として書かれたものです。最初のステップでは、AppのDataFlowがAppStoreから正しくダウンロードされていること、そしてデータがAppで適切に使用できる正しい形式になっていることを確認します。

必要条件

このAppは、Grid Builderという名前のツールを使用して、Appが必要とするスキーマにデータをマッピングします。Grid Builderにまだ慣れていない場合は、Grid Builderのウォークスルーをこちらで参照してください。必須ではありませんが、MySQLクエリがどのように機能するかについて実践的な知識もあると便利です。

下の図は、データがDataFlowを通って供給され、その後Google Maps Pinboar Appに出力される順序を示しています。

Grid Builderの動作に慣れたら、次のステップに従い、AppとDataFlowがDomoインスタンスに適切にデプロイされていることを確認します。

• AppStoreでAppを購入した場合は、AppStoreのAppページの［試してみる］ボタンをクリックしたことを確認します。これにより、AppとそのDataFlowがインスタンスにデプロイされます。DomoでAppを使用するページに名前を付けるように求められます。
• DataFlowがインスタンスに適切にデプロイされていることを再度確認します。確認するには、Domoの左上隅の［データ］ボタンをクリックしてData Centerに移動します（下の画像を参照してください）。
  
  
• Data Center画面左側で［DataFlow］を選択し、Data Centerの検索バーを使用して「Google Maps Pinboard」を検索します。検索した名前に一致するDataFlowが表示されます。
• 以上のステップに従っても作成したページ内や、DataFlow内にAppが見つからない場合、 テクニカルサポートまでお問い合わせください。サポートへのお問い合わせ方法については、「ヘルプとサポート」を参照してください。

ステップ 1：データの準備

Google Maps Pinboardは、地図上の表示ピンを介して位置データを表示します。つまり、データの各行が位置を表し、対応する列が位置の定量的または定性的なデータを表す形式でデータを取得する必要があります。位置は複数の行に一覧表示することができ、データが実行されると、Appは特定の位置に対するデータを集計します。Appが必要とする位置データの一部は、位置の緯度と経度です。 

経度と緯度データがない場合、次の3つの方法のいずれかで取得できます。

1. ジオコーディングアプリケーションを使用して位置データの経度と緯度を取得します
2. データを政府のデータベースに結合して、おおよその経度と緯度を取得します。これは通常、郵便番号やお住いの国の同等のコードで行われます。
3. 位置データの経度と緯度を得るためにサポートが必要な場合、 Domoコンサルタントまたはテクニカルサポートにお問い合わせください。サポートへのお問い合わせ方法については、「ヘルプとサポート」を参照してください。

データがどのように表示されるかの例を次に示します。

Appには「ID」、「ノード」、「日付」、「緯度」、「説明」という5つの必須フィールドがあります。「ID」は位置のIDであり、「ノード」は位置の名前です。位置のID番号がない場合は、「ID」と「ノード」の両方の列に位置名を使用することができます。また、データに「日付」フィールドがない場合は、代わりに必須となる列に現在の日付を使用することもできます。

Appに表示したり、フィルターとして使用したりするために追加可能な定量的データ列と定性的データ列の例として、ここでは「売上」と「地域」というラベルの付いた列を示しています。列は必要な数だけ追加できます。 

ステップ2：DataFlowにソースデータを追加

データの準備が完了したら、DomoのDataFlowに移動し、AppのDataFlowにデータを入力として追加する必要があります。次のステップに従い、データを追加します。

• 確認するには、Domoの左上隅の［データ］ボタンをクリックしてData Centerに移動します（下の画像を参照してください）。
  
  
• Data Centerを開いたら、左側のDataFlowアイコンを選択します。Data Centerの検索バーで「Google Maps Pinboard」を検索します。「Google Maps Pinboard」と書かれたDataFlowが表示されているはずです。 
• DataFlowを選択して詳細ビューに進み、ページ右側の鉛筆のアイコンをクリックして、DataFlowを編集します。
• DataSetの右上隅の「x」をクリックして、サンプルDataSet「Google Maps Store Sample」を削除します。「Google Maps Pinboard - Grid Builder」と「Google Maps Pinboard - 設定」をDataFlowの入力として保持します。
• 「DataSetを選択」ボタンをクリックして、DataFlowにDataSetを追加します。
• DataSetを追加したら、ページの下部までスクロールし、［保存］ボタンをクリックします。
• DomoのData Centerに戻ります。

ステップ3：Grid Builderを編集

3番目のステップでは、入力データと一致するようにGrid Builderの適切なフィールドを編集する必要があります。このガイドでは基本的なステップを説明しますが、Grid Builderの機能に関するより包括的なチュートリアルについては、「Grid Builderのウォークスルー」を参照してください。変更を加えたときに、ウェブブラウザにプロセス全体でエラーが発生した場合に備えて、作業内容をExcelスプレッドシートにコピーしてすべての変更を追跡することをお勧めします。

Grid Builderを編集するには、以下のステップに従ってください。

• Appに付属するGrid Builderウェブフォームに進みます。「Google Maps PinboardGrid Builder」という名前になります。Data Centerの左側から［DataSet］を選択し、「Google Maps PinboardGrid Builder」を検索します。DataSetをクリックし、詳細ビューで右側にあるスパナメニューアイコンをクリックし、次に［ウェブフォームを編集］をクリックします。 
• このAppは通常、日付フィルターを使用しませんが、フィルターを含めたい場合、「Grid Builderのウォークスルー」を参照してください。
• FROM列で、最初のDataSetの名前に一致するようにC100行の値を変更します（下の画像例の#1を参照してください）。
• SELECT列で、行の値をDataSetの列名と置き換えます。これで、FROM列に表示されます。最初の5行（C100からC500）が必須フィールドです。最初の行で、位置IDとして使用するデータから列の名前を入力します。位置IDがない場合は、位置名列をここで使用することができます。2行目に、日付がある場合は日付列の名前を入力します。現在の日付を使用する場合は、値を「CURRENT_DATE()」のままにします。3行目には位置名列を使用します。4行目には緯度の列、5行目には経度の列を使用します。以上5つの行は、この順序でなければなりません（下の画像例の#2を参照してください）。

• SELECT列に、メトリクスの追加の定量列およびフィルターの定性列として使用するDataSetの列の名前を入力します。
• AS列では、最初の5行の値は決して変更しないでください。これらは、データがマップされている名前であり、AppのDataFlowが想定している名前です。追加の定量的および定性的メトリクスの情報がある行については、必要に応じて、これらの列をこの列に再入力するか、新しい名前を選択することができます（上の画像例の#3を参照してください）。
• INCLUDE列は空白のままにするか、情報を入力した各行に「1」を含める必要があります（上の画像例の#4を参照してください）。
• 追加の表を結合する場合は、結合する追加のテーブルに対してこのプロセスを繰り返します。新しいDataSetはそれぞれ、「C」列の100個単位の値の、次の一組に割り当てる必要があります。追加の結合は通常、「JoinType」にLEFTを使用し、最初のDataSetの日付と位置で結合します。例えば、結合条件は以下のようになります。C100.Node = C200.Location AND C100.Date = C200.Date。「JoinType」と「JoinCondition」列の編集とGrid Builderの結合の詳細については、「Grid Builderのウォークスルー」を参照してください（上の画像例の#5を参照してください）。
• DataSetの情報を入力すると、すぐにフィルターの設定が必要になります。フィルターとして使用するGrid Builderの行で、「FilterId」、「FilterName」、「FilterInputType」の3つのフィルター列を更新する必要があります。 
• 上から順に、フィルターとして使用される各行に、「FilterId」列の後続の行ごとに1から始まり番号が増えるよう割り当てます。「FilterName」の列でフィルターに名前を付け、「FilterInputType」の列の値に「複数選択」または「単一選択」のいずれかを選択します。（複数選択と単一選択フィルタータイプが何をするかの詳細については、「Grid Builderのウォークスルー」を参照してください）。
• 最後に、ページの上部にある［保存して次へ］を選択してDataSetを保存します。 

Grid Builderに必要な変更を加えたら、Data Centerに移動し、Google Maps Pinboard DataFlowを実行します。DataFlowが正常に実行された場合、Grid Builderに正しく入力されているはずです。エラーが発生した場合は、「Grid Builderのウォークスルー」を参照するか、テクニカルサポートにお問い合わせください。サポートへのお問い合わせ方法については、「ヘルプとサポート」を参照してください。

ステップ4：メトリクスフォームを編集

Appを設定する最後のステップは、メトリクスフォームを編集することです。

次のステップに従ってメトリクスフォームを編集します。

• Data Centerで、メトリクスフォームに移動します。「Google Maps Pinboard - メトリクス」という名前になります。
• DataSetを選択し、スパナメニューを選択してウェブフォームを編集します。

• Appで表示させたいメトリクスごとに、フォームの行に記入します。最初の列は「Id」列なので、各メトリクスに1から始まり、前の行に1つずつ増加する1つの番号を割り当てます。
• 「Name」列に、Appで表示するメトリクスの名前を入力します。
• 「Calculation」列に、各メトリクスの計算を入力します。単純な計算しかサポートされていません。単純な合計、平均、最大、最小を使用できます。計算には以下のようなものがあります。「SUM(column)」または「AVG(column)」、単純な単一演算「SUM(columnA)」+「SUM(columnB)」、「SUM(columnA)」* MIN(columnB)」、比率計算「 SUM(columnA)/ "SUM(columnB)* 100"などです。もっと複雑な計算は、あらかじめGrid Builderで計算しておく必要があります。 
• 「DataType」列に「通貨」、「数字」、「パーセント」のいずれかを入力します。これにより、Appにメトリクスの表示方法を指示します。 
• 「SortHighToLow」列で、メトリクスの棒チャートを最高から最低の順に表示する場合、「true」と入力します。メトリクスの棒チャートを最低から最高の順に表示する場合、「false」と入力します。
• 「UnitOfMeasurement」列に、メトリクスの単位を書き入れるか、行を空白にします（例：ドル、人数、リファーラルなど）。
• 「Description」列で、メトリクスに関する簡単な説明を入力するか、行を空白にします。

ステップ5：検証

Grid Builderとメトリクスフォームを設定したら、Appをチェックしてメトリクスを検証する準備が整います。検証には以下のプロセスをお勧めします。

1. KPIカードを作成してメトリクスをテストします。Appの出力データではなく、ソースデータに基づいてこれらのカードを作成します。例えば、Appで位置別の売上を表示する場合は、位置別の売上を表示する棒チャートタイプのカードを作成します。この場合には、KPIカードの日付範囲が、Appで表示されている日付範囲と一致させます。
2. KPIカードのデータをAppのデータと比較します。フィルターのオプションと日付範囲がAppとKPIカードで一致していることを確認してください。
3. 不一致があれば、Grid Builderで結合条件やグループ化を変更する必要があるか確認してください。計算も必ず再チェックしてください。 
4. 検証する必要があるメトリクスがあれば、この処理を繰り返します。

おめでとうございます。

Google Maps Pinboard Appが利用できるようになりました。データを最大限に活用しましょう。Appに問題があるかサポートが必要な場合は、テクニカルサポートにお問い合わせください。サポートへのお問い合わせ方法については、「ヘルプとサポート」を参照してください。