出力

GetPostalCodes は、指定された都市の郵便番号を返します。各郵便番号は、以下の表に列挙されたデータとともにそれぞれ個別のレコードで返されます。

表 1. GetPostalCodes の出力

フィールド名

説明

City.Type

USPS® の都市タイプ (米国住所のみ)。住所のみ)。都市タイプを判別するには、ZIP Code と都市名を調べます。例えば、メリーランド州ランハムの郵便番号は、20703、20706、および 20784 です。ランハムは、20703 と 20706 では主要都市ですが、20784 では非正式都市です。

このフィールド列に値が設定されるのは、OutputCityType=Yの場合のみです。有効な値を次に示します。

V
非正式 (Non-Mailing) 都市名。
P
主要都市名。都市名は、主要な郵送都市名です。
S
補助的な都市名。都市名は、代替都市名ですが、許容されます。都市は複数の補助的な都市名を持つことができます。

PostalCode

指定された都市の郵便番号。

ProcessedBy

このサービスは米国住所に対してのみ機能するため、ProcessedBy には常に USA という 1 つの値が含まれます。

Status

マッチの成功または失敗。

NULL
成功
F
失敗

Status.Code

失敗の原因 (ある場合)。次のいずれかです。

  • CountryNotSupported
  • UnableToLookup

Status.Description

失敗の説明。

  • 入力された国がサポートされていません
  • 入力された都市が空白でした
  • 入力された都市と州 / 省が空白であったか、一致が見つかりませんでした
  • 都市と州の不一致 (スペルの相違が見つかるか、都市/州が非正式都市であるが、非正式マッチングが許可されていないか、都市/州が ZIP Code と一致しない)