自動候補提示リクエストを移行します

このセクションでは 、 Places API 自動候補提示 リクエストを GS7 自動候補提示 リクエストに移行するために実行する必要があるアクションについて説明します。

パラメータのタイプまたは仕様の詳細について は、『開発者ガイド』を参照してください。

基本 URL 、バージョン、リソース

クエリフロー

自動候補提示 Places API エントリーポイントとサービスはいずれも、エンドユーザーがテキストのワンボックスクエリを作成する際に、提案を行うことをサポートすることを目的としています。

Places API 自動候補提示エントリーポイントが href 属性を通して返すフォローアップカテゴリおよびチェーンクエリの提案は、 href 同様に、応答要素を介して自動候補提示サービスから取得できます。

自動候補提示エントリーポイントplaceからプレースメディアタイプの詳細を取得する API アプリケーションを配置 します。または、href属性を介してaddress結果を取得し、自動候補提示サービスによって返されたid応答要素を含むルックアップサービスを使用して GS7 でこれらの詳細を取得できます。 「 配置の詳細 」では、「配置メディアの種類」属性が GS7 ルックアップ結果の属性にどのようにマップされるかについて説明します。

クエリーパラメータ

自動候補提示メディアタイプ

提案された場所または場所

推奨される検索クエリです

推奨されるクエリー条件の完了

クエリ期間の完了が必要な API アプリケーションでは、 GS7 自動候補提示 queryTerms 応答要素がとは別に見つかり itemsます。 GS7 自動候補提示クエリでは、正の値が 10 未満の場合、最大完了数を設定する必要があります ( 既定値は 0) 。 詳細については、「クエリ用語の補完」のサポートの章を参照してください。

強調表示

Places API と GS7 の両方が、自動候補提示エントリーポイント and Service でハイライト情報を提供します。 Places API では、区切り文字のハイライト表示書式 ( ～ hlStarthlEnd) が提供されますが、 GS7 では、アプリケーションでのハイライト表示をレンダリングするためのより汎用的な方法が提供されます。

Places API を使用すると、トークンで一致した各自動候補提示エントリーポイントの前に配置する開始タグと終了タグの区切り文字を指定できます。 一方、 GS7 は、クエリに一致する応答要素の開始インデックスと終了インデックスを提供します。

たとえば、が自動候補提示クエリ "Resta" を送信する Places API アプリケーション hlStart=<i>&hlEnd=</i> では highlightedTitle 、応答要素がに設定された "resters" というタイトルの結果が返されることがあり <i>resta</i>urantます。 マッチングと形成の両方が応答エレメントに統合されます。

GS7 自動候補提示サービスは、非常に同じクエリ "Resta" で、 "Restaurants" というタイトルの結果アイテムを返します。 highlights 応答エレメントでは、クエリ値に一致するパーツのタイトルの位置のみを指定します。

highlights: {
      title: [
         {
            start: 0,
            end: 5
         }
      ]
   }

アプリケーション開発者は highlightedTitlehighlightedVicinity 、 GS7 の値 title との関連情報を使用する highlightsことで、 Places API のような価値を簡単に構築して返すことができます。

カテゴリシステムを配置します

GS7 は、 Places API から cs=pds クエリ パラメーター経由で利用できる、非常に正確な HERE Places カテゴリをサポートしています。 詳細については、カテゴリシステムのページを参照してください。

現在サポートされていません

GS7 自動候補提示サービスでは、次のクエリパラメータまたはヘッダーは現在サポートされていません。

GS7 自動候補提示サービスでは、次の API 属性が現在返されていません :