目標
このドキュメントでは、Google スプレッドシートで Address Validation API を使用して、サービスを迅速かつ簡単にテストする方法について説明します。
デベロッパーではないものの、Address Validation API などの Google Maps Platform から取得したデータを活用したいと考えている場合は、技術チームのサポートをあまり受けずにサービスを開始する方法を探すことをおすすめします。
ユースケース
次に、Google スプレッドシートの Address Validation API が役立つユースケースについて説明します。
- トライアル: ビジネスでは、自社のアドレスを使用して Address Validation API の機能をすばやくテストしたい場合があります。
- 比較: Address Validation API の結果を、Geocoding API や Places API などの他のエンドポイントの結果と比較します。
- A/B テスト: 同じデータセットのバリエーションを A/B テストして、より適切な結果が得られる可能性のあるものを把握します。
Google スプレッドシートのテンプレート
このソリューションは、Google スプレッドシートにカスタムの Apps Script 関数を組み込み、Address Validation API にリクエストを順番に送信するものです。
以下の手順に沿って、API でアドレスを実行できます（Google アカウントと API キーが必要です）。
- サンプル スプレッドシートに移動し、メニューから [ファイル] > [コピーを作成] を選択します。
（Google アカウントにログインするか、アカウントを作成する必要があります） - Address Validation API を有効にし、Cloud Console から 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
- 位置情報: 緯度値、経度値
- verdict
- 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 | ソリューション エンジニア\