Search Box

Search BoxはMapboxの製品で、開発者はユーザーの意図を考慮し、それに応じて結果をランク付けすることで、インタラクティブな場所検索をあらゆるWebおよびモバイルアプリに追加できます。Search Box APIを使用すると、開発者は住所だけでなく、POI（Point of Interest）、POIのカテゴリ、道路名、近隣地域、地域、地名、地区、郵便番号、地域、国も簡単に見つけられるオートコンプリート検索エクスペリエンスを簡単に作成できます。

Search Boxは、あらゆるアプリケーションで動作する使いやすいAPIです。開発者は、Webアプリ用のSearch Boxコンポーネント、またはiOSおよびAndroidアプリ用のMapbox Mobile SDKも利用できます。

Geocoding APIは、住所検索のみを目的として使用されます。Search Box APIは、住所の検索に使用できますが、POI、カテゴリ、ブランドの結果も含まれており、ルート沿いの検索などの追加機能があります。レストラン、ガソリンスタンド、重要なランドマークなどのPOIをユーザーが検索する必要がある場合は、Search Boxが適切な製品です。

舞台裏では、Search Box APIはGeocoding APIのアドレス検索機能を利用しているため、これらのAPI両方からのアドレス検索結果は同じになります。ただし、Search Box APIにはより多くのデータ型（POIなど）が含まれており、これらはユーザーのクエリと検出されたユーザーの意図に基づいてランク付けされるため、結果は異なります。たとえば、POIの一致がユーザーにとってより関連性が高い場合、Search Box APIはPOIエントリを上位に、一致するアドレスエントリを下位にランク付けします。

Mapboxは、世界中の多数のデータプロバイダーからデータライセンスを取得しています。当社のコンフレーションエンジンは、このデータを検証、統合、正規化、およびエンリッチし、当社のデータ品質チームが手動で修正を適用して、POIに関する最も正確な情報を提供します。\当社のPOIデータは、Mapbox対応のアプリ/デバイスからのテレメトリ、およびMapbox Contributeを通じたユーザーフィードバックを通じて継続的に検証されています。

Mapbox Search Box APIの価格は、使用するAPIエンドポイントに基づいています。/suggestまたは/retrieveエンドポイントを使用している場合、使用量は検索セッションごとに課金されます。/categoryまたは/reverseエンドポイントを使用している場合、使用量はリクエストごとに課金されます。詳細については、価格ページをご覧ください。

検索セッションは、典型的な検索シナリオにおけるユーザーインタラクションを模倣した、一連の/suggestおよび/retrieve API呼び出しです。検索セッションは、ユーザーが入力を開始したとき（アプリによって行われた最初の/suggest呼び出し）に始まり、ユーザーが結果を選択したとき（アプリによって行われた/retrieve呼び出し）に終了します。検索セッションは、非アクティブ状態が2分間続いた場合、または/retrieve呼び出しなしで50回の/suggest呼び出しが連続して行われた場合に、自動的に期限切れになります。

Search Box APIからの結果は保存できません。