住所確認リクエストを送信する

次のいずれかのエンドポイントに POST リクエストを発行して、住所検証リクエストを送信します。

• validateAddress（REST）
• ValidateAddress（gRPC）

また、リクエストには、検証する住所を定義する JSON リクエスト本文を渡す必要があります。次のリクエスト本文には、1 つのフィールドと 3 つのサブフィールドが含まれます。

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY"

locality を省略し、addressLines 配列の要素として指定することもできます。

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

住所リクエスト フィールド

リクエストの本文は、次の 1 つのフィールドで構成されます。

• address - PostalAddress 型のフィールド。addressLines のエントリを 1 つ以上含める必要があります。

address フィールドを Address Validation API に送信する場合、指定するフィールドは addressLines の 1 つだけです。最も簡単な住所リクエストでは、次のサブフィールドを含める必要があります。

• regionCode - 推奨。これは省略可能なフィールドですが、省略すると、Address Validation API は住所から地域を推測します。ただし、わかっている場合は regionCode を含めると、最適な結果が得られます。サポートされているリージョンの一覧については、サポートされているリージョンをご覧ください。
• addressLines - 必須。アドレスの下位構造を記述するアドレスを含む配列。

リファレンス ガイドの PostalAddress をご覧ください。

USPS CASSTM オプション

米国郵政公社（USPS®）¹は、住所検証プロバイダのサポートと認定のために、Coding Accuracy Support System（CASSTM）を維持しています。

米国と PR 地域の場合のみ、リクエスト本文で enableUspsCass を true に設定することで、CASS 処理を有効にできます。CASS を使用する際は、番地、市区町村、都道府県、郵便番号を含む住所を指定することをおすすめします。

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}