Google consiglia di utilizzare le sessioni con Autocomplete (New). Le sessioni semplificano la determinazione del prezzo e forniscono un modello di determinazione del prezzo coerente per l'utilizzo con Autocomplete (New).
Una sessione inizia con la prima richiesta Autocomplete (New) che include un token di sessione, continua con ogni richiesta Autocomplete (New) successiva e termina con una richiesta a Place Details (New) o Address Validation che utilizza il token di sessione.
Al termine della sessione, qualsiasi chiamata ad Autocomplete (New), Place Details (New) o Address Validation che utilizza il token di sessione scaduto viene fatturata come se non fosse presente alcun token di sessione.
Le sessioni incomplete, ovvero le sessioni che non terminano con una richiesta a Place Details (New) o Address Validation, vengono fatturate solo per le richieste Autocomplete (New) che utilizzano lo SKU: Autocomplete Requests.
Fatturazione delle sessioni
Sessioni che terminano con una richiesta Place Details (New) Essentials
Per le sessioni Autocomplete (New) che terminano con una richiesta che utilizza i campi da SKU: Places API Place Details Essentials:
- Prime 12 richieste Autocomplete (New): ti viene addebitato l'importo per ogni richiesta Autocomplete (New), fino a un massimo di 12 richieste, utilizzando lo SKU: Autocomplete Requests.
- Per le richieste Autocomplete (New) dalla 13ª in poi nella stessa sessione: ti viene addebitato l'importo in base allo SKU: Autocomplete Session Usage, il che significa che non sono previsti addebiti per queste richieste.
- Place Details (New) Essentials: ti viene addebitato l'importo anche per la richiesta di terminazione in base allo SKU: Places API Place Details Essentials.
Sessioni che terminano con richieste Address Validation o Place Details (New) (non Essentials)
Per le sessioni Autocomplete (New) che terminano con una richiesta Address Validation o una richiesta Place Details (New) che utilizza i campi di Place Details Pro, Enterprise, o Enterprise + Atmosphere:
- Richieste Autocomplete (New):tutte le richieste Autocomplete (New) vengono fatturate in base allo SKU: Autocomplete Session Usage, il che significa che non sono previsti addebiti per queste richieste.
-
Richiesta Place Details (New) o Address Validation:ti viene addebitato l'importo anche per la
richiesta di terminazione in base allo SKU appropriato:
- Le richieste di terminazione Place Details (New) vengono fatturate in base allo SKU: Place Details Enterprise + Atmosphere, indipendentemente dai campi richiesti.
- Le richieste di terminazione Address Validation vengono fatturate in base allo SKU: Address Validation Enterprise.
Scenari di determinazione del prezzo delle sessioni
I tre scenari di determinazione del prezzo delle sessioni più comuni sono:
- Completamento automatico per i dati sulla posizione
- Completamento automatico per la scoperta dei luoghi
- Completamento automatico per il pagamento e la consegna
Le sezioni seguenti descrivono i singoli addebiti di fatturazione per ogni scenario.
Completamento automatico per i dati sulla posizione
Nello scenario di completamento automatico per i dati sulla posizione, ti interessa utilizzare Autocomplete (New) e Place Details (New) per ottenere informazioni sulla posizione di un luogo. Ad esempio, selezioni un suggerimento da Autocomplete (New), quindi utilizzi Place Details (New) per ottenere le coordinate di latitudine e longitudine del luogo da mostrare su una mappa.
I dati sulla posizione possono includere:
- Indirizzo
- Posizione come coordinate di latitudine e longitudine
- Plus Code
- Tipi
- Area visibile
Questa sessione termina con una singola richiesta a Place Details (New) che richiede i campi definiti dallo SKU: Place Details Essentials.
Ti viene addebitato l'importo nel seguente modo:
- Le prime 12 richieste Autocomplete (New) vengono fatturate in base allo SKU: Autocomplete Requests.
- Le richieste Autocomplete (New) rimanenti vengono fatturate in base allo SKU: Autocomplete Session Usage, il che significa che non sono previsti addebiti per queste richieste.
- La richiesta di terminazione Place Details (New) viene addebitata in base allo SKU: Places API Place Details Essentials.
Completamento automatico per la scoperta dei luoghi
Nello scenario di completamento automatico per la scoperta dei luoghi, ti interessa ottenere più dei semplici dati sulla posizione di un luogo. Ad esempio, potresti richiedere uno dei seguenti:
- Opzioni di accessibilità
- Orari di apertura attuali
- Opzioni per il parcheggio
- Recensioni
- Valutazioni
In questo scenario, la sessione termina con una singola richiesta a Place Details (New) che richiede qualsiasi campo incluso negli SKU Place Details (New) Pro, Enterprise o Enterprise + Atmosphere.
Ti viene addebitato l'importo nel seguente modo:
- Tutte le richieste Autocomplete (New) vengono fatturate in base allo SKU: Autocomplete Session Usage, il che significa che non sono previsti addebiti per queste richieste.
- La richiesta di terminazione Place Details (New) viene fatturata in base allo SKU: Places API Place Details Enterprise + Atmosphere.
Completamento automatico per il pagamento e la consegna
L'API Address Validation è un servizio che accetta un indirizzo. Identifica i componenti dell'indirizzo e li convalida. Inoltre, standardizza l'indirizzo per le spedizioni postali e trova le coordinate di latitudine e longitudine più conosciute.
Nello scenario di completamento automatico per il pagamento e la consegna, termini la sessione con una richiesta all' API Address Validation per convalidare l'indirizzo selezionato.
Ti viene addebitato l'importo nel seguente modo:
- Tutte le richieste Autocomplete (New) vengono fatturate in base allo SKU: Autocomplete Session Usage, il che significa che non sono previsti addebiti per queste richieste.
- Una richiesta Place Details Essentials facoltativa non viene addebitata, se richiesta prima della richiesta di terminazione Address Validation.
- La richiesta di terminazione Address Validation viene fatturata in base allo SKU: Address Validation Enterprise.
Determinazione del prezzo senza sessioni
Se non utilizzi le sessioni, ti viene addebitato l'importo per ogni richiesta ad Autocomplete (New) utilizzando lo SKU: Autocomplete Requests.
Determinazione del prezzo per sessioni incomplete o abbandonate
Se una sessione viene abbandonata, ovvero non termina con una chiamata a Place Details (New) o Address Validation, le richieste Autocomplete (New) tornano al modello di determinazione del prezzo per richiesta e vengono fatturate in base al SKU: Autocomplete Requests.