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

次のいずれかのエンドポイントに 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=API_KEY"

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

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

API Explorer を使用すると、ライブ リクエストを行って、API と API オプションを理解できます。

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

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

• address - PostalAddress 型のフィールド。addressLines に少なくとも 1 つのエントリを含める必要があります。

address フィールドを Address Validation API に送信する場合は、addressLines フィールドを 1 つだけ指定する必要があります。ただし、最もシンプルなアドレス リクエストには次のサブフィールドが含まれている必要があります。

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

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

USPS CASS™ オプション

United States Postal Service®（USPS®）¹ は、住所検証サービスのプロバイダを支援し認定するために、Coding Accuracy Support System（CASS™）を運営しています。

米国とプエルトリコのリージョンでのみ、リクエスト本文で enableUspsCass を true に設定して CASS 処理を有効にできます。CASS を使用して最良の結果を得るには、市区町村、都道府県、郵便番号とともに、番地と町名を含む住所を指定します。

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

試してみよう:

API Explorer を使用すると、サンプル リクエストを作成して、API と API オプションを理解できます。

1. ページの右側にある API アイコン api を選択します。

2. 必要に応じてリクエスト パラメータを編集します。

3. [Execute] ボタンを選択します。ダイアログで、リクエストに使用するアカウントを選択します。

4. API Explorer パネルで、全画面アイコン fullscreen を選択して API Explorer ウィンドウを拡大します。