Address Validation API は、住所を受け取り、その構成要素を識別して検証し、郵送用の住所を標準化して、その住所に最適な既知の緯度と経度の座標を返します。米国とプエルトリコの住所については、必要に応じて USPS CASS 処理を有効にできます。
Address Validation API: 主な特長
- プロダクト: Address Validation API
- カテゴリ: 場所
- プラットフォーム: ウェブサービス(REST)
- 実行場所: サーバー(バックエンド コード)
- リリース ステージ: GA
- ライフサイクル: アクティブ
- 概要: Address Validation API の概要
- 対象地域: 制限あり。サポートされている国とデータ品質は国によって異なり、一部の国はプレビュー版です。住宅と商業施設のメタデータは、カバレッジ ページでフラグが設定されている国でのみ返されます。USPS CASS は、米国とプエルトリコでのみサポートされています。(カバレッジの詳細)
Address Validation API: 使用するタイミング
Address Validation API を使用するケース:
- 住所が実在する場所を指しているかどうかを確認し、欠落しているコンポーネントや間違っている可能性のあるコンポーネントを特定する必要があります。
- 購入手続きのフローなどで、郵送用の住所を標準化して完成させる必要がある。
- 米国またはプエルトリコの住所には、USPS CASS 認定の検証と
uspsDataが必要です。 - カバレッジ ページに記載されている国の居住地または商用住所のメタデータが必要です。
Address Validation API を使用すべきでない場合:
- 住所を緯度 / 経度に変換するだけで、個々のアドレス コンポーネントを検証する必要はありません。代わりに Geocoding API を使用してください。
- 建物の入り口、建物の輪郭、ナビゲーション ポイントなど、非常にローカルな目的地の詳細が必要な場合。代わりに Geocoding API を使用してください。
Address Validation API: 設定
- 有効にするサービス:
addressvalidation.googleapis.com - 認証: API キー、OAuth 2.0、サービス アカウント
- 使ってみる: Address Validation API を設定する
- リファレンス: Address Validation API リファレンス
- 料金: Address Validation API の使用量と請求額
- ポリシー: Address Validation API のポリシー
- リリースノート: Address Validation API のリリースノート
公式の Address Validation API パッケージ:
- npm:
@googlemaps/addressvalidation - pypi:
google-maps-addressvalidation - go:
cloud.google.com/go/maps
Address Validation API: よくある間違い
- 問題:
addressCompleteプロパティの値がfalseの場合、このプロパティは判定から除外されます。そのため、このフィールドが存在することを想定しているコードは、不完全な住所を誤って読み取る可能性があります。修正:addressCompleteプロパティがない場合はfalseとして扱うか、プロパティの有無を確認します。/maps/documentation/address-validation/understand-response をご覧ください。 - 問題:
regionCodeが省略されている場合、API は住所から地域を推測するため、結果の精度が低下する可能性があります。修正方法:regionCodeがわかっている場合は、PostalAddressに含めます。/maps/documentation/address-validation/requests-validate-address をご覧ください。 - 問題:
uspsDataオブジェクトは、検証済みの米国の住所すべてに対して完全に入力されるとは限りません。修正:uspsDataのみを検証シグナルとして使用するのではなく、判定と住所コンポーネントも使用します。/maps/documentation/address-validation/handle-us-address をご覧ください。 - 問題:
provideValidationFeedbackで送信されるフィードバックは、シーケンス内の最初のvalidateAddress呼び出しのresponseIdを参照する必要があります。修正方法: 最初のvalidateAddressレスポンスからresponseIdを保存し、フィードバック リクエストで送信します。/maps/documentation/address-validation/handle-updated-address をご覧ください。
Address Validation API でできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
- 指定された住所または住所の一部に対して、検証済みの住所を返します。
- 検証済みの住所の緯度と経度の座標を返す。
- 検証済みの住所の Google プレイス ID を返します。
- Address Validation に米国郵政公社(USPS)の Coding Accuracy Support System(CASS)認証を使用する。
- 検証済みの住所がビジネス、住宅、私書箱のいずれであるかに関する情報を返します。
- 検証済み住所の米国郵便公社(USPS)の配送メタデータを返します。
- 検証済み住所の英語版を返す。プレビュー
- 検証済みの住所の Plus Code を返す。