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 dei campi da restituire nella risposta. Ti verrà addebitato l'SKU più alto applicabile alla tua richiesta. Ciò significa che se selezioni i campi negli SKU Essentials e Pro, ti verrà addebitato l'importo in base allo SKU Pro.

L'utilizzo delle maschere di campo è una buona pratica di progettazione per assicurarti di non richiedere dati non necessari, il che contribuisce a evitare tempi di elaborazione e addebiti di fatturazione non necessari.

Informazioni sulle sessioni 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 Autocomplete (New). Viene quindi effettuata una richiesta Place Details (New) o Address Validation quando l'utente ha selezionato uno dei suggerimenti 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 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 API Places (New)Prezzi degli SKU
Essentials SKU: Autocomplete Requests Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials SKU: Autocomplete Session Usage Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials SKU: Place Details Essentials (IDs Only) Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials SKU: Place Details Essentials Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials SKU: Text Search Essentials (IDs Only) Elenco dei prezzi globali
Elenco dei prezzi per l'India
Pro SKU: Nearby Search Pro Elenco dei prezzi globali
Elenco dei prezzi per l'India
Pro SKU: Place Details Pro Elenco dei prezzi globali
Elenco dei prezzi per l'India
Pro SKU: Text Search Pro Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise SKU: Nearby Search Enterprise Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise SKU: Nearby Search Enterprise + Atmosphere Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise SKU: Place Details Enterprise Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise SKU: Place Details Enterprise + Atmosphere Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise SKU: Text Search Enterprise Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise SKU: Text Search Enterprise + Atmosphere Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise SKU: Place Details Photos Elenco dei prezzi globali
Elenco dei prezzi per l'India
CategoriaDettagli SKU API Places (legacy)Prezzi degli SKU
Essentials SKU: Autocomplete - Per Request Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials SKU: Autocomplete (included with Place Details) - Per Session Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials

SKU: Basic Data

Addebiti aggiuntivi:

Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials SKU: Find Place - ID only Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials SKU: Place Details Essentials - ID Refresh Elenco dei prezzi globali
Elenco dei prezzi per l'India
Essentials SKU: Query Autocomplete - Per Request Elenco dei prezzi globali
Elenco dei prezzi per l'India
Pro SKU: Autocomplete without Place Details - Per Session Elenco dei prezzi globali
Elenco dei prezzi per l'India
Pro

SKU: Find Place

Addebiti aggiuntivi:

Elenco dei prezzi globali
Elenco dei prezzi per l'India
Pro

SKU: Places - Nearby Search

Addebiti aggiuntivi:

Elenco dei prezzi globali
Elenco dei prezzi per l'India
Pro

SKU: Places - Text Search

Addebiti aggiuntivi:

Elenco dei prezzi globali
Elenco dei prezzi per l'India
Pro

SKU: Places Details

Addebiti aggiuntivi:

Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise

SKU: Atmosphere Data

Addebiti aggiuntivi:

Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise

SKU: Contact Data

Addebiti aggiuntivi:

Elenco dei prezzi globali
Elenco dei prezzi per l'India
Enterprise SKU: Place Photos Elenco dei prezzi globali
Elenco dei 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. 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 economiche per l'API Places

Questa sezione fornisce informazioni su come ottimizzare l'utilizzo e ridurre i costi associati all'API Places.

Utilizza le maschere di campo

L'utilizzo delle maschere di campo garantisce di non richiedere 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 dei campi da restituire nella risposta.

Ti verrà addebitato l'SKU più alto applicabile alla tua richiesta. Ad esempio, se selezioni i campi negli SKU Essentials e 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, oppure 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 per l'utilizzo con Autocomplete (New).

Per saperne di più, consulta Completamento automatico (New) e prezzi per sessione.

Modifica quota

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

Per modificare il valore di una quota per l'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 della 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:

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