最も近い POI (ポイント情報) の検索
最も近い POI 検索機能は、指定されたロケーションに最も近い POI (ポイント情報) を検索します。FindNearestPOIs メソッドは AutoSuggestAPI クラス内にあります。
com.mapinfo.mapmarker.autosuggest.api.AutoSuggestAPI.findNearestPOIs
注: POI 機能 (最も近い POI の検索を含む) は、POI データをライセンス取得してインストールした場合のみ使用可能です。POI データのライセンスを取得してインストールしなければ、FindNearestPOI は候補を返しません。
FindNearestPOIs メソッドには、次のパラメータと制約があります。
パラメータまたは制約 | 値 | 必須またはオプションの区別と使用方法 |
---|---|---|
Country | CTY 3 文字の ISO 国コード | これはオプションです。指定しない場合は、使用可能なすべての国を検索します。 |
検索中心点 | 検索中心点の緯度/経度。検索エリアの中心を定義します。 | 必須 |
候補の最大数 | MaxCandidates 返される POI 候補の最大数。最大数は 100 です。デフォルトは 5 です。 | これはオプションです。候補の最大数を指定しない場合、検索距離内のすべての POI が返されます。指定しない場合は、デフォルトで 5 つの候補が返されます。 |
検索距離 | SearchDistance: 検索を行う原点からの最大距離。 | これはオプションです。指定しない場合、検索距離は 5 になります。 |
検索距離単位 | Units: 検索距離の測定単位。キロメートル、マイル、メートル、またはフィートが指定できます。デフォルトは、キロメートルです。 | これはオプションです。指定しない場合、デフォルトの距離単位はキロメートルです。 |
ロケール | ロケールは、最も近い POI の検索に対してのみ有効です。英語は常に使用可能であり、デフォルトのロケールです。POI カテゴリとサブカテゴリがローカライズされている場合は、[ネイティブ] も選択できます。ネイティブとは、その国の現地語のことです。 | これはオプションです。ロケールが指定され、そのロケールが使用可能である場合、POI はその言語で返されます。ロケールが指定されているが、そのロケールが使用可能でない場合、POI は英語で返されます。ロケールが指定 されない 場合、POI は、(英語以外の) ネイティブ言語が使用可能である場合はその言語で、それ以外の場合は英語で返されます。 |
Management Console でこの機能を使用するには
- [GeocComplete] タブ で、[最も近い POI を検索] を選択します。これによって、ロケールが選択できるようになります。 の
- [ロケール] ボックスで、優先するロケールを選択します。デフォルトは英語ですが、ローカライズされているカテゴリ/サブカテゴリに対して [ネイティブ] を選択できます。ローカライズされたコンテンツは、一部の国に対してのみ提供されています。
- [最大候補数] (デフォルトは 5) と [距離単位] (デフォルトはキロメートル) を選択します。
- タブで、[検索距離] (デフォルトは 0) を選択します。0 は、検索距離に制限がないことを意味します。
- 最も近い POI (point of interest) を検索するには、[プレビュー] タブで名前またはブランド、および検索エリアの起点 (緯度/経度) を指定し、[プレビューを実行] をクリックします。