Utilizzo e fatturazione dell'API Places

L'API Places utilizza un modello di prezzi con pagamento a consumo. Le richieste dell'API Places generano chiamate a più SKU. Oltre ai Termini e condizioni d'uso generali di Google, esistono limiti di utilizzo specific per l'API Places. Gestire costi e utilizzo con gli strumenti disponibili in Google Cloud Console.

Modalità di fatturazione dell'API Places

L'API Places utilizza un modello di prezzi con pagamento a consumo. Gli SDK e le API di Google Maps Platform vengono fatturati in base allo SKU. Viene monitorato l'utilizzo di ogni SKU e ogni API o SDK può avere più di uno SKU di prodotto. Il costo viene calcolato di

Utilizzo SKU × Prezzo per ogni utilizzo

Utilizza il nostro Calcolatore prezzi e utilizzo per stimare il costo di utilizzo per API o SDK. Per gli SKU Google Maps Platform idonei, è disponibile un credito Google Maps Platform di 200 $ogni mese per ogni account di fatturazione. Questo credito viene applicato automaticamente1 agli SKU idonei.

Prezzi dell'API Places

Informazioni sulle sessioni di completamento automatico

Una sessione di completamento automatico include alcune richieste di completamento automatico (per recuperare suggerimenti su un luogo come tipo di utente) e al massimo una richiesta Dettagli luogo (per recuperare i dettagli sul luogo selezionato dall'utente). Lo stesso token della sessione viene passato al completamento automatico e alla richiesta Dettagli luogo successivo. Una sessione inizia con la prima richiesta di completamento automatico (che in genere si verifica quando l'utente inizia a digitare). Viene effettuata una chiamata Dettagli luogo quando l'utente ha selezionato uno dei suggerimenti di completamento automatico. Se un utente non seleziona un suggerimento, non viene effettuata alcuna chiamata Dettagli luogo.

Dopo che un utente ha selezionato un luogo (ad esempio, viene effettuata una chiamata Dettagli luogo), devi avviare una nuova sessione utilizzando un nuovo token di sessione.

Le sessioni di completamento automatico possono essere generate dalle seguenti API:

Un token di sessione è ideale per una sessione utente e non deve essere utilizzato per più di una sessione utente. 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.

Le richieste di completamento automatico e quelle di Dettagli luogo che utilizzano le sessioni vengono fatturate su SKU diversi.

Informazioni sugli SKU di dati di Places

Uno o più SKU di dati vengono attivati per:

  • Android: ogni richiesta a fetchPlace() o findCurrentPlace()
  • iOS: ogni chiamata al numero fetchPlaceFromPlaceID: o al numero findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Servizio web: ogni richiesta di Places dipende dai campi specificati nella richiesta

Le richieste di dati generano un addebito in aggiunta al costo della richiesta di Places. Gli addebiti per i dati sono sempre in coppia con le richieste di Places.

Per il servizio web, queste API Places richiamano l'assistenza specificando i campi di dati da restituire:

Per il servizio web, queste API delle chiamate di Places non supportano NON specificare i campi restituiti. Queste chiamate restituiscono sempre tutti i dati di Places, addebitando i tre SKU di Places in aggiunta al costo per ogni richiesta API:


SKU: dati di base

Utilizzando il parametro dei campi nella richiesta Dettagli luogo o Trova luogo, puoi limitare la risposta solo ai campi specificati. I campi della categoria Di base sono inclusi nel costo di base della richiesta Places e non comportano alcun costo aggiuntivo. Lo SKU Dati di base viene attivato quando viene richiesto uno dei seguenti campi:

Android

Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT o Place.Field.UTC_OFFSET

iOS

GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes o GMSPlaceFieldViewport

Servizio web

address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity o wheelchair_accessible_entrance

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
Costo richiesta per luoghi
+ 0,00 $
Costo richiesta per luoghi
+ 0,00 $
Costo richiesta per luoghi
+ 0,00 $

SKU: dati di contatto

