SDK Places per la fatturazione e l'utilizzo di Android

Promemoria: per utilizzare l'SDK Places per Android, devi includere una chiave API in tutte le richieste API e devi abilitare la fatturazione per ciascuno dei tuoi progetti.

Errore: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

Avviso: se la tua app per Android presenta errori 9005 PLACES_API_RATE_LIMIT_EXCEEDED, è possibile che tu stia utilizzando una versione deprecata dell'SDK Places for Android. La versione Google Play Services dell'SDK Places per Android (ad esempio com.google.android.gms:play-services-places) è stata ritirata il 29 gennaio 2019 ed è stata disattivata il 29 luglio 2019. È ora disponibile una nuova versione dell'SDK Places for Android. Ti consigliamo di eseguire l'aggiornamento alla nuova versione il prima possibile. Per maggiori dettagli, consulta la guida alla migrazione.

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

Modalità di fatturazione dell'SDK Places per Android

L'SDK Places per Android versione 3.3.0 supporta due versioni dell'SDK: l'SDK Places per Android esistente e l'SDK Places per Android (nuovo), la versione di nuova generazione dell'SDK. Per conoscere le principali differenze tra le due versioni dell'SDK, consulta Scegliere la versione dell'SDK.

La versione scelta dell'SDK controlla i prezzi per Place Details, Ricerca testuale e Place Photo. Per informazioni dettagliate sui prezzi, consulta la pagina Prezzi per l'SDK Places per Android (nuovo) e Prezzi per l'SDK Places per Android.

I prezzi per Place Autocomplete e Current Place sono gli stessi per entrambi gli SDK.

L'SDK Places per Android (novità) e l'SDK Places per Android utilizzano un modello di determinazione del prezzo di pagamento a consumo. Le API e gli SDK di Google Maps Platform sono fatturati per 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 utilizzo

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

Prezzi di Places SDK for Android (novità)

Informazioni sulle maschere dei campi

Utilizza le maschere di campi, chiamate anche elenchi di campi, nelle richieste per specificare l'elenco di campi da restituire nella risposta. Ti verrà quindi addebitato lo SKU più alto applicabile alla tua richiesta. Ciò significa che se selezioni i campi sia nello SKU (di base) che nello SKU (avanzato), i costi ti verranno addebitati in base allo SKU (avanzato).

L'utilizzo di una maschera 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 superflui.

SKU: dettagli luogo (solo ID)

Nota: se selezioni dei campi per lo SKU Place Details (solo località), ti verrà addebitata questa tariffa. Se selezioni dei campi dallo SKU Place Details (Basic), ti verrà addebitata questa tariffa. Se selezioni dei campi nello SKU Place Details (Advanced), ti verrà addebitata questa tariffa. Se selezioni un campo per lo SKU Place Details (Preferito), ti verrà addebitata questa tariffa.

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.ID, Place.Field.NAME, Place.Field.PHOTO_METADATAS

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,0 $ per ogni (0,00 $ per 1000)	0,0 $ per ogni (0,00 $ per 1000)	0,0 $ per ogni (0,00 $ per 1000)

---

SKU: dettagli luogo (solo località)

Nota: lo SKU: Dettagli luogo (solo località) è in anteprima. Le informazioni sui prezzi sono pubblicate solo a scopo informativo. L'utilizzo durante l'anteprima è scontato a 0 $.

