Utilizzo e fatturazione dell'API Places

Informazioni sulle maschere di campo

Per Place Details (New), Nearby Search (New) e Text Search (New), utilizza l'intestazione FieldMask nelle richieste API per specificare l'elenco dei campi da restituire nella risposta. Ti verrà quindi addebitato il prezzo dello SKU più alto applicabile alla tua richiesta. Ciò significa che se selezioni campi sia negli SKU Essentials che in quelli Pro, la fatturazione si basa sullo 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 Autocomplete (nuovo)

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 alla richiesta Address Validation.

Una sessione inizia con la prima richiesta Autocomplete (New). Viene quindi effettuata una richiesta Place Details (New) o Address Validation quando l'utente ha selezionato uno dei suggerimenti di Autocomplete (New). 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 è stata 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 dello SKU e i prezzi dell'API Places.

CategoriaDettagli SKU dell'API Places (New)Prezzi degli SKU
Essentials SKU: Autocomplete Requests Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: Autocomplete Session Usage Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: Place Details Essentials (solo ID) Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: Place Details Essentials Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: Nozioni di base sulla ricerca di testo (solo ID) Listino prezzi principale
Listino prezzi per l'India
Pro SKU: Nearby Search Pro Listino prezzi principale
Listino prezzi per l'India
Pro SKU: Place Details Pro Listino prezzi principale
Listino prezzi per l'India
Pro SKU: Text Search Pro Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Nearby Search Enterprise Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Nearby Search Enterprise Plus Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Place Details Enterprise Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Place Details Enterprise + Atmosphere Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Text Search Enterprise Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Text Search Enterprise + Atmosphere Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Place Details Photos Listino prezzi principale
Listino prezzi per l'India
CategoriaDettagli SKU dell'API Places (legacy)Prezzi degli SKU
Essentials SKU: Autocomplete - Per Request Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: Autocomplete (richiesta inclusa con Place Details) - Per Session Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: dati di base Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: Find Place - ID only Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: Place Details Essentials- ID Refresh Listino prezzi principale
Listino prezzi per l'India
Essentials SKU: Query Autocomplete - Per Request Listino prezzi principale
Listino prezzi per l'India
Pro SKU: Autocomplete senza Place Details - Per Session Listino prezzi principale
Listino prezzi per l'India
Pro SKU: Find Place Listino prezzi principale
Listino prezzi per l'India
Pro SKU: Places - Nearby Search Listino prezzi principale
Listino prezzi per l'India
Pro SKU: Places - Text Search Listino prezzi principale
Listino prezzi per l'India
Pro SKU: Place Details Pro Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Atmosphere Data Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Contact Data Listino prezzi principale
Listino prezzi per l'India
Enterprise SKU: Place Photos Listino prezzi principale
Listino prezzi per l'India

Limiti di utilizzo

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

  • API Places (New): il limite di frequenza al minuto è per metodo API per progetto. Ciò significa che ogni metodo API ha una quota separata.

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

Modifica quota

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

Per modificare un valore di quota per la tua API:

  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 di utilizzo, consulta le norme per l'API Places e la sezione Limitazioni della licenza dei Termini di servizio di Google Maps Platform.