Se utilizzi il parametro campi nella richiesta Dettagli luogo o Trova luogo per i servizi web oppure un array di Place.Field per Android o iOS, puoi limitare la risposta solo ai campi specificati. I campi nella categoria Contatto comporteranno un addebito aggiuntivo. Lo SKU Dati di contatto viene attivato quando viene richiesto uno dei seguenti campi:

Android

Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER o Place.Field.WEBSITE_URI

iOS

GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber o GMSPlaceFieldWebsite

Servizio web

formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours o website

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
Costo richiesta per i luoghi
+ 0,003 $ per ciascuno
(+ 3,00 USD per 1000)
Costo richiesta per i luoghi
+ 0,0024 $ per ciascuno
(+ 2,40 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

SKU: dati sull'atmosfera

Se utilizzi il parametro dei campi nella richiesta Dettagli luogo o Trova luogo, puoi limitare la risposta solo ai campi specificati. I campi nella categoria Atmosfera comportano un costo aggiuntivo. Lo SKU Dati atmosfera viene attivato quando viene richiesto uno dei seguenti campi:

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.TAKEOUT o Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn o GMSPlaceFieldCurbsidePickup.
  • JavaScript: consulta l'articolo Campi (dettagli del luogo).
  • Servizio web: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout o user_ratings_total.
INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
Costo richiesta per i luoghi
+ 0,005 $ per ciascuno
(+ 5,00 USD per 1000)
Costo richiesta per i luoghi
+ 0,004 $ per ciascuno
(+ 4,00 $ per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

SKU: completamento automatico - Per richiesta

Lo SKU Completamento automatico - Per richiesta viene addebitato per le chiamate o le richieste che non includono un token di sessione:

Anche alle chiamate effettuate da una sessione di completamento automatico non valida (ad esempio una sessione che riutilizza un token di sessione) viene addebitato anche lo SKU Autocomplete – Per Request.

Alle richieste di completamento automatico del widget di completamento automatico dell'API Maps JavaScript potrebbe essere addebitato lo SKU di completamento automatico - per richiesta nel caso in cui le chiamate vengano effettuate da una sessione di completamento automatico non valida. Ciò può accadere quando un utente digita più indirizzi diversi o copia/incolla indirizzi diversi nel widget e non seleziona sempre una previsione di completamento automatico.

INTERVALLO DI VOLUME MENSILE
(Prezzo per RICHIESTA)
0-100.000 100.001-500.000 più di 500.000
0,00283 USD per ogni
(2,83 USD per 1000)
0,00227 $ per ogni
(2,27 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

SKU: completamento automatico senza dettagli sul luogo – Per sessione

Lo SKU Completamento automatico senza dettagli del luogo – Per sessione viene addebitato per una sessione di completamento automatico che non include una richiesta Dettagli luogo (entro pochi minuti dall'inizio della sessione).

INTERVALLO DI VOLUME MENSILE
(Prezzo per SESSIONE)
0-100.000 100.001-500.000 più di 500.000
0,017 USD per ogni
(17,00 USD per 1000)
0,0136 $ per ogni
(13,60 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

Esempio

Se la tua applicazione emette queste due chiamate in una singola sessione:

Android

iOS

Servizio web

Nella fattura troverai questo SKU (visualizzato in base allo SKU):

  • Completamento automatico senza dettagli del luogo – Per sessione (prezzo a partire da 0,017 USD per sessione)

SKU: completamento automatico (incluso con i dettagli del luogo) – Per sessione

Lo SKU Completamento automatico (incluso con Dettagli luogo) - Per sessione viene addebitato per una sessione di completamento automatico che include uno dei seguenti elementi:

  • Android: una chiamata al numero fetchPlace()
  • iOS: una chiamata al numero fetchPlaceFromPlaceID:
  • Servizio web: una richiesta Dettagli luogo

La richiesta di completamento automatico è disponibile senza costi aggiuntivi e la successiva chiamata Dettagli luogo viene addebitata in base ai normali prezzi di Place Details.

Una richiesta Dettagli luogo genera SKU dati (di base, contatto e/o atmosfera), a seconda dei campi specificati nella richiesta.

Se non specifichi campi nella richiesta Dettagli luogo, vengono attivati tutti gli SKU di dati (di base, di contatto e atmosfera).

Le richieste di aggiornamento dell'ID dettagli del luogo (richieste che specificano solo il campo place_id) durante una sessione di completamento automatico vengono fatturate come SKU: completamento automatico senza dettagli luogo - Per sessione.

INTERVALLO DI VOLUME MENSILE
(Prezzo per SESSIONE)
0-100.000 100.001-500.000 più di 500.000
0,00 $ 0,00 $ 0,00 $

Esempio

Se la tua applicazione emette le seguenti tre chiamate in una singola sessione:

Android

iOS

Servizio web

Nella fattura troverai gli SKU elencati (visualizzati in base allo SKU):

  • Completamento automatico (incluso con i dettagli del luogo) - Per sessione (fatturato a 0,00 EUR)
  • Dettagli del luogo (prezzo a partire da 0,017 $ per sessione)
  • Dati di base (fatturati a 0.00 EUR)

SKU: completamento automatico delle query – Per richiesta

Per ogni richiesta viene addebitato uno SKU Query Autocomplete – Per Request a:

INTERVALLO DI VOLUME MENSILE
(Prezzo per RICHIESTA)
0-100.000 100.001-500.000 più di 500.000
0,00283 USD per ogni
(2,83 USD per 1000)
0,00227 $ per ogni
(2,27 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

I prezzi per sessione di completamento automatico non sono supportati se utilizzi il completamento automatico delle query. Successivamente le chiamate di Places Details vengono addebitate in base ai normali prezzi di Places Details.


SKU: dettagli del luogo

Le chiamate per i dettagli del luogo vengono addebitate come segue:

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,017 USD per ogni
(17,00 USD per 1000)
0,0136 $ per ogni
(13,60 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

Lo SKU Dettagli luogo viene generato da queste API:

Con l'API e i servizi web, lo SKU Dettagli luogo viene addebitato indipendentemente dal fatto che venga fornito o meno un token di sessione.

Una chiamata o una richiesta Dettagli luogo genera anche gli SKU di dati (di base, contatto e/o atmosfera), a seconda dei campi specificati nella chiamata o nella richiesta. Se i campi NO sono specificati nella chiamata o nella richiesta Dettagli luogo, vengono attivati TUTTI gli SKU dati e ti vengono addebitati i costi per la chiamata o la richiesta Dettagli luogo più il costo di tutti i dati.

Esempi

  1. Effettua una delle seguenti chiamate o richieste:
    • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica solo il campo ADDRESS
    • API o servizio web: effettua una richiesta Place Details e specifica solo il campo dell'indirizzo: getPlaceDetails(fields: formatted_address)
    Nella fattura troverai gli SKU elencati di seguito (quando visualizza la fattura per SKU):
    • Dettagli del luogo (prezzo a partire da 0,017 $ per sessione)
    • Dati di base (fatturati a 0.00 EUR)
  2. Effettua una delle seguenti chiamate o richieste:
    • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica solo il campo PHONE_NUMBER
    • API o servizio web: effettua una richiesta Place Details e specifica il campo del numero di telefono: getPlaceDetails(fields: formatted_phone_number)
    Nella fattura troverai gli SKU elencati di seguito (quando visualizza la fattura per SKU):
    • Dettagli del luogo (prezzo a partire da 0,017 $ per sessione)
    • Dati di contatto (a partire da 0,003 $ per richiesta)
  3. Effettua una delle seguenti chiamate o richieste:
    • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica tutti i campi
    • API o servizio web: effettua una richiesta Dettagli luogo e specifica tutti i campi (questo tipo di richiesta è quello predefinito se non specifichi alcun campo): getPlaceDetails().
    Nella fattura troverai gli SKU elencati di seguito (quando visualizza la fattura per SKU):
    • Dettagli del luogo (prezzo a partire da 0,017 $ per sessione)
    • Dati di base (fatturati a 0.00 EUR)
    • Dati di contatto (a partire da 0,003 $ per richiesta)
    • Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

SKU: dettagli del luogo – Aggiornamento ID

Utilizza la richiesta Dettagli luogo per aggiornare gli ID luogo inattivi. Questi tipi di richieste sono disponibili senza costi aggiuntivi.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,00 $ 0,00 $ 0,00 $

Esempio

Crea una richiesta Dettagli luogo specificando solo il campo ID luogo: getPlaceDetails(fields: place_id). Nella fattura troverai questo SKU (visualizzato in base allo SKU):

  • Dettagli luogo – Aggiorna ID (fatturato a 0,00 EUR)

SKU: Trova luogo

Per una richiesta Trova luogo viene addebitato il costo di Find Place.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,017 USD per ogni
(17,00 USD per 1000)
0,0136 $ per ogni
(13,60 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

Le richieste Trova luogo generano anche SKU di dati (di base, contatto e/o atmosfera), a seconda dei campi specificati nella richiesta. Come per le richieste Dettagli luogo, puoi utilizzare il parametro dei campi nella richiesta Trova luogo per limitare la risposta solo a quei campi specificati. Ti vengono addebitati i costi per la richiesta Trova luogo e per i dati richiesti. Per impostazione predefinita, se vengono richiesti campi NO, viene restituito solo l'ID luogo, quindi non vengono addebitati ulteriori costi per i dati.

Esempi

  1. Per effettuare una richiesta Trova luogo specifica soltanto il campo dell'indirizzo: FindPlace(fields: formatted_address). Nella fattura troverai gli SKU elencati di seguito (quando visualizzi la fattura per SKU):
    • Trova luogo (prezzo a partire da 0,017 $ per chiamata)
    • Dati di base (fatturati a 0.00 EUR)
  2. Effettua una richiesta Trova luogo e specifica il campo del numero di telefono: FindPlace(fields: formatted_phone_number). In fattura, vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Trova luogo (prezzo a partire da 0,017 $ per chiamata)
    • Dati di contatto (a partire da 0,003 $ per richiesta)
  3. Effettua una richiesta Trova luogo e specifica i campi da tutti e tre i bucket di tipi di dati: FindPlace(fields: formatted_address, opening_hours, price_level). In fattura vedrai questi SKU elencati ( quando visualizzi la fattura per SKU):
    • Trova luogo (prezzo a partire da 0,017 $ per chiamata)
    • Dati di base (fatturati a 0.00 EUR)
    • Dati di contatto (a partire da 0,003 $ per richiesta)
    • Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

SKU: Trova luogo – Solo ID

Le richieste Find Place - ID only vengono trovate per le richieste Find Place che specificano solo l'ID luogo da restituire. Per impostazione predefinita, se nella richiesta Trova luogo non sono specificati campi, viene restituito solo l'ID luogo.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,00 $ 0,00 $ 0,00 $

Esempio

Devi effettuare una richiesta Trova luogo e specificare solo il campo place_id: FindPlace(fields: place_id). Nella fattura troverai questo SKU (visualizzato in base allo SKU):

  • Find Place - Solo ID (fatturato a 0,00 EUR)

L'opzione Luogo - Ricerca nelle vicinanze viene addebitata per le richieste al servizio di ricerca nelle vicinanze dell'API Maps JavaScript (nearbySearch()) o al servizio di ricerca nelle vicinanze dell'API Places

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,032 $ per
(32,00 USD per 1000)
0,0256 $ per ogni
(25,60 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

Le richieste di ricerca nelle vicinanze restituiscono un elenco di luoghi, ma non supportano la specifica dei campi restituiti. Le richieste di ricerca nelle vicinanze restituiscono un sottoinsieme dei campi di dati supportati. Ti viene addebitata la richiesta di Ricerca nelle vicinanze a partire da 0, 032 $ per $, nonché tutti gli SKU di tipo dati (Dati di base, Dati di contatto e Dati sull'atmosfera).

Esempio

Devi effettuare una richiesta di ricerca nelle vicinanze, ad esempio NearbySearch (San Francisco, 100 meters). Nella fattura troverai gli SKU elencati (visualizzati in base allo SKU):

  • Luogo - Ricerca nelle vicinanze (prezzo a partire da 0,032 USD per chiamata)
  • Dati di base (fatturati a 0.00 EUR)
  • Dati di contatto (a partire da 0,003 $ per richiesta)
  • Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

Place – Ricerca testo viene addebitato per le richieste al servizio di ricerca testuale dell'API Maps JavaScript (textSearch()) o al servizio di ricerca testuale dell'API Places.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,032 $ per
(32,00 USD per 1000)
0,0256 $ per ogni
(25,60 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

Le richieste di ricerca testuale restituiscono un elenco di luoghi, ma non supportano la definizione dei campi restituiti. Le richieste di ricerca di testo restituiscono un sottoinsieme dei campi di dati supportati. Ti verranno addebitati i costi per la richiesta di ricerca testuale a partire da 0, 032 $ per ciascuno, nonché a tutti gli SKU di tipo dati (dati di base, dati di contatto e dati sull'atmosfera).

Lo SKU Luogo - Ricerca testo viene generato anche dal metodo widget Place SearchBox dell'API Maps JavaScript: getPlaces() dopo che l'utente ha selezionato una query di luogo (icona: lente d'ingrandimento), non un risultato (icona: segnaposto), come illustrato qui:

Selezione query widget Casella di ricerca Dettagli
Nei risultati del widget della casella di ricerca, dopo aver digitato "pizza" nella casella di ricerca, controlla che accanto a consegna di pizza sia presente un'icona a forma di lente di ingrandimento, che indica che si tratta di una query (e non di un risultato).

Esempio

Effettua una richiesta di ricerca testuale, ad esempio TextSearch(123 Main Street). In fattura, vedrai questi SKU elencati (quando visualizza la fattura per SKU):

  • Luogo - Ricerca di testo (prezzo a partire da 0,032 $ per chiamata)
  • Dati di base (fatturati a 0.00 EUR)
  • Dati di contatto (a partire da 0,003 $ per richiesta)
  • Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

SKU: foto del luogo

Uno SKU Foto del luogo viene addebitato per:

Per il servizio JavaScript, il richiamo del metodo PlacePhoto.getUrl() non provoca la fatturazione fino a quando l'URL non viene effettivamente utilizzato per ottenere i dati di pixel.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,007 USD per ogni
(7,00 USD per 1000)
0,0056 USD ogni
(5,60 1000 USD)
Contatta il team di vendita per informazioni sui prezzi basati sul volume

Altri limiti di utilizzo

Anche se non esiste un numero massimo di richieste al giorno, il seguente limite di utilizzo viene comunque applicato quando si utilizza l'API Places:

  • Il limite di frequenza è 100 richieste al secondo. Viene calcolato sommando le richieste lato client e lato server per tutte le applicazioni che utilizzano le credenziali dello stesso progetto.

Limitazioni dei Termini e condizioni d'uso

Per informazioni sui termini e condizioni d'uso, consulta le norme dell'API Places e la sezione Restrizioni sulle licenze dei Termini di servizio di Google Maps Platform.

Gestisci il costo dell'utilizzo

Per gestire il costo di utilizzo delle API Google Maps Platform, imposta limiti di quota giornalieri per tutte le richieste a qualsiasi API fatturabile. Le quote giornaliere vengono reimpostate a mezzanotte del fuso orario del Pacifico USA.

Per visualizzare o modificare i limiti di quota per l'API Places:

  1. In Cloud Console, apri la pagina Quote di Google Maps Platform.
  2. Fai clic sull'elenco a discesa API e seleziona l'API Places.
  3. Per visualizzare i limiti di quota, scorri verso il basso fino alla scheda Richieste.
    Una tabella elenca i nomi e i limiti delle quote.
  4. Per modificare un limite di quota, fai clic sull'icona Modifica per farlo.
    Nella finestra di dialogo visualizzata, nel campo Limite quota, inserisci il limite di quota giornaliero fatturabile preferito (fino al limite di quota, se applicabile, specificato da Google) e seleziona Salva.

Se l'utilizzo dell'API raggiunge il limite di quota fatturabile in un determinato giorno, la tua applicazione non potrà accedere all'API per il resto della giornata.


  1. Per ricevere il credito di Maps Platform, gli utenti in India devono creare un account di fatturazione Google Cloud Platform.