Utilizzo e fatturazione dell'API Places

Informazioni sulle maschere di campo

Per Place Details (nuovo), Nearby Search (nuova) e Ricerca testuale (nuova), utilizza l'intestazione FieldMask nelle richieste API per specificare l'elenco dei campi da restituire nella risposta. Ti verrà quindi fatturato lo SKU più alto applicabile alla tua richiesta. Ciò significa che se selezioni i campi sia nello SKU Essentials sia nello SKU Pro, ti verrà addebitato l'importo in base allo SKU Pro.

L'utilizzo del mascheramento dei campi è una buona pratica di progettazione per assicurarsi di non richiedere dati non necessari, il che aiuta a evitare tempi di elaborazione e addebiti di fatturazione non necessari.

Informazioni sulle sessioni di Completamento automatico (nuovo)

Una sessione di Autocomplete (New) include una o più richieste di Autocomplete (New) e una richiesta di Place Details (New) o di Address Validation. Lo stesso token di sessione viene passato alla richiesta di completamento automatico (nuovo) e alla successiva richiesta di Place Details (nuovo) o di Address Validation.

Una sessione inizia con la prima richiesta di completamento automatico (nuovo). Viene quindi effettuata una richiesta di Place Details (nuovo) o di Address Validation quando l'utente ha selezionato uno dei suggerimenti di completamento automatico (nuovo). Se una sessione viene abbandonata, ovvero non viene effettuata alcuna richiesta Place Details (New) o Address Validation, le richieste Autocomplete (New) vengono addebitate come se non fosse stato fornito alcun token di sessione.

Dopo che un utente ha selezionato un luogo (ovvero viene effettuata una richiesta Place Details (New) o Address Validation), devi avviare una nuova sessione utilizzando un nuovo token di sessione.

Un token di sessione è valido per una sola sessione e non può essere utilizzato per più di una sessione. 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.

Dettagli e prezzi degli SKU per l'API Places

La tabella seguente mostra i dettagli e i prezzi degli SKU con pagamento a consumo per l'API Places.

CategoriaDettagli SKU dell'API Places (New)Prezzi degli SKU
Essentials SKU: Autocomplete Requests Listino prezzi globale
Listino prezzi per l'India
Essentials SKU: Autocomplete Session Usage Listino prezzi globale
Listino prezzi per l'India
Essentials SKU: Place Details Essentials (IDs Only) Listino prezzi globale
Listino prezzi per l'India
Essentials SKU: Place Details Essentials Listino prezzi globale
Listino prezzi per l'India
Essentials SKU: Nozioni di base sulla Ricerca testuale (solo ID) Listino prezzi globale
Listino prezzi per l'India
Pro SKU: Nearby Search Pro Listino prezzi globale
Listino prezzi per l'India
Pro SKU: Place Details Pro Listino prezzi globale
Listino prezzi per l'India
Pro SKU: Text Search Pro Listino prezzi globale
Listino prezzi per l'India
Enterprise SKU: Nearby Search Enterprise Listino prezzi globale
Listino prezzi per l'India
Enterprise SKU: Nearby Search Enterprise + Atmosphere Listino prezzi globale
Listino prezzi per l'India
Enterprise SKU: Place Details Enterprise Listino prezzi globale
Listino prezzi per l'India
Enterprise SKU: Place Details Enterprise + Atmosphere Listino prezzi globale
Listino prezzi per l'India
Enterprise SKU: Text Search Enterprise Listino prezzi globale
Listino prezzi per l'India
Enterprise SKU: Text Search Enterprise + Atmosphere Listino prezzi globale
Listino prezzi per l'India
Enterprise SKU: Place Details Photos Listino prezzi globale
Listino prezzi per l'India
CategoriaDettagli SKU dell'API Places (legacy)Prezzi degli SKU
Essentials SKU: Autocomplete - Per Request Listino prezzi globale
Listino prezzi per l'India
Essentials SKU: Completamento automatico (incluso in Place Details) - Per sessione Listino prezzi globale
Listino prezzi per l'India
Essentials

SKU: dati di base

Costi aggiuntivi:

