目標
このドキュメントでは、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 スプレッドシートのテンプレート
このソリューションは、カスタムの Apps Script 関数が付属する Google スプレッドシートです。この関数は、Address Validation API にリクエストを順番に実行します。
次の手順に沿って API で住所を実行できます（Google アカウントと API キーが必要です）。
- サンプル スプレッドシートに移動し、メニューから [ファイル] > [コピーを作成] を選択します。
（Google アカウントにログインするか、アカウントを作成する必要があります） - Address Validation API を有効にして、Cloud Console から API キーを生成します。
- [API Key + Dashboard] シートタブで、B2 セルを API キーに置き換えます。
- テンプレートに住所をコピー/貼り付け（別のシートでデータをフォーマット: 番地、名前、市区町村、郵便番号を連結）
- シートのセルを選択し、メニューから [住所の確認] > [Address Validation API の選択] を選択します。
- 初回実行時に、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 | ソリューション エンジニア