Google consiglia di utilizzare le sessioni con Autocomplete (New). Le sessioni semplificano i prezzi e forniscono un modello di determinazione del prezzo coerente da utilizzare con il completamento automatico (nuovo).
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.
Una volta terminata la sessione, qualsiasi chiamata a Completamento automatico (Nuovo), Dettagli luogo (Nuovo) o Convalida indirizzo che utilizzi il token di sessione scaduto viene fatturata come se non ci fosse alcun token di sessione.
Le sessioni incomplete, ovvero le sessioni che non vengono terminate da una richiesta di Places Details (New) o Address Validation, vengono fatturate solo per le richieste Autocomplete (New) utilizzando lo SKU: Autocomplete Requests.
Fatturazione della sessione
Sessioni che terminano con una richiesta Place Details (New) Essentials
Per le sessioni Autocomplete (New) che terminano con una richiesta che utilizza i campi dello SKU: Places API Place Details Essentials:
- Prime 12 richieste Autocomplete (New): ti viene addebitato un costo per ogni richiesta Autocomplete (New), fino a un massimo di 12 richieste, utilizzando lo SKU: Autocomplete Requests.
- Per le richieste di completamento automatico (nuove) 13 e successive nella stessa sessione: ti verrà addebitato l'importo corrispondente allo SKU: utilizzo sessione di completamento automatico, il che significa che non verrà addebitato alcun costo per tali richieste.
- Dettagli del luogo (nuovo) Essentials: ti verrà addebitata anche la richiesta di terminazione in SKU: Places API Place Details Essentials.
Sessioni che terminano con richieste di convalida dell'indirizzo o dettagli del luogo (nuove) (non essenziali)
Per le sessioni Autocomplete (New) che terminano con una richiesta Address Validation o una richiesta Place Details (New) che utilizza campi di Place Details Pro, Enterprise o Enterprise + Atmosphere:
- Richieste di completamento automatico (nuove): tutte le richieste di completamento automatico (nuove) vengono fatturate in base allo SKU: Utilizzo sessione di completamento automatico, il che significa che non viene addebitato alcun costo per tali richieste.
-
Dettagli del luogo (nuovo) o richiesta di convalida dell'indirizzo: ti verrà addebitata anche la richiesta di terminazione per lo SKU appropriato:
- Le richieste di terminazione di Place Details (New) vengono fatturate in base allo SKU: Place Details Enterprise + Atmosphere, indipendentemente dai campi richiesti.
- Le richieste di terminazione della convalida dell'indirizzo vengono fatturate in base allo SKU: Address Validation Enterprise.
Scenari di prezzi per sessione
I tre scenari di determinazione del prezzo della sessione più comuni sono:
- Completamento automatico per i dati sulla posizione
- Completamento automatico per la scoperta del luogo
- Completamento automatico per il pagamento e la consegna
Nelle sezioni seguenti vengono descritti 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), poi utilizzi Place Details (New) per ottenere le coordinate di latitudine e longitudine del luogo per mostrarlo su una mappa.
Le informazioni sulla posizione possono includere quanto segue:
- Indirizzo
- Posizione come coordinate di latitudine e longitudine
- Plus Code
- Tipi
- Area visibile
Questa sessione viene terminata da una singola richiesta a Place Details (New) che richiede campi definiti dallo SKU: Place Details Essentials.
Ti vengono addebitati i costi nel seguente modo:
- Le prime 12 richieste Autocomplete (New) vengono fatturate in base allo SKU: Autocomplete Requests.
- Le eventuali richieste Autocomplete (New) rimanenti vengono fatturate in base allo SKU: Autocomplete Session Usage, il che significa che non vengono addebitate.
- La richiesta Places Details (New) finale viene addebitata in base allo SKU: Places API Place Details Essentials.
Completamento automatico per la scoperta di luoghi
Nello scenario di completamento automatico per la scoperta di luoghi, ti interessa ottenere più di semplici dati sulla posizione di un luogo. Ad esempio, potresti richiedere uno dei seguenti elementi:
- Opzioni di accessibilità
- Orario di apertura attuale
- Opzioni per il parcheggio
- Recensioni
- Valutazioni
Per questo scenario, la sessione viene terminata da una singola richiesta a Place Details (New) che richiede qualsiasi campo incluso negli SKU Place Details (New) Pro, Enterprise o Enterprise + Atmosphere.
Ti vengono addebitati i costi nel seguente modo:
- Tutte le richieste Autocomplete (New) vengono fatturate in base allo SKU: Utilizzo sessione Autocomplete, il che significa che non è previsto alcun addebito per queste richieste.
- La richiesta Places Details (New) finale viene fatturata in base allo SKU: Places API Place Details Enterprise + Atmosphere.
Completamento automatico per pagamento e consegna
L'API Address Validation è un servizio che accetta un indirizzo. Identifica i componenti dell'indirizzo e li convalida. Inoltre, standardizza l'indirizzo per la spedizione e trova le coordinate di latitudine e longitudine più note.
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 vengono addebitati i costi nel seguente modo:
- Tutte le richieste Autocomplete (New) vengono fatturate in base allo SKU: Utilizzo sessione Autocomplete, il che significa che non è previsto alcun addebito per queste richieste.
- Una richiesta facoltativa di Place Details Essentials viene fatturata senza costi, se richiesta prima della richiesta di convalida dell'indirizzo di terminazione.
- La richiesta di convalida dell'indirizzo che termina viene fatturata in base allo SKU: Address Validation Enterprise.
Prezzi senza sessioni
Se non utilizzi le sessioni, la fatturazione avviene per richiesta ad Autocomplete (New) utilizzando lo SKU: Autocomplete Requests.
Prezzi per sessioni incomplete o abbandonate
Se una sessione viene abbandonata, ovvero non terminata tramite una chiamata a Place Details (New) o Address Validation, le richieste di completamento automatico (New) tornano al modello di prezzo per richiesta e vengono fatturate in base allo SKU: Richieste di completamento automatico.