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"]
},
}
住所リクエスト フィールド
リクエストの本文は、次の 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 オプションに慣れることができます。
API アイコン
を選択します。 。
必要に応じて [標準パラメータを表示] を開き、
fields
を設定します。 パラメータを フィールド マスクします。必要に応じて、[Request body] を編集します。
[Execute] ボタンを選択します。ダイアログで、統合するアカウントを選択します。 使用します。
[API Explorer] パネルで、[展開] アイコンを選択します。
: API Explorer ウィンドウを展開します。
-
Google Maps Platform は、米国の非独占的なライセンシーです。 Postal Service®。次の商標は米国が所有しています Postal Service®、許可を得て使用: United States Postal Service®、 CASSTM、CASS CertifiedTM↩