Address Validation API クイック リファレンス

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: 設定

公式の 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 でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。