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

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 という 1 つのフィールドを指定します。ただし、最もシンプルなアドレス リクエストは 次のサブフィールドが含まれている必要があります。

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

USPS CASSTM オプション

米国郵便公社®（USPS®）1は、 Coding Accuracy Support System（CASSTM）: サポートと認定 アドレス検証プロバイダ

米国とプエルトリコのリージョンの場合のみ、CASS 処理を有効にするには、 リクエスト本文の enableUspsCass を true にします。最良の結果を得るには CASS の場合は、番地と番地を含む住所を入力してください。 都市、州、郵便番号:

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

試してみよう:

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

  1. API アイコン API Explorer を開きます。 を選択します。 。

  2. 必要に応じて [標準パラメータを表示] を開き、fields を設定します。 パラメータを フィールド マスクします。

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

  4. [Execute] ボタンを選択します。ダイアログで、統合するアカウントを選択します。 使用します。

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

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

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