Listino prezzi globale
Listino prezzi per l'India
Essentials SKU: Trova luogo - Solo ID Listino prezzi globale
Listino prezzi per l'India
Essentials SKU: Place Details Essentials - ID Refresh Listino prezzi globale
Listino prezzi per l'India
Essentials SKU: Query Autocomplete - Per Request Listino prezzi globale
Listino prezzi per l'India
Pro SKU: Autocomplete without Place Details - Per Session Listino prezzi globale
Listino prezzi per l'India
Pro

SKU: Find Place

Costi aggiuntivi:

Listino prezzi globale
Listino prezzi per l'India
Pro

SKU: Places - Nearby Search

Costi aggiuntivi:

Listino prezzi globale
Listino prezzi per l'India
Pro

SKU: Places - Text Search

Costi aggiuntivi:

Listino prezzi globale
Listino prezzi per l'India
Pro

SKU: Places Details

Costi aggiuntivi:

Listino prezzi globale
Listino prezzi per l'India
Enterprise

SKU: Atmosphere Data

Costi aggiuntivi:

Listino prezzi globale
Listino prezzi per l'India
Enterprise

SKU: dati di contatto

Costi aggiuntivi:

Listino prezzi globale
Listino prezzi per l'India
Enterprise SKU: Place Photos Listino prezzi globale
Listino prezzi per l'India

Limiti di utilizzo

Per esaminare e gestire le quote e i limiti di utilizzo, consulta Quote e avvisi quota.

  • API Places (nuova): il limite di frequenza al minuto è per metodo API per progetto. In altre parole, ogni metodo API ha una quota separata.

  • API Places (Legacy): il limite di frequenza al minuto viene calcolato come la somma delle richieste lato client e lato server per tutte le applicazioni che utilizzano le credenziali dello stesso progetto.

Strategie convenienti per l'API Places

Questa sezione fornisce modi per ottimizzare l'utilizzo e ridurre i costi associati all'API Places.

Utilizzare le maschere di campo

L'utilizzo del mascheramento dei campi garantisce di non richiedere dati non necessari, il che contribuisce a ridurre la latenza e gli addebiti di fatturazione.

Per le richieste di Place Details (nuovo), Nearby Search (nuova) e Ricerca testuale (nuova), utilizza una maschera del campo per specificare l'elenco dei campi da restituire nella risposta.

Ti verrà quindi addebitato lo SKU più elevato applicabile alla tua richiesta. Ad esempio, se selezioni campi sia dagli SKU Essentials che Pro, la fatturazione viene eseguita in base allo SKU Pro.

Utilizzare i prezzi per sessione con Place Details (nuovo)

Se le tue applicazioni hanno un volume di chiamate mensile pari o superiore a 100.001-500.000 o se gli utenti effettuano più di 12 richieste di completamento automatico per sessione, Google consiglia di utilizzare le sessioni con Autocomplete (New). Le sessioni semplificano i prezzi e forniscono un modello tariffario coerente da utilizzare con Autocomplete (New).

Per saperne di più, consulta Completamento automatico (nuovo) e prezzi delle sessioni.

Modifica quota

I limiti di quota definiscono il numero massimo di richieste consentite per una specifica API o un servizio in un determinato periodo di tempo. Quando il numero di richieste nel tuo progetto raggiunge il limite di quota, il tuo servizio smette di rispondere alle richieste.

Per modificare un valore di quota per la tua API, segui questi passaggi:

  1. Nella console Cloud, vai a Google Maps Platform > Quote.
  2. Seleziona l'API per cui vuoi modificare la quota.
  3. Identifica il valore della quota che vuoi modificare e selezionalo utilizzando la casella di controllo.
  4. Fai clic su Modifica, inserisci un nuovo valore di quota e fai clic su Invia richiesta.

Visualizzare le richieste di aumento della quota

Per visualizzare tutte le richieste di aumento della quota, incluse quelle passate e in attesa:

  1. Nella console Cloud, vai a Google Maps Platform > Quote.
  2. Seleziona l'API per cui vuoi visualizzare la richiesta di aumento della quota.
  3. Fai clic su Aumenta richieste.

Limitazioni dei Termini e condizioni d'uso

Per informazioni sui Termini e condizioni d'uso, consulta le norme relative all'API Places e la sezione Limitazioni della licenza dei Termini di servizio di Google Maps Platform.