SDK Places per utilizzo e fatturazione Android

Errore: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

L'SDK Places per Android utilizza un modello di prezzi con pagamento a consumo. Le richieste dell'SDK Places per Android relative all'SDK Places per Android vengono fatturate in base allo SKU. Oltre ai Termini e condizioni d'uso generali di Google, esistono limiti di utilizzo specifici per l'SDK Places per Android. Gestisci i costi e l'utilizzo con gli strumenti disponibili in Google Cloud Console.

Modalità di fatturazione dell'SDK Places per Android

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

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'SDK Places per Android

Informazioni sulle sessioni di completamento automatico

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

Dopo che un utente ha selezionato un luogo (ad esempio viene effettuata una chiamata a Places Details), 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 è valido 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 un token di sessione.

Le richieste di completamento automatico e le richieste 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 a fetchPlaceFromPlaceID: o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Servizio web: ogni richiesta di Places viene basata sui campi specificati nella richiesta.

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


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 base della richiesta Luoghi e non comportano costi aggiuntivi. Lo SKU Dati di base viene attivato quando vengono richiesti i seguenti campi:

Android

address_component, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color,name, permanently_closed, photo, type, url, utc_offset o vicinity

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 VOLUMI MESI
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
Costo richiesta per luoghi
+ 0.00 USD
Costo richiesta per luoghi
+ 0.00 USD
Costo richiesta per luoghi
+ 0.00 USD

SKU: dati di contatto

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

Android

