SDK Places per utilizzo e fatturazione Android

Errore: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

L'SDK Places per Android utilizza un modello di determinazione del prezzo con pagamento a consumo. Le richieste dell'SDK Places per Android per l'SDK Places per Android vengono fatturate in base allo SKU. Insieme 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 a consumo. Le API e gli SDK di Google Maps Platform sono fatturati in base allo SKU. L'utilizzo viene monitorato per ogni SKU e qualsiasi 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 l'utilizzo per stimare il costo di utilizzo per API o SDK. Per gli SKU idonei di Google Maps Platform è disponibile un credito di 200 $per Google Maps Platform 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 utente) e al massimo una richiesta Dettagli luogo (per recuperare i dettagli sul luogo selezionato dall'utente). Lo stesso token di sessione viene passato al completamento automatico e alla richiesta successiva di Dettagli luogo. Una sessione inizia con la prima richiesta di completamento automatico (che si verifica in genere quando l'utente inizia a digitare). Una chiamata Dettagli luogo viene effettuata quando l'utente ha selezionato uno dei suggerimenti di completamento automatico. Se un utente non seleziona un suggerimento, non vengono effettuate chiamate ai dettagli del 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 alcun 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 dei luoghi

I tre SKU di dati dei luoghi sono: dati di base, dati di contatto e dati sull'atmosfera.

Uno o più SKU dati vengono attivati per:

  • Android: ogni richiesta inviata a fetchPlace() o findCurrentPlace().
  • iOS:ogni chiamata al numero fetchPlaceFromPlaceID: o al numero findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Servizio web: ogni richiesta di Places in base ai 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 in base allo SKU dati di base sia in base allo SKU dettagli luogo.

SKU: dati di base

Se utilizzi 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 Places e non comportano alcun costo aggiuntivo. Lo SKU Dati di base viene attivato quando vengono richiesti i 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 o Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • 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 Oltre 500.000
Costo richiesta luoghi
+ 0,00 USD		 Costo richiesta luoghi
+ 0,00 USD		 Costo richiesta luoghi
+ 0,00 USD

SKU: dati dei contatti

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

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.SECONDARY_OPENING_HOURS 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 Oltre 500.000
Costo richiesta per i luoghi
+ 0,003 USD 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 in base al 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 vengono richiesti i seguenti campi:

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.EDITORIAL_SUMMARY, 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 o Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch o GMSPlaceFieldServesVegetarianFood.
  • JavaScript: consulta 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 Oltre 500.000
Costo richiesta per i luoghi
+ 0,005 $ ciascuno
(+ 5,00 USD per 1000)		 Costo richiesta per i luoghi
+ 0,004 USD ciascuno
(+ 4,00 USD per 1000)		 Contatta il team di vendita per informazioni sui prezzi in base al 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:

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

Alle richieste di completamento automatico dal widget di completamento automatico del luogo dell'API Maps JavaScript potrebbe essere addebitato uno SKU di completamento automatico – Per richiesta nel caso in cui le chiamate siano effettuate da una sessione di completamento automatico non valida. Questo può succedere quando un utente digita più indirizzi diversi o copia/incolla diversi indirizzi 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 Oltre 500.000
0,00283 $ 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 in base al volume

SKU: completamento automatico senza dettagli del luogo - Per sessione

Lo SKU Completamento automatico senza dettagli del luogo - Per sessione ti 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 Oltre 500.000
0,017 USD per
(17,00 USD per 1000)		 0,0136 $ per ogni
(13,60 USD per 1000)		 Contatta il team di vendita per informazioni sui prezzi in base al volume

Esempio

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

Android

iOS

Servizio web

Nella fattura troverai questo SKU (quando visualizzi la fattura per SKU):

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

SKU: completamento automatico (incluso con 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 eventi:

  • 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 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 atmosfera).

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

INTERVALLO DI VOLUME mensile
(Prezzo per SESSIONE)
0-100.000 100.001-500.000 Oltre 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 i seguenti SKU (visualizzati per fattura):

  • Completamento automatico (incluso con i dettagli del luogo) - Per sessione (fatturato a 0,00 $)
  • 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 Dettagli luogo vengono addebitate come segue:

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

Lo SKU Dettagli luogo viene generato da queste API:

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

Una chiamata o una richiesta Dettagli luogo genera anche SKU dati (di base, Contatto e/o Atmosfera), a seconda dei campi specificati nella chiamata o nella richiesta. Se nella chiamata o nella richiesta Dettagli luogo vengono specificati NO campi, vengono attivati TUTTI gli SKU di 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 di queste chiamate o richieste:
    • Dispositivo mobile: chiama il numero 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 i seguenti SKU (quando visualizzi 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 di queste chiamate o richieste:
    • Dispositivo mobile: chiama il numero 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 del numero di telefono: getPlaceDetails(fields: formatted_phone_number)
    Nella fattura troverai i seguenti SKU (quando visualizzi la fattura per SKU):
    • Dettagli del luogo (prezzo a partire da 0,017 $ per sessione)
    • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
  3. Effettua una di queste chiamate o richieste:
    • Cellulare: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica tutti i campi
    • API o servizio web: effettua una richiesta Place Details e specifica tutti i campi (questo tipo di richiesta è l'impostazione predefinita se non specifichi alcun campo): getPlaceDetails().
    Nella fattura troverai i seguenti SKU (quando visualizzi 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 (prezzo a partire da 0,003 $ per richiesta)
    • Dati relativi all'atmosfera (prezzo a partire da 0,005 $ per richiesta)

SKU: Trova il luogo attuale

Per le chiamate a Luogo attuale, vengono addebitate le chiamate a findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,030 $ per
(30,00 USD per 1000)		 0,024 $ per ogni
(24,00 USD per 1000)		 Contatta il team di vendita per informazioni sui prezzi in base al 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 tali campi. Ti vengono addebitati i costi per la chiamata Trova il luogo attuale e per i dati richiesti.

Esempi

  1. Chiama il numero findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifica solo il campo ADDRESS. Nella fattura saranno riportati i seguenti SKU (quando visualizzi la fattura per SKU):
    • Trova luogo attuale (prezzo a partire da 0,030 $ per richiesta)
    • Dati di base (fatturati a 0.00 EUR)
  2. Richiama findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifica il campo PHONE_NUMBER. Nella fattura saranno riportati questi SKU (quando visualizzi la fattura per SKU):
    • Trova luogo attuale (prezzo a partire da 0,030 $ per richiesta)
    • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
  3. Richiama findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifica i campi di tutti e tre i bucket di tipo dati. Nella fattura saranno riportati i seguenti SKU (quando visualizzi la fattura per SKU):
    • Trova luogo attuale (prezzo a partire da 0,030 $ per richiesta)
    • Dati di base (fatturati a 0.00 EUR)
    • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
    • Dati relativi all'atmosfera (prezzo a partire da 0,005 $ per richiesta)

SKU: luogo foto

Lo SKU di Foto del luogo viene addebitato per:

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

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,007 $ per ogni
(7,00 USD per 1000)		 0,0056 $ per ogni
(5,60 USD per 1000)		 Contatta il team di vendita per informazioni sui prezzi in base al volume

Limitazioni dei Termini e condizioni d'uso

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

Gestisci il costo di utilizzo

Per gestire i costi di utilizzo dell'SDK Places per Android o per soddisfare le esigenze di traffico di produzione, imposta limiti di quota giornalieri per tutte le richieste a qualsiasi API. Le quote giornaliere vengono reimpostate a 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 API e seleziona l'SDK Places per Android.
  3. Per visualizzare i limiti di quota, scorri verso il basso fino alla scheda Richieste.
    Nella tabella sono elencati i nomi e i limiti delle quote.
  4. Per modificare un limite di quota, fai clic sull'icona Modifica relativa a quel limite.
    Nella finestra di dialogo visualizzata, inserisci nel campo Limite quota il limite di quota giornaliero fatturabile preferito (fino al limite di quota, se specificato, da Google) e seleziona Salva.

Se l'utilizzo dell'API raggiunge il limite di quota fatturabile per un dato giorno, l'applicazione non sarà in grado di accedere all'API per il resto del giorno.

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