Geocode POST リクエスト

• placeName
• mainAddress
• lastLine
• areaName1
• areaName2
• areaName3
• areaName4
• postCode1
• postCode2
• country

また、一部のマッチングおよびジオコーディング オプションは国によって異なります。各国に固有の情報を確認することが重要です。各国の情報については、付録にある国固有の情報セクションを参照してください。

Pitney Bowes
4750 Walnut St.
Boulder, CO 80301

4750 Walnut St., Boulder CO, 80301

ストリート住所 — 住所フィールド (placeName、lastLine、postalCode など) が個別に入力されている場合、このフィールドの内容はストリート住所として処理され、会社名、家番号、建物名、およびストリート名を含むことができます。これはオプションです。

交差点の入力—交差点を入力するには、2 個のアンパサンド (&&) で区切られた 2 つのストリート名を指定します。

実行されるジオコード タイプ。これはオプションです。

Address

ストリート住所にジオコーディングします。こちらがデフォルトです。

Geographic

都市または州の地理的セントロイドにジオコーディングします。

Postal

郵便番号にジオコーディングします。

True

各候補に対して使用可能なすべての情報を返します。

False

各候補に対して使用可能なすべての情報を返しません。こちらがデフォルトです。

True

住所レベルのセントロイドを決定できない場合に地理的セントロイドを返します。こちらがデフォルトです。

False

住所レベルのセントロイドを決定できない場合に地理的セントロイドを返しません。

True

住所レベルのセントロイドを決定できない場合に郵便番号セントロイドを返します。こちらがデフォルトです。

False

住所レベルのセントロイドを決定できない場合に郵便番号セントロイドを返しません。

True

国ジオコーダがインストールされていないか、国ジオコーダがジオコーディング データセットなしでインストールされている場合に、World Geocoder (XWG) を使用してマッチングを行います。

False

国ジオコーダがインストールされていないか、国ジオコーダがジオコーディング データセットなしでインストールされている場合に、World Geocoder (XWG) を使用してマッチングを行いません。こちらがデフォルトです。

オフセット距離は、ジオコードがストリートの中央に位置付けられるのを防ぐために、ストリートレベルのジオコーディングで使われます。ストリートレベルのジオコーディングを行うと、住所が位置するストリートの中心点の緯度/経度が返されますが、これを補正するのがオフセットです。住所が指し示す建物はストリートの真上に建っているわけではないので、路上のポイントに相当する住所のジオコードが返されるのは不都合です。ジオコードは、ストリートに面して建つ建物の場所を表している必要があります。例えば、50 フィートのオフセットは、ジオコードがストリートの中心から 50 フィート離れた場所を表すことを意味します。距離は、住所のストリートセグメントから垂直方向に計算されます。また、オフセットは、ストリートをはさんで向かい合う住所が同じポイントになるのを防ぐ目的にも使われます。以下に、オフセット ポイントと元のポイントとの比較図を示します。

• フィート
• メートル - デフォルト

以下に、ストリートの終点とオフセット終点の比較図を示します。

• フィート
• メートル - デフォルト

Exact

非常に厳格な一致を要求します。一致候補の数が最小となる制限の厳しいモードです。処理時間は短くなります。このモードを使用する際には、入力に綴りの間違いや不完全な住所などの問題がないことを確認してください。

Standard

近似一致が求められ、適度な数の一致候補が生成されます。こちらがデフォルトです。

Relaxed

あいまいな一致を許し、生成される一致候補数は最も多くなります。処理時間は長くなりますが、結果としてより多くの一致が得られます。入力に綴りの間違いや不完全な住所などの問題がないと確信できない場合は、このモードを使用します。

Custom

MustMatch フィールドを設定することによってマッチング条件を定義することができます。ただし、MustMatch フィールドはPOST リクエストを使用する場合のみ設定可能です。GETリクエストに対しては、MustMatch のデフォルト値が適用されます。MustMatch フィールドの詳細については、mustMatchFieldsを参照してください。

Interactive (USA only)

