クエリをフォローアップする

クエリ候補は、アプリケーション開発者がより正確なフォローアップクエリを作成するために使用することを想定しています。特に、エンドユーザーが入力したクエリが不完全な場合に役立ちます。

クエリの候補は次のいずれかとなります。

エンドユーザーが最後に入力した未完成のクエリトークンを置き換えるために選択した単語
エンドユーザーがより正確な結果を得るために選択したフォローアップクエリ URL

最初の候補は別のリストに分離されます。これらは結果そのものではなく、ただの単語です。このようなクエリの最後のトークン候補については、Autosuggestエンドポイントのクエリワードの補完の章に記載しています。

2 つ目の候補は実際の結果であり、Autosuggest 結果セットにおいて他のタイプと一緒に順位付けされます。結果タイプは categoryQuery または chainQuery のいずれかとなります。

フォローアップクエリは特定のチェーンまたは特定のカテゴリーのいずれかの place タイプ項目のみを返します。例：

categoryQuery

レストランのクエリ候補：

{
  "title": "restaurant",
  "id": "here:cm:ontology:restaurant",
  "resultType": "categoryQuery",
  "href": "https://autosuggest.search.hereapi.com/v1/discover?q=restaurant&_ontology=restaurant&lang=en&at=52.93175%2C12.77165",
  "highlights": ...
}

chainQuery

スターバックスのクエリ候補：

{
  "title": "Starbucks",
  "id": "here:cm:ontology:starbucks",
  "resultType": "chainQuery",
  "href": "https://autosuggest.search.hereapi.com/v1/discover?q=Starbucks&_ontology=starbucks&lang=en-US&at=48.37773%2C12.03539",
  "highlights": ...
}

関連するエンドポイント：/autosuggest