Nota: se selezioni un campo dallo SKU Place Details (Basic), ti verrà addebitata questa tariffa. Se selezioni dei campi dallo SKU Place Details (Advanced), questa tariffa ti verrà addebitata. Se selezioni un campo dallo SKU Place Details (Preferred), ti verrà addebitata questa tariffa.

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.ADDRESS_COMPONENTS, Place.Field.ADDRESS, Place.Field.LAT_LNG, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,005 $ per ogni (5,00 $ per 1000)	0,004 $ per ogni (4,00 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: dettagli posizione (base)

Nota: se selezioni dei campi dallo SKU Place Details (Advanced), ti verrà addebitata questa tariffa. Se selezioni un campo dallo SKU Place Details (Preferred), ti verrà addebitata questa tariffa.

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.UTC_OFFSET, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,0170 $ per ogni (17,00 $ per 1000)	0,0136 $ per ogni (13,60 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: Dettagli luogo (avanzato)

Nota: se selezioni un campo dallo SKU Place Details (Preferred), ti verrà addebitata questa tariffa.

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,020 $ per ogni (20,00 $ per 1000)	0,016 $ per ogni (16,00 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: Dettagli luogo (opzione preferita)

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, 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

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,025 $ per ogni (25,00 $ per 1000)	0,020 $ per ogni (20,00 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: ricerca testuale (solo ID)

Nota: se selezioni dei campi dallo SKU Ricerca testuale (Base), ti verrà addebitata questa tariffa. Se selezioni un campo dallo SKU Ricerca testuale (avanzata), ti verrà addebitata questa tariffa. Se selezioni un campo dallo SKU Ricerca testuale (Preferito), ti verrà addebitata questa tariffa.

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.ID, Place.Field.NAME

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,0 $ per ogni (0,00 $ per 1000)	0,0 $ per ogni (0,00 $ per 1000)	0,0 $ per ogni (0,00 $ per 1000)

---

SKU: ricerca testuale (di base)

Nota: se selezioni dei campi dallo SKU Ricerca testuale (avanzata), ti verrà addebitata questa tariffa. Se selezioni un campo dallo SKU Ricerca testuale (Preferito), ti verrà addebitata questa tariffa.

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.LAT_LNG, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.UTC_OFFSET, Place.Field.VIEWPORT, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,032 $ per ogni (32,00 $ per 1000)	0,0256 $ per ogni (25,60 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: ricerca testuale (avanzata)

Nota: se selezioni un campo dallo SKU Ricerca testuale (Preferito), ti verrà addebitata questa tariffa.

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,035 $ per ogni (35,00 $ per 1000)	0,028 $ per ogni (28,00 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: ricerca testuale (opzione preferita)

Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, 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

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,040 $ per ogni (40,00 $ per 1000)	0,032 $ per ogni (32,00 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: foto del luogo

Per ogni richiesta all'API viene addebitato uno SKU Place Photo.

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,007 $ per ogni (7,00 $ per 1000)	0,0056 $ per ogni (5,60 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

Prezzi di Places SDK for Android

Informazioni sulle sessioni di completamento automatico

Una sessione Autocomplete include alcune richieste di completamento automatico (per recuperare suggerimenti su un luogo come tipi di utente) e al massimo una richiesta Places Details (per recuperare i dettagli sul luogo selezionato dall'utente). Lo stesso token di sessione viene passato al completamento automatico e alla successiva richiesta Place Details. 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 Places Details quando l'utente seleziona uno dei suggerimenti di completamento automatico. Se un utente non seleziona un suggerimento, non viene effettuata alcuna chiamata Places Details.

Dopo che l'utente ha selezionato un luogo (ad esempio, è stata effettuata una chiamata Places Details, devi avviare una nuova sessione utilizzando un nuovo token di sessione.

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

• Il servizio Place Autocomplete dell'API Places o il servizio Places Autocomplete dell'API Maps JavaScript. Devi progettare l'applicazione in modo da fornire token di sessione (potrebbe essere necessario modificare il codice esistente).
• Il widget di completamento automatico dell'API Maps JavaScript. La fatturazione basata sulla sessione viene attivata automaticamente sui widget, senza che sia richiesta la modifica del codice.

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 Autocomplete e le richieste Places Details utilizzando le sessioni vengono fatturate in SKU diversi.

Informazioni sugli SKU di dati di Places

I tre SKU di dati di luogo sono: Dati di base, Dati dei contatti e Dati dell'atmosfera.

Uno o più SKU di dati vengono attivati per:

• Android: ogni richiesta inviata a fetchPlace() o findCurrentPlace()
• iOS: ogni chiamata a fetchPlaceFromPlaceID: o 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, per una richiesta Place Details che include i campi di dati di base vengono addebitati sia lo SKU Basic Data sia lo SKU Place Details.

---

SKU: dati di base

Nota: questo SKU è uno SKU di dati che viene addebitato in aggiunta allo SKU di base per la richiesta che lo ha attivato.

Tramite il parametro dei campi nella richiesta Place Details o Find Place, puoi limitare la risposta solo ai campi specificati. I campi nella categoria Base sono inclusi nel costo base della richiesta Places e non comportano alcun addebito 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 o Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
• iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, 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 della richiesta di Places + 0,00 $	Costo della richiesta di Places + 0,00 $	Costo della richiesta di Places + 0,00 $

---

SKU: dati di contatto

Nota: questo SKU è uno SKU di dati che viene addebitato in aggiunta allo SKU di base per la richiesta che lo ha attivato.

Utilizzando il parametro dei 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 comportano un addebito aggiuntivo. Lo SKU Contact Data viene attivato quando viene richiesto uno di questi 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	Più di 500.000
Costo della richiesta di Places + 0,003 $ per ciascuna (+ 3,00 $ per 1000)	Costo della richiesta di Places + 0,0024 $ per ciascuna (+ 2,40 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: Dati ambiente

Nota: questo SKU è uno SKU di dati che viene addebitato in aggiunta allo SKU di base per la richiesta che lo ha attivato.

Tramite il parametro dei campi nella richiesta Place Details o Find Place, puoi limitare la risposta solo ai campi specificati. I campi della categoria Ambiente comportano un addebito aggiuntivo. Lo SKU Ambient Data viene attivato quando viene richiesto uno di questi 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 i 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 della richiesta di Places + 0,005 $ per ciascuna (+ 5,00 $ per 1000)	Costo della richiesta di Places + 0,004 $ per ciascuna (+ 4,00 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: Completamento automatico – Per richiesta

Lo SKU Autocomplete - Per Request viene addebitato per tutte le chiamate o 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 Place Autocomplete dell'API Places

Anche per le chiamate effettuate da una sessione di completamento automatico non valida (ad esempio, una sessione che riutilizza un token di sessione) viene addebitato uno SKU di completamento automatico - Per richiesta.

Alle richieste di completamento automatico dal widget Place Autocomplete dell'API Maps JavaScript potrebbe essere addebitato uno SKU di completamento automatico - Per richiesta nel caso in cui le chiamate vengano effettuate da una sessione di completamento automatico non valida. Questo può accadere quando un utente digita più indirizzi oppure copia/incolla diversi indirizzi nel widget e non sempre seleziona 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 $ per ogni (2,83 $ per 1000)	0,00227 $ per ogni (2,27 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: Autocomplete senza Place Details - Per Session

Lo SKU Autocomplete without Place Details - Per Session viene addebitato per una sessione di completamento automatico che non include una richiesta Place Details (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 $ per ogni (17,00 $ per 1000)	0,0136 $ per ogni (13,60 $ per 1000)	Contatta il team di vendita per i prezzi per volume

Esempio

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

Android

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))

iOS

• placeClient?.findAutocompletePredictions(fromQuery: "par" ...
• placeClient?.findAutocompletePredictions(fromQuery: "parigi" ...

Servizio web

• Place Autocomplete Request (input="par", session_token: XYZ)
• Place Autocomplete Request (input="paris", session_token: XYZ)

Nella fattura troverai il seguente SKU (quando vedrai la fattura per SKU):

• Autocomplete senza Place Details - Per Session (prezzo a partire da 0,017 $ a sessione)

---

SKU: Autocomplete (included with Place Details) - Per Session

Nota: questo SKU è visibile nei report di fatturazione, ma non nella pagina Fatturazione > Prezzi di Google Cloud Console.

Lo SKU Autocomplete (included with Place Details) - Per Session viene addebitato per una sessione di completamento automatico che include:

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

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

Una richiesta Place Details genera SKU di dati (Basic, Contact e/o Ambient), a seconda dei campi specificati nella richiesta.

Se non specifichi i campi nella richiesta Place Details, verranno attivati tutti gli SKU di dati (Base, Contact e Ambient).

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

INTERVALLO DI VOLUME MENSILE (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

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
• fetchPlace() (con un FetchPlaceRequest che include l'ID luogo e il campo INDIRIZZO)

iOS

• placeClient?.findAutocompletePredictions(fromQuery: "par" ...
• placeClient?.findAutocompletePredictions(fromQuery: "parigi" ...
• fetchPlaceFromPlaceID (inclusi l'ID luogo e il campo GMSPlaceFieldFormattedAddress)

Servizio web

• Richiesta di completamento automatico di Places (input="par", session_token: XYZ)
• Richiesta di completamento automatico di Places (input="paris", session_token: XYZ)
• Places Details (place_id, session_token: XYZ, Fields:formatted_address)

Nella fattura troverai i seguenti SKU (quando vedrai la fattura per SKU):

• Autocomplete (incluso con Place Details) - Per sessione (fatturato a 0.00 USD)
• Dettagli posizione (prezzo a partire da 0,017 $ per sessione)
• Dati di base (fatturati a 0.00 $)

---

SKU: Dettagli luogo

Le chiamate a Dettagli 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 $ per ogni (17,00 $ per 1000)	0,0136 $ per ogni (13,60 $ per 1000)	Contatta il team di vendita per i prezzi per volume

Lo SKU Place Details (Dettagli del luogo) viene generato da queste API:

• Android: SDK Places per Android (fetchPlace())
• iOS: SDK Places per iOS (fetchPlaceFromPlaceID:)
• JavaScript: il servizio Place Details dell'API Maps JavaScript (getDetails)
• JavaScript: widget Place Autocomplete dell'API Maps JavaScript (getPlace)
• JavaScript: il widget Place SearchBox dell'API Maps JavaScript: metodo getPlaces() dopo che l'utente ha selezionato un risultato luogo (icona: segnaposto), *non* una query (icona: lente d'ingrandimento), come illustrato qui:

  

• Servizio web: servizio Place Details dell'API Places

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

Una chiamata o una richiesta Place Details genera anche SKU di dati (Basic, Contact e/o Ambient), a seconda dei campi specificati nella chiamata o nella richiesta. Se nella chiamata o nella richiesta Place Details vengono specificati i campi NO, vengono attivati TUTTI gli SKU di dati e ti viene addebitato l'importo per la chiamata o la richiesta Places Details oltre al costo di tutti i dati.

Esempi

1. Effettua una di queste 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 verranno indicati i seguenti SKU (quando vedrai la fattura per SKU):
   • Dettagli posizione (prezzo a partire da 0,017 $ per sessione)
   • Dati di base (fatturati a 0.00 $)
2. Effettua una di queste 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 verranno indicati i seguenti SKU (quando vedrai la fattura per SKU):
   • Dettagli posizione (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:
   • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica tutti i campi
   • Servizio o API web:effettua una richiesta Place Details e specifica tutti i campi (questo tipo di richiesta è l'impostazione predefinita se non specifichi nessun campo): getPlaceDetails().
   Nella fattura verranno indicati i seguenti SKU (quando vedrai la fattura per SKU):
   • Dettagli posizione (prezzo a partire da 0,017 $ per sessione)
   • Dati di base (fatturati a 0.00 $)
   • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
   • Dati sull'ambiente (prezzo a partire da 0,005 $ per richiesta)

---

SKU: Trova luogo attuale

Find Current Place riceve un addebito per le chiamate a findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,030 $ per ogni (30,00 $ per 1000)	0,024 $ per ogni (24,00 $ per 1000)	Contatta il team di vendita per i prezzi per volume

Le chiamate a findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) generano anche SKU di dati (Base, Contact e/o Ambiente), 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 Find Current Place e per i dati richiesti.

Esempi

1. Chiami findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifichi solo il campo ADDRESS. Nella fattura verranno elencati i seguenti SKU (quando vedrai la fattura per SKU):
   • Find Current Place (prezzo a partire da 0,030 EUR per richiesta)
   • Dati di base (fatturati a 0.00 $)
2. Chiami findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifichi il campo PHONE_NUMBER. Nella fattura verranno elencati i seguenti SKU (quando vedrai la fattura per SKU):
   • Find Current Place (prezzo a partire da 0,030 EUR per richiesta)
   • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
3. Chiama findCurrentPlace() (Android) o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) e specifichi i campi di tutti e tre i bucket di tipi di dati. Nella fattura verranno elencati i seguenti SKU (quando vedrai la fattura per SKU):
   • Find Current Place (prezzo a partire da 0,030 EUR per richiesta)
   • Dati di base (fatturati a 0.00 $)
   • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
   • Dati sull'ambiente (prezzo a partire da 0,005 $ per richiesta)

---

SKU: foto del luogo

Lo SKU Place Photo viene addebitato per:

• Android: chiamate a fetchPhoto()
• iOS: chiamate a loadPlacePhoto:
• JavaScript:su Places Library, servizio Place Photo dell'API Maps JavaScript quando vengono richiesti i dati dagli URL restituiti da PlacePhoto.getUrl() per caricare i dati dei pixel dell'immagine.
• Servizio web: richieste al servizio Place Photo dell'API Places

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

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,007 $ per ogni (7,00 $ per 1000)	0,0056 $ per ogni (5,60 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

Restrizioni relative ai Termini e condizioni d'uso

Per informazioni sui termini e condizioni d'uso, consulta la sezione Limitazioni di licenza 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 del traffico di produzione, imposta limiti di quota giornalieri su tutte le richieste a qualsiasi API. Le quote giornaliere vengono reimpostate alla mezzanotte del fuso orario del Pacifico USA.

Nota: puoi impostare limiti di quota fatturabili giornalieri solo per le API fatturabili. Se il progetto non utilizza API fatturabili, non puoi impostare limiti giornalieri.

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

1. Nella console Cloud, apri la pagina Quote di Google Maps Platform.
2. Fai clic sul menu a discesa API e seleziona 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 della quota, fai clic sull'icona Modifica per il limite in questione.
   Nella finestra di dialogo visualizzata, inserisci nel campo Limite di quota il limite giornaliero fatturabile preferito (fino al limite di quota, se presente, specificato da Google) e seleziona Salva.

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

Risorse per la gestione dei costi correlate

• Fatturazione e prezzi di Google Maps Platform
• Reporting e monitoraggio di Google Maps Platform

---

1. Gli utenti in India devono creare un account di fatturazione Google Cloud prima di creare un account di fatturazione Google Maps Platform per ricevere il credito di Maps Platform. ↩