セッション トークンは、ユーザーの予測入力のクエリフェーズと選択フェーズをグループ化します 請求のために個別のセッションを検索する
セッション トークンを作成する
ユーザーは、セッションごとに一意のセッション トークンを生成する必要があります。 バージョン 4 の UUID を使用することをおすすめします。
例
ユーザーがクエリを入力すると、予測入力リクエストが数ステップごとに呼び出されます。 キーストローク（文字ごとではなく）が使用され、可能性のある結果のリストが返されます。日時 ユーザーが結果リストから選択すると、その選択は 検索中に行われたすべてのリクエストがバンドルされてカウントされます。 単一のリクエストとして送信できますユーザーが場所を選択すると、検索クエリが使用可能になります。 プレイスデータ リクエストのみが課金対象となります。ユーザーが 選択できるのは、セッションの開始から数分以内です。 課金が発生します
このイベントのフローをアプリの観点から見てみましょう。
- ユーザーがクエリの入力を開始し、「Paris, France」を検索します。
- アプリはユーザー入力を検出すると、新しいセッション トークン「トークン A」を作成します。
- ユーザーが入力を始めると、API が数文字ごとに予測入力リクエストを実行し、各々に新しい候補結果のリストを表示します。
"P"
"Par"
"Paris,"
"Paris, Fr"
- ユーザーが選択を行うとき:
- このクエリによるすべてのリクエストはグループ化され、「トークン A」で表されるセッションに 1 つのリクエストとして追加されます。
- ユーザーの選択は Place Detail リクエストとしてカウントされ、「トークン A」で表されるセッションに追加されます。
- セッションが終了し、アプリは「トークン A」を破棄します。
予測入力リクエストの課金方法について詳しくは、使用量と お支払い。