Errore: 9005 PLACES_API_RATE_LIMIT_EXCEEDED
L'SDK Places per Android utilizza un modello di prezzi con pagamento a consumo. Le richieste all'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. Gestire costi e 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. 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
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 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:
- Il servizio di completamento automatico dei luoghi dell'API Places o il servizio di completamento automatico dei luoghi dell'API Maps JavaScript. Devi progettare la tua applicazione in modo da fornire i token di sessione (potrebbe essere necessario modificare il codice esistente).
- Il widget di completamento automatico dell'API Maps JavaScript. La fatturazione basata sulle sessioni viene attivata automaticamente su questi widget, senza bisogno di modificare il codice.
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
I tre SKU di dati di Places sono: dati di base, dati di contatto e dati sull'atmosfera.Uno o più SKU di dati vengono attivati per:
- Android: ogni richiesta a
fetchPlace()
ofindCurrentPlace()
- iOS: ogni chiamata al numero
fetchPlaceFromPlaceID:
o al numerofindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Servizio web: ogni richiesta di Places dipende dai campi specificati nella richiesta
Gli SKU di dati vengono sempre addebitati in aggiunta allo SKU di base per la richiesta che li attiva. Ad esempio, una richiesta Dettagli luogo che include i campi Dati di base verrà addebitata sia nello SKU dati di base sia nello SKU Dettagli luogo.
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
,Place.Field.UTC_OFFSET
oPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinesssStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
oGMSPlaceFieldViewport
-
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
owheelchair_accessible_entrance
INTERVALLO DI VOLUME MENSILE (Prezzo per CHIAMATA) |
||
---|---|---|
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.CURRENT_OPENING_HOURS
,Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
,Place.Field.SECONDARY_OPENING_HOURS
oPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
oGMSPlaceFieldWebsite
-
Servizio web:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
owebsite
INTERVALLO DI VOLUME MENSILE (Prezzo per CHIAMATA) |
||
---|---|---|
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.RESERVABLE
,Place.Field.SERVES_BEER
,Place.Field.SERVES_BREAKFAST
,Place.Field.SERVES_BRUNCH
,Place.Field.SERVES_DINNER
,Place.Field.SERVES_LUNCH
,Place.Field.SERVES_VEGETARIAN_FOOD
,Place.Field.SERVES_WINE
,Place.Field.TAKEOUT
oPlace.Field.USER_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
oGMSPlaceFieldServesVegetarianFood
. - 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
ouser_ratings_total
.
INTERVALLO DI VOLUME MENSILE (Prezzo per CHIAMATA) |
||
---|---|---|
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:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: il servizio Place Autocomplete dell'API Maps JavaScript
- Servizio web: il servizio di completamento automatico dell'API Places
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,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,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
- findAutocompletePredictions() (.setQuery("par") e .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
Servizio web
- Place Autocomplete Request (input=”par”, session_token: XYZ)
- Place Autocomplete Request (input=”paris”, session_token: XYZ)
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,00 $ | 0,00 $ | 0,00 $ |
Esempio
Se la tua applicazione emette le seguenti tre chiamate in una singola sessione:
Android
- findAutocompletePredictions() (.setQuery("par") e .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
- fetchPlace() (con un
FetchPlaceRequest
che include l'ID del luogo e il campo INDIRIZZO)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(inclusi l'ID del luogo e il campo
GMSPlaceFieldFormattedAddress
)
Servizio web
- Richieste di completamento automatico di Places (input=”par”, session_token: XYZ)
- Richieste di completamento automatico di Places (input=”paris”, session_token: XYZ)
- Dettagli luogo (place_id, session_token: XYZ, campi:format_address)
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: dettagli del luogo
Le chiamate per i dettagli del luogo vengono addebitate come segue:
INTERVALLO DI VOLUME MENSILE (Prezzo per CHIAMATA) |
||
---|---|---|
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:
- Android: SDK Places per Android
(
fetchPlace()
) - iOS: SDK Places per iOS (
fetchPlaceFromPlaceID:
) - JavaScript:
servizio Place Details dell'API Maps JavaScript (
getDetails
) - JavaScript:
widget Place Autocomplete dell'API Maps JavaScript (
getPlace
) - JavaScript:
il widget Place SearchBox dell'API JavaScript di Maps: il metodo
getPlaces()
dopo che l'utente ha selezionato un risultato del luogo (icona: segnaposto), *non* una query (icona: lente d'ingrandimento), come illustrato qui:nei risultati del widget della casella di ricerca, dopo aver digitato "pizza" nella casella di ricerca, nota che Pizza Autentico è contrassegnata dall'icona di un segnaposto e indica che è visibile). - Servizio web: servizio Place Places API di Places
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
- Effettua una delle seguenti chiamate o richieste:
- Dispositivo mobile: chiama
fetchPlace()
su Android ofetchPlaceFromPlaceID:
su iOS e specifica solo il campoADDRESS
- API o servizio web: effettua una richiesta Place Details e specifica solo il campo dell'indirizzo:
getPlaceDetails(fields: formatted_address)
- Dettagli del luogo (prezzo a partire da 0,017 $ per sessione)
- Dati di base (fatturati a 0.00 EUR)
- Dispositivo mobile: chiama
- Effettua una delle seguenti chiamate o richieste:
- Dispositivo mobile: chiama
fetchPlace()
su Android ofetchPlaceFromPlaceID:
su iOS e specifica solo il campoPHONE_NUMBER
- API o servizio web: effettua una richiesta Place Details e specifica il campo del numero di telefono:
getPlaceDetails(fields: formatted_phone_number)
- Dettagli del luogo (prezzo a partire da 0,017 $ per sessione)
- Dati di contatto (a partire da 0,003 $ per richiesta)
- Dispositivo mobile: chiama
- Effettua una delle seguenti chiamate o richieste:
- Dispositivo mobile: chiama
fetchPlace()
su Android ofetchPlaceFromPlaceID:
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()
.
- 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)
- Dispositivo mobile: chiama
SKU: trova luogo attuale
L'opzione Trova luogo attuale viene addebitata per le chiamate a
findCurrentPlace()
(Android)
o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
INTERVALLO DI VOLUME MENSILE (Prezzo per CHIAMATA) |
||
---|---|---|
0,030 USD ogni (30,00 USD per 1000) |
0,024 $ per ogni (24,00 USD per 1000) |
Contatta il team di vendita per informazioni sui prezzi basati sul volume |
Le chiamate a findCurrentPlace()
(Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) generano anche SKU dati (di base, contatto e/o atmosfera), a seconda dei campi specificati nella chiamata.
Specifica i campi di dati per limitare la risposta solo a quei campi. Ti verranno addebitati i costi per la chiamata Trova il luogo corrente e per i dati richiesti.
Esempi
- Chiamerai
findCurrentPlace()
(Android) ofindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) e specifichi solo il campoADDRESS
. Nella fattura troverai gli 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 EUR)
- Chiama
findCurrentPlace()
(Android) ofindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) e specifica il campoPHONE_NUMBER
. Nella fattura troverai gli SKU elencati (visualizzati in base allo SKU):- Trova il luogo attuale (a partire da 0,030 $ per richiesta)
- Dati di contatto (a partire da 0,003 $ per richiesta)
- Puoi chiamare
findCurrentPlace()
(Android) ofindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) e specificare i campi di tutti e tre i bucket di tipi di dati. Nella fattura troverai gli 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 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:
- Android: chiamate a
fetchPhoto()
- iOS: chiamate a
loadPlacePhoto:
- JavaScript: per utilizzare la libreria Places, il servizio Place Photos dell'API JavaScript di Maps per richiedere i dati degli URL restituiti da
PlacePhoto.getUrl()
per caricare i dati dei pixel dell'immagine - Servizio web: richieste al servizio Foto Luogo di Places API
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,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 |
Limitazioni dei Termini e condizioni d'uso
Per informazioni sui termini e condizioni d'uso, consulta la sezione Limitazioni delle 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'SDK Places per Android:
- In Cloud Console, apri la pagina Quote di Google Maps Platform.
- Fai clic sul menu a discesa API e seleziona l'SDK Places per Android.
- Per visualizzare i limiti di quota, scorri verso il basso fino alla scheda Richieste.
Una tabella elenca i nomi e i limiti delle quote. - 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.
Risorse di gestione dei costi correlate
-
Per ricevere il credito di Maps Platform, gli utenti in India devono creare un account di fatturazione Google Cloud Platform. ↩