単一行住所マッチングに対してのみ使用可能です。このモードは、インタラクティブ マッチングにおける特定のマッチング問題に適切に対処することを目的に設計されています。インタラクティブ モードでは、より柔軟なマッチング パターンが可能で、緩和検索モードよりも多くの一致候補が返される場合もあります。

CASS (USA only)

USPS CASS 規格を確実に遵守するために追加ルールを適用します。このマッチ モードの目的は、USPS の料金割引を受けるために、配達可能な住所を作成することです。郵送用に入力を正規化する場合にこのモードを使用します。このモードでは、多数の一致候補が生成されます。

codespace:codeという形式で、座標参照系を指定します。

• preferences、mustMatchFields または returnFieldsDescriptor オブジェクト内の (複数の) 要素のデフォルト値に対する、国固有のオーバーライド。
• 国に対するカスタム入力オプション。

<customPreferences>
 <entry>
  <key>USA.maxReturnedCandidates</key>
  <value>3</value>
 </entry>
</customPreferences>

• オーストラリア (AUS)
• カナダ (CAN)
• フランス (FRA)
• ドイツ (DEU)
• 英国 (GBR)
• ニュージーランド (NZL)
• ポルトガル (PRT)
• シンガポール (SGP)
• スウェーデン (SWE)
• 米国 (USA)

True

入力住所番号が一致する必要があります。

False

入力住所番号が一致する必要はありません。こちらがデフォルトです。

True

入力された PostCode1 フィールドが一致する必要があります。

False

入力された PostCode1 フィールドが一致する必要はありません。こちらがデフォルトです。

True

入力された AreaName1 フィールドが一致する必要があります。

False

入力された AreaName1 フィールドが一致する必要はありません。こちらがデフォルトです。

True

入力された AreaName2 フィールドが一致する必要があります。

False

入力された AreaName2 フィールドが一致する必要はありません。こちらがデフォルトです。

True

入力された AreaName3 フィールドが一致する必要があります。

False

入力された AreaName3 フィールドが一致する必要はありません。こちらがデフォルトです。

True

入力された AreaName4 フィールドが一致する必要があります。

False

入力された AreaName4 フィールドが一致する必要はありません。こちらがデフォルトです。

True

入力ストリート名、タイプ、方位記号の各フィールドが一致する必要があります。

False

入力ストリート名、タイプ、方位記号の各フィールドが一致する必要はありません。こちらがデフォルトです。

True

その他の「必ず一致」のフィールドは無視され、値が指定されたすべての使用可能な入力フィールド (郵便番号、エリア名など) と一致しなければ、候補は返されません。

False

その他の「必ず一致」のフィールドは有効です。値が指定されたどの特定の入力フィールドとも一致しなくても、候補は返されます。こちらがデフォルトです。

True

候補に対するすべてのカスタム フィールドを返します。

False

候補に対するフィールドの標準セットのみを返します。こちらがデフォルトです。

True

候補のどの部分が入力住所と一致したかを表す、マッチ記述子オブジェクトを返します。

False

マッチ記述子オブジェクトを返しません。こちらがデフォルトです。

True

formattedStreetAddress フィールドを構成する、以下に示す個々のストリート フィールドをすべて個別に返します。

• MAIN_ADDRESS — ストリート名の基本部分。例: “13 River Ave” の “River”
• THOROUGHFARE_TYPE — ストリート名の前または後に付くことがある、Ave、Via、St、Rd などの大ストリートタイプ。
• ADDRESS_ID — ソース データ内の住所に対する一意の識別子。
• PRE_ADDRESS — 主ストリート名の前に付く冠詞などを値に含めることができます。例: “Calle de la mesa” の “de la”
• POST_ADDRESS — 主ストリート名の後に付く語句を値に含めることができます。例: “Calle Ramon Perez de la tiedra” の "de la tiedra"
• PRE_DIRECTIONAL — 主ストリート名の前に付く方位記号を値に含めることができます。例: “123 South Main St” の “South”
• POST_DIRECTIONAL — 主ストリート名の後に付く方位記号を値に含めることができます。例: “123 River St SW” の “SW”

False

個々のストリート フィールドを個別に返しません。これらの値を formattedStreetAddress フィールドに入れて返します。こちらがデフォルトです。