このセクションでは、Places API Autosuggest リクエストを GS7 Autosuggest リクエストに移行するために必要なアクションについて説明します。

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

ベース URL、バージョン、リソース

クエリ フロー

Autosuggest Places API エントリーポイントと GS7 サービスは共に、テキストのワンボックス クエリを入力する際に候補を提示してエンド ユーザーをサポートします。

Places API によって href 属性を通して返されるフォローアップのカテゴリーとチェーンのクエリ候補提示は、href レスポンス要素を通して GS7 Autosuggest サービスからも同様に取得できます。

Autosuggest エントリーポイントの place または address の結果から href 属性を通して場所メディア タイプの詳細を取得する Places API アプリケーションは、Autosuggest サービスから返される id レスポンス要素で Lookup サービスを使用して GS7 でそれらの詳細を取得できます。 「場所の詳細」の章では、場所メディア タイプ属性と GS7 Lookup の結果の属性との対応関係を説明しています。

クエリ パラメーター

Autosuggest のメディア タイプ

推奨される場所または位置

推奨される検索クエリ

推奨されるクエリ用語補完

クエリ用語補完を必要とする Places API アプリケーションは、items とは別に、GS7 Autosuggest の queryTerms レスポンス要素でそれらを見つけます。 用語補完の最大数は 10 より小さい正の値 (デフォルトは 0) で GS7 Autosuggest クエリに設定する必要があります。 詳細については、クエリ用語補完サポートの章を参照してください。

強調表示

Places API と GS7 はどちらも、Autosuggest エントリーポイントとサービスに強調表示情報を提供します。Places API は強調表示の区切り文字の形式 (hlStart と hlEnd を通して) を提供しますが、GS7 は顧客がアプリケーションで強調表示をレンダリングできるようにする、より一般的な方法を提供します。

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

たとえば、Places API アプリケーションが hlStart=<i>&hlEnd=</i> の Autosuggest クエリ「Resta」を送信すると、highlightedTitle レスポンス要素が <i>resta</i>urant に設定された「restaurants」というタイトルの結果が取得できると期待されます。マッチングと形式の両方がレスポンス要素に統合されています。

GS7 Autosuggest サービスは、まったく同じクエリ「Resta」に対して、クエリ値と一致する部分のタイトル内の位置のみを指定する highlights レスポンス要素を持つ「restaurants」というタイトルの結果項目を返すことが期待されます。

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

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

プレース カテゴリー システム

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

現在サポート対象外のもの

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

現在、GS7 Autosuggest サービスでは次の Places API 属性は返されません。