入力

GeocodeUSAddress は、入力として住所を受け取ります。GeocodeUSAddress で最大のパフォーマンスと最良のマッチ結果を得るには、入力住所が可能な限り完全で、綴りの誤りや不完全な住所がない必要があります。最も高いマッチ率を得るには、入力住所を可能な限り USPS 規格に近づける必要があります。USPS 規格の詳細については、USPS Web サイト http://www.usps.com を参照してください。

入力住所にはストリート住所行と最終行が分かれた常態か、1 行に連結された状態で含まれる必要があります。このフォーマットになっていれば、GeocodeUSAddress は、都市、州、および ZIP Code に基づいてマッチ候補を検索するエリアを正確に特定できます。ただし、最終行に都市、州、および ZIP Code がすべて揃っていなくても、都市名さえあれば候補のマッチングは実行されます。詳細については、都市のみの最終行マッチングを参照してください。

GeocodeUSAddress は、1 行の最終行に入力するのではなく、都市、州、および ZIP Code を 1 行ずつに分けたフォーマットのストリート住所も受け付けます。このタイプの入力は、入力住所に綴りの誤りや欠落がないことに確信がある場合にのみ使用してください。

住所の標準化に GeocodeUSAddress を使用している場合は、入力住所に少なくともストリート名のほかに都市、州、または ZIP Code のいずれか 1 つが含まれていないとマッチ候補を取得できません。ジオコーディング情報を取得するために GeocodeUSAddress を使用している場合は、入力住所に ZIP + 4 Code さえ含まれていればジオコーディング情報を受け取ることができます。

以下の表に、GeocodeUSAddress の入力のフォーマットとレイアウトに関する情報を示します。

GeocodeUSAddress の入力データ

パラメータ 書式 説明

Data.AddressLine1

String

1 行目の住所行または交差点。

交差点を指定するには、and、&、at、または @ を使用します。例えば、PEARL & 28th のようになります。CASS モードでの処理時には、GeocodeUSAddress は交差点のマッチングを行いません。

個々の住所番号の代わりに住所範囲を入力することができます。例えば、10-12 FRONT ST のようになります。その他の情報については、住所範囲マッチングを参照してください。

Data.AddressLine2

String

2 行目の住所行または交差点。

交差点を指定するには、and、&、at、または @ を使用します。例えば、PEARL & 28th のようになります。CASS モードでの処理時には、GeocodeUSAddress は交差点のマッチングを行いません。

Data.AddressLine2

String

3 行目の住所行。

Data.AddressLine4

String

4 行目の住所行。

Data.AddressLine5

String

5 行目の住所行。

Data.AddressLine6

String

6 行目の住所行。

Data.City

String

都市や町など地方自治体名。

注: 入力フィールド AddressLine3、AddressLine4、AddressLine5、または AddressLine6 にデータがある場合、GeocodeUSAddress は City 入力フィールドのデータを無視します。

Data.FirmName

String

会社名。ジオコーディング処理では、マッチの品質を高めるため、入力会社名と USPS データ内で認識されている会社名のマッチングを行おうとします。会社名が USPS データにない場合、マッチング時に会社名が無視され、出力で会社名が返されます。

Data.LastLine

String

都市、州、および ZIP Code を含む住所の最終行。

Data.Latitude

String

最終行予測機能を使用するマッチングに使う入力緯度。入力フォーマットは、40018301 のような整数でなければなりません。小数フォーマットは使用できません。

詳細については、最終行予測を参照してください。

Data.Longitude

String

最終行予測機能を使用するマッチングに使う入力経度。入力フォーマットは、-105240976 のような整数でなければなりません。小数フォーマットは使用できません。

詳細については、最終行予測を参照してください。

Data.PostalCode

String

5 桁の ZIP Code または 9 桁の ZIP + 4 コード。

注: 入力フィールド AddressLine3、AddressLine4、AddressLine5、または AddressLine6 にデータがある場合、GeocodeUSAddress は PostalCode 入力フィールドのデータを無視します。

Data.StateProvince

String

州の名前または略語。

注: 入力フィールド AddressLine3、AddressLine4、AddressLine5、または AddressLine6 にデータがある場合、GeocodeUSAddress は StateProvince 入力フィールドのデータを無視します。