目標
このドキュメントでは、Google スプレッドシートで Address Validation API を使用して、サービスをすばやく簡単にテストする方法について説明します。
デベロッパー以外のユーザーは、Google Maps Platform から取得したデータ（Address Validation API など）を扱う一方で、技術チームのサポートをあまり受けずにサービスを利用できるようにしたいと考えています。
ユースケース
次に、Google スプレッドシートの Address Validation API が役立つユースケースを見てみましょう。
- トライアル: ビジネスでは、独自の住所を使用して Address Validation API の機能をすばやくテストできます。
- 比較: Address Validation API の結果を、Geocoding API や Places API などの他のエンドポイントの結果と比較します。
- A/B テスト: 同じデータセットの A/B テストを実施して、より適切な結果が得られるものを把握します。
Google スプレッドシートのテンプレート
解決策は、Address Validation API に対してリクエストを順番に実行するカスタム Apps Script 関数を備えた Google スプレッドシートです。
API で住所を実行する手順は次のとおりです（Google アカウントと API キーが必要です）。
- サンプル スプレッドシートに移動し、メニューから [ファイル] > [コピーを作成] を選択します
（Google アカウントにログインするか、アカウントを作成する必要があります） - Address Validation API を有効にして、Cloud コンソールから API キーを生成します。
- [API Key + Dashboard] シートタブの B2 セルを API キーに置き換えます。
- 住所をテンプレートにコピー/貼り付けます（別のシートでデータをフォーマットします。番地、名前、市区町村、郵便番号を連結します）。
- シートのセルを選択し、メニューの [Address Validation] > [Address Validation API selection] を選択します。
- 初回実行時に、Apps Script へのアクセスを許可するための [承認が必要です] メッセージが表示されます。
Google Maps Platform の利用規約
このソリューションは、限定された一連のアドレスでテスト目的で提供されます。キャッシュ保存期間は連続 30 暦日です。その後、お客様は（1）キャッシュに保存された Google マップ コンテンツを削除するか、（2）エンドユーザーの確認または修正を通じて提供されたエンドユーザー データに置き換える必要があります。Google Maps Platform 利用規約の表 11.3.1（キャッシュ保存の権限）を参照してください。
- placeId
- 場所: 緯度値、経度値
- 判定
- formattedAddress
- postalAddress
- addressComponent: componentName
- USPS Data standardizedAddress
考慮事項
- パフォーマンス: 一度に 1,000 行以下のチャンクで処理します。スクリプトは最終的に停止することがあります（1 秒あたりの API 割り当てを超えた場合など）。スクリプトが停止した行から続行します。
- コードには、[メニュー] > [拡張機能] > [Apps Script] からアクセスできます。必要に応じて、独自のバージョンのスクリプトを作成できます。
- Address Validation API の料金。
まとめ
Google スプレッドシートの Address Validation API を使用すると、デベロッパーでなくても Address Validation API へのクエリを開始して、ビジネスにとってどのように戦略的にできるかを把握できます。このドキュメントでは、API キーを作成し、用意されている Google スプレッドシート テンプレートを使用して、API のクエリを開始する方法を紹介します。
次のアクション
推奨する関連情報:
寄稿者
この記事は Google が管理しています。以下は、このガイドを最初に作成したコントリビューターです。
プリンシパル作成者:
Thomas Anglaret | ソリューション エンジニア