Place Autocomplete (Legacy) utilizza i token di sessione per raggruppare le fasi di query e selezione di una ricerca con completamento automatico dell'utente in una sessione distinta ai fini della fatturazione. La sessione inizia quando l'utente inizia a digitare una query e termina quando seleziona un luogo e viene effettuata una chiamata a Place Details (Legacy). Ogni sessione può avere più query di completamento automatico, seguite dalla selezione di un luogo. Le chiavi API utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto della console Google Cloud. Una volta conclusa una sessione, il token non è più valido; l'app deve generare un nuovo token per ogni sessione. Se il parametro sessiontoken viene omesso o se riutilizzi un token di sessione, la sessione viene addebitata come se non fosse stato fornito alcun token di sessione (ogni richiesta viene fatturata separatamente).
Ti consigliamo di seguire queste linee guida:
- Utilizza i token di sessione per tutte le sessioni di completamento automatico.
- Genera un nuovo token per ogni sessione.
- Assicurati che le chiavi API utilizzate per tutte le richieste Place Autocomplete (Legacy) e Place Details (Legacy) all'interno di una sessione appartengano allo stesso progetto della console Google Cloud.
- Assicurati di passare un token di sessione univoco per ogni nuova sessione. Se utilizzi lo stesso token per più sessioni, ogni richiesta verrà fatturata singolarmente.
Se vuoi, puoi omettere il token di sessione di completamento automatico da una richiesta. Se il token di sessione viene omesso, ogni richiesta viene fatturata separatamente, attivando lo SKU Autocomplete - Per Request. Se riutilizzi un token di sessione, la sessione viene considerata non valida e le richieste vengono addebitate come se non fosse stato fornito alcun token di sessione.
Esempio
Man mano che l'utente digita una query, viene chiamata una richiesta di completamento automatico ogni pochi tasti premuti (non per carattere) e viene restituito un elenco di possibili risultati. Quando l'utente effettua una selezione dall'elenco dei risultati, la selezione viene conteggiata come una richiesta e tutte le richieste effettuate durante la ricerca vengono raggruppate e conteggiate come una singola richiesta. Se l'utente seleziona un luogo, la query di ricerca è disponibile senza costi e viene addebitata solo la richiesta di dati di Place. Se l'utente non effettua una selezione entro pochi minuti dall'inizio della sessione, viene addebitata solo la query di ricerca.
Considera questo flusso di eventi dal punto di vista di un'app:
- Un utente inizia a digitare una query per cercare "Parigi, Francia".
- Quando rileva l'input dell'utente, l'app crea un nuovo token di sessione, "Token A".
- Man mano che l'utente digita, l'API effettua una richiesta di completamento automatico ogni pochi caratteri, visualizzando un nuovo elenco di potenziali risultati per ciascuno:
"P"
"Par"
"Paris,"
"Paris, Fr"
- Quando l'utente effettua una selezione:
- Tutte le richieste risultanti dalla query vengono raggruppate e aggiunte alla sessione rappresentata dal "Token A" come singola richiesta.
- La selezione dell'utente viene conteggiata come richiesta Place Details e aggiunta alla sessione rappresentata da "Token A".
- La sessione si conclude e l'app elimina il "Token A".
Per saperne di più su come vengono fatturate le richieste Place Autocomplete (Legacy), consulta Utilizzo e fatturazione.
Crea token di sessione
Per creare un token di sessione, chiama AutocompleteSessionToken.newInstance().