Utilizzo e fatturazione dell'API Places

Informazioni sulle maschere di campo

Per Place Details (New), Nearby Search (New) e Ricerca testuale (New), utilizza l'intestazione FieldMask nelle richieste API per specificare l'elenco di 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 negli SKU Essentials che in quelli Pro, ti verrà addebitato l'importo in base allo SKU Pro.

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

Informazioni sulle sessioni di Autocomplete (New)

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

Una sessione inizia con la prima richiesta di Autocomplete (New). Quando l'utente seleziona uno dei suggerimenti di Autocomplete (New), viene effettuata una richiesta Place Details (New) o Address Validation. 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 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 (nuova)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: Text Search Essentials (IDs Only) 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: Autocomplete (included with Place Details) - Per Session 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: Find Place - ID only 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.

Utilizza le maschere di campo

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

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

Ti verrà quindi addebitato l'importo dello SKU più alto applicabile alla tua richiesta. Ad esempio, se selezioni campi sia dallo SKU Essentials sia dallo SKU Pro, ti verrà addebitato l'importo in base allo SKU Pro.

Utilizza i prezzi per sessione con Place Details (New)

Se le tue applicazioni hanno un volume di chiamate mensile compreso tra 100.001 e 500.000 o superiore 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 di prezzi coerente da utilizzare con Autocomplete (New).

Per saperne di più, consulta Autocomplete (New) e prezzi delle sessioni.

Modifica quota

I limiti di quota definiscono il numero massimo di richieste consentite per un'API o un servizio specifico entro un determinato periodo di tempo. Quando il numero di richieste nel progetto raggiunge il limite di quota, il 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 per la quota e fai clic su Invia richiesta.

Visualizza le richieste di aumento della quota

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

  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 Richieste di aumento.

Limitazioni dei Termini e condizioni d'uso

Per ulteriori 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.