クエリの最後の用語の候補を取得

このチュートリアルでは、 API がどのように用語の補完を提案しているかについて説明

プロシージャ

ポツダムから出発する途中で、ベルリンミッテでバーガーキングのファストフード店を探し queryTermsitemsているユーザーが、クエリの入力を開始し、でクエリ用語の完了候補を取得します。また、で 5 つの場所を検索し、のフォローアップクエリの候補を取得します。

不完全なクエリー「 Bur 」の場合、クエリー用語の補完候補には、「 burger 」、「 Burgermeister 」、および「 Burg 」などの他の関連する位置情報の提案があります。

以下の例を参照してください。また、クエリ条件を完了したAutosuggestクエリセッションの例を完成させてください。

GET https://autosuggest.search.hereapi.com/v1/
    discover
    ?at=52.43414,13.19315
    &q=bur&lang=en
    &limit=5
    &termsLimit=3
    &apiKey={YOUR_API_KEY}

{
  "queryTerms": [
    { "term": "BURGER", "replaces": "bur", "start": 0, "end": 3 },
    { "term": "Burgermeister", "replaces": "bur", "start": 0, "end": 3 },
    { "term": "Burgunder", "replaces": "bur", "start": 0, "end": 3 }
  ],
  "items": [
    {
      "title": "BURGER KING",
      "id": "here:pds:place:276u336k-616d8703c79e45c28af2e3c4d322a724",
      "resultType": "place",
      ...
    },
    {
      "title": "Burgermeister",
      "id": "here:pds:place:276u33d9-ae15f7d5f65b470db3c93e9415f895e5",
      "resultType": "place",
      ...
    },
    {
      "title": "Burgunder Straße, 14129 Berlin, Germany",
      "id": "here:af:street:NxklGXv1cSEovzhnxdHxGB",
      "resultType": "street",
      ...
    },
    {
      "title": "Burg, Sachsen-Anhalt, Germany",
      "id": "here:cm:namedplace:20196144",
      "resultType": "locality",
      ...
    },
    {
      "title": "BURGER KING",
      "id": "here:pds:place:276u3364-46972bb96b804b36a83f074d5213cd2e",
      "resultType": "place",
      ...
    }
  ]
}

次のパラメータが使用されます。

• at - 座標で表された検索コンテキストの中心を指定
• Q - フリーテキストのクエリを入力します。
• Limit ：返される結果の最大数
• termsLimit - 返されるクエリー条件の提案の最大数。
• apiKey - お客様の API キー 。

エンドユーザーは、「 burger 」の推奨用語を選択し、アプリケーションが q パラメータの「 bur 」を「 burger 」に置き換えて、不完全なクエリーを続行するようにします。 エンドユーザーが「 k 」と入力する /autosuggest と、「 burger k 」のクエリにつながります。このクエリには、エンドユーザーが使用できるように、「 king 」という用語が返されます。

完全なクエリの入力 / 完了セッションの例は次のように表示されます (BK はバーガーキングを表します ) 。

エンドユーザーが items アレイから chainQuery 提案「Burger king near Mitte」を選択すると、エンドユーザーが Mitte のバーガーキングレストランのみを取得できるように、関連する href 応答要素が Discover サービスに対して実行されます。

chainQuery 提案に対する Discover サービスの応答は次のとおりです。

{
  "items": [
    {
      "title": "BURGER KING",
      "address": {
        "label": "BURGER KING, Alexanderplatz 8, 10178 Berlin, Germany",
        "district": "Mitte",
        ...
      },
      ...
    },
    {
      "title": "BURGER KING",
      "address": {
        "label": "BURGER KING, Friedrichstraße 141, 10117 Berlin, Germany",
        "district": "Mitte",
        ...
      },
      ...
    },
    {
      "title": "BURGER KING Storkower STR. Ecke Landsberger Allee",
      "address": {
        "label": "BURGER KING Storkower STR. Ecke Landsberger Allee, Landsberger Allee 119, 10407 Berlin, Germany",
        "district": "Fennpfuhl",
        ...
      },
      ...
    },
    {
      "title": "BURGER KING",
      "id": "here:pds:place:2768lxx5-3d9439ccf0df01dd9657a0a56254c9cb",
      "resultType": "place",
      "address": {
        "label": "BURGER KING, Schönhauser Allee 79, 10439 Berlin, Germany",
        "district": "Prenzlauer Berg",
        ...
      },
      ...
    },
    {
      "title": "BURGER KING",
      "id": "here:pds:place:276u33db-ad4ba38ca1674569acba3c98b953c532",
      "resultType": "place",
      "address": {
        "label": "BURGER KING, Jean-Monnet-Straße 2, 10557 Berlin, Germany",
        "district": "Moabit",
        ...
      },
      ...
    },
    ...
  ]
}

この例では、クエリの完了という用語を使用して、エンドユーザーが " バーガーキングミッテ " クエリでは queryTerms なく、 HERE Geocoding and Search と 11 回対話しました ( アプリケーションが要素を統合していない場合 ) 。 長いクエリ条件では、ゲインが高くなることがあります。

追加情報

/autosuggest パラメータの詳細については、次のトピックを参照してください。 API リファレンス。