マッチ モード
マッチ モードにより、入力とジオコーディング データセットとの間のマッチングに適用される柔軟性が決まります。入力と求める出力の品質に応じて、マッチ モードを選択します。例えば、入力データベースに誤りが多い場合は、緩いマッチ モードを選択します。
以下に、使用できるマッチ モードを、制限の厳しいものから緩いものへと順に示します。
- 完全一致
- 非常に厳格な一致を要求します。一致候補の数が最小となる制限の厳しいモードです。処理時間は短くなります。このモードを使用する際には、入力に綴りの間違いや不完全な住所などの問題がないことを確認してください。
- 標準
- 近似一致が求められ、適度な数の一致候補が生成されます。こちらがデフォルトです。
- 緩和
- あいまいな一致を許し、生成される一致候補数は最も多くなります。処理時間は長くなりますが、結果としてより多くの一致が得られます。入力に綴りの間違いや不完全な住所などの問題がないと確信できない場合は、このモードを使用します。
- カスタム
- MustMatch フィールドを設定することでマッチング条件を定義できます。
- インタラクティブ (米国のみ)
- 単一行住所マッチングに対してのみ使用可能です。このモードは、インタラクティブ マッチングにおける特定のマッチング問題に適切に対処することを目的に設計されています。インタラクティブ モードでは、より柔軟なマッチング パターンが可能で、緩和検索モードよりも多くの一致候補が返される場合もあります。詳細については、以下のインタラクティブ マッチ モードを参照してください。
- CASS (米国のみ)
- USPS CASS 規格を確実に遵守するために追加ルールを適用します。このマッチ モードの目的は、USPS の料金割引を受けるために、配達可能な住所を作成することです。郵送用に入力を正規化する場合にこのモードを使用します。このモードでは、多数の一致候補が生成されます。詳細については、以下のCASS モードを参照してください。
以下の表に、マッチ モードの設定方法に関する情報を示します。
REST API | 機能の実装 |
---|---|
サービス: | Geocode |
リクエストの種類: | GET |
パラメータ: | matchMode |
リクエストの種類: | POST |
オブジェクト: 要素: | preferences : matchMode |
詳細については、Geocode GET リクエストと Geocode POST リクエストを参照してください。
インタラクティブ マッチ モード (米国のみ)
インタラクティブ モードは、インタラクティブなモバイル/Web アプリケーション向けに設計されています。この使用事例においてユーザは、綴りに誤りがあったり、不正確であったり、情報が欠落した単一行住所を入力する場合があります。そのため、この入力の処理には、他のマッチ モードよりも緩いマッチング条件が適用されます。その結果、複数の一致候補が返される可能性があります。一致候補のリストをユーザに提示し、適切な候補を選択してもらうことができます。完全一致が見つかった場合は、それが単一の一致候補として返されます。正確な結果と不正確な結果が混ざって提示されることはありません。
- インタラクティブ マッチ モードは、単一行住所の処理でのみ使用できます。マッチ モードが INTERACTIVE に設定されている場合に単一行以外の住所を処理しようとすると、マッチ モードが一時的に RELAXED に変更され、住所は緩和モードで処理されます。マッチング処理が完了すると、マッチ モードは自動的に INTERACTIVE に戻ります。
- インタラクティブ マッチ モードを使用することで、ユーザは基本的な規則を回避できます。ユーザの入力が "123 S Main" で、"123 N Main" しか存在しない場合、方位記号が変更されたことを示すマッチ コードとともにマッチ結果が返されます。
- インタラクティブ マッチ モードでは、ユーザが前置方位記号と後置方位記号の位置を入れ換えて入力するケースが、ペナルティなしで処理されます。
- インタラクティブ マッチ モードでは、FIND_PREFER_ZIP_OVER_CITYカスタム オプション 設定が無視されます。都市名と ZIP Code が正しく一致しない場合は、入力住所のすべての要素を分析した結果に基づいて、最良のジオコーディング結果を返します。
- インタラクティブ モードでの操作時に、ポイント住所や補間されたストリート住所の結果が特定できない場合は、使用可能な ZIP-9、ZIP-7、または ZIP-5 のセントロイドが返される可能性があります。
CASS マッチ モード (米国のみ)
CASS マッチ モードでは、USPS CASS 規格を確実に遵守するための追加ルールが適用されます。このマッチ モードの目的は、USPS の料金割引を受けるために、配達可能な住所を作成することです。郵送用に入力を正規化する場合にこのモードを使用します。このモードでは、多数の一致候補が生成されます。
CASS マッチ モードの処理には、他のモードとの違いがあります。このモードでは、交差点、建物名、および空間エイリアス (TIGER、TomTom、および NAVTEQ のストリート名エイリアス) またはユーザ辞書に対するマッチングを実行しません。USPS に該当レコードがないデータ ソースの候補とのマッチングも行われません。このモードでは、同じ住所行にある 2 つのユニット番号 (建物番号とユニット番号など) を認識およびパースします。