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

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

リクエストでは、検証するアドレスを定義する 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"]
  },
}

試してみる

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

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

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

address フィールドを Address Validation API に送信するときに指定するフィールドは、addressLines のみです。ただし、最もシンプルな住所リクエストには、次のサブフィールドを含める必要があります。

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

USPS CASSTM オプション

米国郵便公社（USPS®）1 は、住所検証プロバイダをサポートおよび認定するために、コーディング精度サポート システム（CASSTM）を維持しています。

米国とプエルトリコのリージョンに限り、リクエスト本文で 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. 必要に応じて、[標準パラメータを表示] を展開し、fields パラメータをフィールド マスクに設定します。

  2. 必要に応じて、[Request body] を編集します。

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

  4. [API Explorer] パネルで展開アイコン API Explorer を開きます。 を選択して、[API Explorer] ウィンドウを展開します。

  1. Google Maps Platform は、米国郵便公社の非独占的なライセンシーです。米国郵便公社の商標は米国郵便公社が所有し、同社の許可を得て使用しています: United States Postal Service®、CASSTM、CASS CertifiedTM↩

前へ
OAuth を使用する
次へ
基本的な対応を理解する