OPENING_HOURS, PHONE_NUMBER o 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 VOLUMI MESI
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
Costo richiesta per luoghi
+ 0,003 USD per ogni
(+ 3,00 USD per 1000)
Costo della richiesta per Places
+ 0,0024 $ ciascuno
(+ 2,40 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi dei volumi

SKU: dati sull'atmosfera

Utilizzando il parametro dei campi nella richiesta Dettagli luogo o Trova luogo, puoi limitare la risposta solo a tali campi specificati. I campi nella categoria Ambiente comportano un addebito aggiuntivo. Lo SKU Dati atmosfera viene attivato quando vengono richiesti i seguenti campi:

  • Android: PRICE_LEVEL, RATING o USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating o GMSPlaceFieldUserRatingsTotal
  • JavaScript: vedi Campi (Dettagli 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 VOLUMI MESI
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
Costo richiesta per luoghi
+ 0,005 USD per ogni
(+ 5,00 USD per 1000)
Costo della richiesta per i luoghi
+ 0,004 USD ciascuno
(+ 4,00 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi dei volumi

SKU: completamento automatico – Per richiesta

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

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

Per le richieste di completamento automatico provenienti dal widget Place Autocomplete dell'API Maps JavaScript potrebbe essere addebitato un Autocomplete – SKU di Richiesta nel caso in cui le chiamate siano effettuate da una sessione di completamento automatico non valida. Questo 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 VOLUMI MESI
(Prezzo per RICHIESTA)
0-100.000 100.001-500.000 più di 500.000
0,00283 $ per ogni
(2,83 USD per 1000)
0,00227 USD per ogni
(2,27 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi dei volumi

SKU: completamento automatico senza dettagli del luogo - Per sessione

Lo SKU Completamento automatico senza dettagli 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 VOLUMI MESI
(Prezzo per SESSIONE)
0-100.000 100.001-500.000 più di 500.000
0,017 $ ogni
(17,00 USD per 1000)
0,0136 USD per ogni
(13,60 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi dei volumi

Esempio

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

Android

iOS

Servizio web

Sulla fattura, vedrai indicato questo SKU (quando visualizzi la fattura in base allo SKU):

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

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

Lo SKU Autocomplete (included with Place Details) – Per Session 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 di 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 Dettagli luogo.

Una richiesta Dettagli luogo genera SKU di 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, Contatto e Ambiente).

Le richieste di aggiornamento dell'ID luogo dettagli (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 VOLUMI MESI
(Prezzo per SESSIONE)
0-100.000 100.001-500.000 più di 500.000
0.00 EUR 0.00 EUR 0.00 EUR

Esempio

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

Android

iOS

Servizio web

Nella tua fattura troverai questi SKU elencati (quando visualizza la tua fattura per SKU):

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

SKU: dettagli luogo

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

INTERVALLO DI VOLUMI MESI
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,017 $ ogni
(17,00 USD per 1000)
0,0136 USD per ogni
(13,60 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi dei volumi

Lo SKU Dettagli luogo viene generato da queste API:

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

Una chiamata o una richiesta dei dettagli del luogo genera anche SKU dati (di base, Contatto e/o Ambiente), 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 viene addebitata 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 Dettagli luogo e specifica solo il campo dell'indirizzo: getPlaceDetails(fields: formatted_address)
    Nella fattura troverai questi SKU elencati (durante la visualizzazione della fattura per SKU):
    • Dettagli luogo (prezzo a partire da 0,017 $ per sessione)
    • Dati di base (fatturati a 0.00 USD)
  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 Dettagli luogo e specifica il campo Numero di telefono: getPlaceDetails(fields: formatted_phone_number)
    Nella fattura troverai questi SKU elencati (durante la visualizzazione della fattura per SKU):
    • Dettagli luogo (prezzo a partire da 0,017 $ per sessione)
    • Dati di contatto (prezzo a partire da 0,003 USD 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 è il valore predefinito se non specifichi alcun campo): getPlaceDetails().
    Nella fattura troverai questi SKU elencati (durante la visualizzazione della fattura per SKU):
    • Dettagli luogo (prezzo a partire da 0,017 $ per sessione)
    • Dati di base (fatturati a 0.00 USD)
    • Dati di contatto (prezzo a partire da 0,003 USD per richiesta)
    • Dati sull'atmosfera (prezzo a partire da 0,005 USD per richiesta)

SKU: Trova il luogo attuale

L'opzione Trova luogo attuale viene addebitata per le chiamate a findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

INTERVALLO DI VOLUMI MESI
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,030 $ ogni
(30,00 USD ogni 1000)
0,024 $ ogni
(24,00 USD ogni 1000)
Contatta il team di vendita per informazioni sui prezzi dei volumi

Le chiamate a findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) generano anche SKU dati (Di base, Contatto e/o Ambiente), a seconda dei campi specificati nella chiamata. Specifica i campi di dati per limitare la risposta solo a tali campi. Ti viene addebitato il costo della chiamata Trova il luogo attuale e dei dati richiesti.

Esempi

  1. Chiama il numero findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifica solo il campo ADDRESS. Nella tua fattura troverai questi SKU elencati (quando visualizza la tua fattura per SKU):
    • Trova il luogo attuale (a partire da 0,030 $ per richiesta)
    • Dati di base (fatturati a 0.00 USD)
  2. Chiama il numero findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifica il campo PHONE_NUMBER. Nella tua fattura troverai questi SKU elencati (quando visualizza la tua fattura per SKU):
    • Trova il luogo attuale (a partire da 0,030 $ per richiesta)
    • Dati di contatto (prezzo a partire da 0,003 USD per richiesta)
  3. Richiama findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifica i campi di tutti e tre i bucket di tipi di dati. Nella tua fattura troverai questi SKU elencati (quando visualizza la tua fattura per SKU):
    • Trova il luogo attuale (a partire da 0,030 $ per richiesta)
    • Dati di base (fatturati a 0.00 USD)
    • Dati di contatto (prezzo a partire da 0,003 USD per richiesta)
    • Dati sull'atmosfera (prezzo a partire da 0,005 USD per richiesta)

SKU: foto del luogo

Uno SKU Foto del posto viene addebitato per:

Per il servizio JavaScript, la chiamata del metodo PlacePhoto.getUrl() non causa la fatturazione finché l'URL non viene effettivamente utilizzato per ottenere i dati di pixel.

INTERVALLO DI VOLUMI MESI
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 più di 500.000
0,007 $ ogni
(7,00 USD per 1000)
0,0056 $ ogni
(5,60 USD per 1000)
Contatta il team di vendita per informazioni sui prezzi dei volumi

Limitazioni dei Termini e condizioni d'uso

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

Gestisci il costo di utilizzo

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

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

  1. In Cloud Console, apri la pagina Quote di Google Maps Platform.
  2. Fai clic sul menu a discesa delle API e seleziona l'SDK Places per Android.
  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 di modifica per quel limite.
    Nella finestra di dialogo visualizzata, nel campo Limite di quota, inserisci il limite di quota giornaliera fatturabile (fino al limite di quota, se specificato da Google) e seleziona Salva.

Se l'utilizzo dell'API raggiunge il limite di quota fatturabile in un determinato giorno, l'applicazione non sarà in grado di 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 prima di creare un account di fatturazione Google Maps Platform.