Utilizzo e fatturazione dell'API Places

Promemoria: per utilizzare l'API Places, devi abilitare la fatturazione in ogni progetto e includere una chiave API o un token OAuth con tutte le richieste di API o SDK.

L'API Places (nuova) e l'API Places utilizzano un modello di prezzi di pagamento a consumo. Le richieste dell'API Places (nuova) e dell'API Places generano chiamate a uno o più SKU. Oltre ai Termini e condizioni d'uso generali di Google, esistono limiti di utilizzo specifici per l'API Places. Gestisci i costi e l'utilizzo con gli strumenti disponibili nella console Google Cloud.

Modalità di fatturazione dell'API Places

L'API Places (nuova) e l'API Places utilizzano un modello di prezzo di pagamento a consumo. Le API e gli SDK di Google Maps Platform vengono fatturati in base allo SKU. L'utilizzo viene monitorato per ogni SKU e qualsiasi API o SDK può avere più di un SKU 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 Google Maps Platform idonei, è disponibile un credito di 200 $ per Google Maps Platform ogni mese per ogni account di fatturazione. Questo credito viene applicato automaticamente agli SKU idonei.

Prezzi dell'API Places (novità)

Informazioni sulle maschere dei campi

Per i dettagli dei luoghi (novità), la ricerca nelle vicinanze (novità) e la ricerca di testo (novità), utilizza l'intestazione FieldMask nelle richieste dell'API per specificare l'elenco dei campi da restituire nella risposta. Successivamente, ti verrà addebitato lo SKU più alto applicabile alla tua richiesta. Ciò significa che se selezioni campi sia nello SKU (Base) sia nello SKU (Advanced), la fatturazione avviene in base allo SKU (Advanced).

L'utilizzo della mascheratura dei campi è una buona prassi di progettazione per assicurarti di non richiedere dati non necessari, il che consente di evitare tempi di elaborazione e costi di fatturazione non necessari.

Informazioni sulle sessioni Autocomplete (Nuova)

Una sessione Autocomplete (Nuova) include una o più richieste Autocomplete (Nuova) e una richiesta Place Details (Nuova) o Convalida indirizzo. Lo stesso token di sessione viene passato alla richiesta di completamento automatico (nuova) e alla successiva richiesta Place Details (Nuova) o alla richiesta di Address Validation.

Una sessione inizia con la prima richiesta di completamento automatico (nuova). Quando l'utente seleziona uno dei suggerimenti di Autocomplete (Nuovo), viene inviata una richiesta di dettagli sul luogo (Nuovo) o di convalida dell'indirizzo. Se una sessione viene abbandonata, ovvero non viene effettuata alcuna richiesta di dettagli sui luoghi (nuova) o di convalida dell'indirizzo, le richieste di completamento automatico (nuova) vengono addebitate come se non fosse stato fornito alcun token di sessione.

Dopo che l'utente ha selezionato un luogo (ovvero viene effettuata una richiesta Place Details (Nuova) o Address Validation, devi avviare una nuova sessione utilizzando un nuovo token di sessione.

Nota: i token di sessione possono sovrapporsi nei progetti, ma devono essere univoci per progetto. Ad esempio, un'app che utilizza il progetto A e un'app che utilizza il progetto B possono utilizzare lo stesso token della sessione, mentre più app che utilizzano il progetto A non possono utilizzare lo stesso token della sessione.

Un token di sessione è valido per una sessione e non può essere utilizzato per più di una sessione. Se riutilizzi un token della sessione, la sessione viene considerata non valida e le richieste vengono addebitate come se non fosse stato fornito alcun token della sessione.

SKU: richieste di completamento automatico

Per ogni richiesta all'API Autocomplete (nuova) che non include un token di sessione viene addebitato uno SKU Autocomplete Requests.

L'addebito viene effettuato anche se utilizzi token di sessione e:

• Termina le sessioni con una singola richiesta a Place Details (Nuovo) che richiede tutti i campi definiti dallo SKU: Place Details (Only Location).
  • Ogni richiesta Autocomplete (Nuova), fino a 12 richieste, viene fatturata utilizzando lo SKU: Autocomplete Requests.
  • Ogni richiesta Autocomplete (Nuova) successiva viene fatturata utilizzando lo SKU: Utilizzo sessione completamento automatico.
  Nota: se effettui una chiamata a SKU: Address Validation Preferred prima della scadenza del token di sessione, la chiamata SKU: Place Details (Location Only) non viene addebitata e la sessione viene fatturata in base allo SKU: Autocomplete Session Usage.
• Abbandona o termina la sessione effettuando una chiamata allo SKU: Place Details (Only IDs). Tutte le richieste Autocomplete (New) vengono poi fatturate utilizzando lo SKU: Autocomplete Requests.

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,00283 $ per ciascuna (2,83 $ per 1000)	0,00227 $ per ogni (2,27 $ per 1000)	Contatta il team di vendita per i prezzi in base al volume

---

SKU: utilizzo della sessione Autocomplete

Per ogni richiesta all'API Autocomplete (nuova) che include un token di sessione viene addebitato uno SKU Utilizzo sessione Autocomplete.

Questo SKU viene addebitato nei seguenti scenari:

• Sessione Autocomplete interrotta da una chiamata a SKU: Place Details (Location Only):

  • Ogni richiesta di completamento automatico (nuova), fino a 12 richieste, viene fatturata utilizzando SKU: richieste di completamento automatico.
  • Ogni richiesta Autocomplete (Nuova) successiva viene fatturata utilizzando lo SKU: Utilizzo sessione completamento automatico.

• Sessione di completamento automatico terminata con una chiamata a SKU: Place Details (Basic, Advanced o Preferred).

  Una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred) viene fatturata in base a SKU: Place Details (Preferred).

• Sessione di completamento automatico terminata con una chiamata a SKU: Address Validation Preferred.

  Nota: se effettui una chiamata allo SKU Place Details (Location Only) e poi una chiamata allo SKU Address Validation Preferred prima della scadenza del token della sessione, la chiamata allo SKU Place Details (Location Only) non viene addebitata e la sessione viene fatturata solo per la chiamata allo SKU Address Validation Preferred.

Per ulteriori informazioni, consulta Completamento automatico (nuovo) e prezzi delle sessioni.

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

---

SKU: dettagli del luogo (solo ID)

Nota: se selezioni uno o più campi dall'SKU Dettagli dei luoghi (solo posizione), la fatturazione avviene a quella tariffa. Se selezioni uno o più campi dall'SKU Dettagli dei luoghi (di base), la fatturazione avviene a quella tariffa. Se selezioni uno dei campi dello SKU Place Details (Advanced), ti verrà addebitata quella tariffa. Se selezioni uno o più campi dall'SKU Dettagli dei luoghi (opzione preferita), la fatturazione avviene a quella tariffa.

Utilizzando una maschera di campi o un elenco di campi nella richiesta di dettagli dei luoghi (nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando soltanto richiedi i seguenti campi:

Servizio web: attributions, id, name^*, photos

^* Il campo name contiene il nome della risorsa del luogo nel formato: places/PLACE_ID. Usa displayName per accedere al nome del luogo in formato testo.

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

---

SKU: Dettagli del luogo (solo posizione)

Nota: se selezioni uno o più campi dall'SKU Dettagli dei luoghi (di base), ti verrà addebitato il costo corrispondente. Se selezioni uno o più campi dello SKU Dettagli dei luoghi (avanzato), ti verrà addebitato il costo corrispondente. Se selezioni uno o più campi dall'SKU Dettagli dei luoghi (opzione preferita), ti verrà addebitato il costo corrispondente.

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

Servizio web: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

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

---

SKU: Dettagli dei luoghi (di base)

Nota: se selezioni uno o più campi dello SKU Dettagli dei luoghi (avanzato), la fatturazione avviene in base a questa tariffa. Se selezioni uno o più campi dall'SKU Dettagli dei luoghi (opzione preferita), ti verrà addebitato il costo corrispondente.

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

Servizio web: accessibilityOptions, businessStatus, containingPlaces, displayName, googleMapsLinks^*, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, pureServiceAreaBusiness, subDestinations, utcOffsetMinutes

^* Il campo googleMapsLinks è nella fase di anteprima pre-GA e non è previsto alcun addebito, il che significa che la fatturazione è pari a 0 $ per l'utilizzo durante l'anteprima.

Se una sessione di completamento automatico viene terminata da una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred), la chiamata viene fatturata con SKU: Place Details (Preferred). Per maggiori informazioni, consulta SKU: utilizzo della sessione con completamento automatico.

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 uno o più campi dallo SKU Dettagli dei luoghi (opzione preferita), la fatturazione avviene a quella tariffa.

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

Servizio web: currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, priceRange, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

Se una sessione di completamento automatico viene terminata da una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred), la chiamata viene fatturata con SKU: Place Details (Preferred). Per maggiori informazioni, consulta SKU: utilizzo della sessione con completamento automatico.

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: Place Details (Preferred)

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

allowsDogscurbsidePickupdeliverydineIneditorialSummaryevChargeOptionsfuelOptionsgoodForChildrengoodForGroupsgoodForWatchingSportsliveMusicmenuForChildrenparkingOptionspaymentOptionsoutdoorSeatingreservablerestroomreviewsroutingSummaries^*servesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

Se una sessione di completamento automatico viene terminata da una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred), la chiamata viene fatturata con SKU: Place Details (Preferred). Per ulteriori informazioni, vedi SKU: utilizzo della sessione di completamento automatico.

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 nelle vicinanze (di base)

Nota: se selezioni uno o più campi dallo SKU Ricerca nelle vicinanze (avanzata), la fatturazione avviene in base a questa tariffa. Se selezioni uno o più campi dall'SKU Ricerca nelle vicinanze (preferito), ti verrà addebitato il costo corrispondente a questa tariffa.

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

Servizio web: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.attributions, places.businessStatus, places.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks^*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name^**, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

^* Il campo places.googleMapsLinks è nella fase di anteprima pre-GA e non è previsto alcun addebito, il che significa che la fatturazione è pari a 0 $ per l'utilizzo durante l'anteprima.

^** Il campo places.name contiene il nome della risorsa del luogo nel formato: places/PLACE_ID. Usa places.displayName per accedere al nome del luogo in formato testo.

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

---

SKU: Ricerca nelle vicinanze (avanzata)

Nota: se selezioni uno o più campi dall'SKU Ricerca nelle vicinanze (opzione preferita), la fatturazione avviene a quella tariffa.

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

Servizio web: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.priceRange, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

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 unità (28,00 $ per 1000)	Contatta il team di vendita per i prezzi in base al volume

---

SKU: Ricerca nelle vicinanze (opzione preferita)

Utilizzando una maschera di campo o un elenco di campi nella richiesta di Nearby Search (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Servizio web: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.routingSummaries,^* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

^* solo per Ricerca di testi e Ricerca nelle vicinanze

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

---

SKU: ricerca di testo (solo ID)

Nota: se selezioni uno o più campi dallo SKU Ricerca di testo (di base), la fatturazione avviene in base a questa tariffa. Se selezioni uno o più campi dallo SKU Ricerca di testo (avanzata), la fatturazione avviene a quella tariffa. Se selezioni uno o più campi dall'SKU Ricerca di testo (opzione preferita), ti verrà addebitato il costo corrispondente a questa tariffa.

Utilizzando una maschera di campo o un elenco di campi nella richiesta Ricerca testuale (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Servizio web: places.attributions, places.id, places.name^*, nextPageToken

^* Il campo places.name contiene il nome della risorsa del luogo nel formato: places/PLACE_ID. Usa places.displayName per accedere al nome del luogo in formato testo.

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

---

SKU: Ricerca testuale (di base)

Nota: se selezioni uno o più campi dallo SKU Ricerca di testo (avanzata), la tariffa applicata sarà quella indicata. Se selezioni uno o più campi dall'SKU Ricerca di testo (opzione preferita), ti verrà addebitato il costo corrispondente a questa tariffa.

Utilizzando una maschera di campo o un elenco di campi nella richiesta Ricerca testuale (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Servizio web: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks^*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

^* Il campo places.googleMapsLinks è nella fase di anteprima pre-GA e non è previsto alcun addebito, il che significa che la fatturazione è pari a 0 $ per l'utilizzo durante l'anteprima.

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,032 $ per unità (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 uno o più campi dallo SKU Ricerca di testo (opzione preferita), la fatturazione avviene a quella tariffa.

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

Servizio web: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.priceRange, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

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 campo o un elenco di campi nella richiesta di ricerca di testo (nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Servizio web: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.routingSummaries,^* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

^* solo per Ricerca di testi e Ricerca nelle vicinanze

INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA)
0-100.000	100.001-500.000	Più di 500.000
0,040 $ per unità (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 inviata all'API, viene addebitato uno SKU per la foto del luogo.

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 dell'API Places

I seguenti prezzi provengono dalla pagina dei prezzi di Google Maps Platform. Per l'India, consulta la pagina dei prezzi per l'India.

Informazioni sulle sessioni di completamento automatico

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

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

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

• Il servizio Place Autocomplete dell'API Places o il servizio Place Autocomplete dell'API Maps JavaScript. Devi progettare la tua applicazione in modo che fornisca 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 alcuna modifica al codice.

Un token 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 di Places Details che utilizzano le sessioni vengono fatturate su SKU diversi.

Informazioni sugli SKU dei dati di Places

I tre SKU di dati di Places sono: Dati di base, Dati di contatto e Dati atmosfera.

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 in base ai campi specificati nella richiesta

Gli SKU dei dati vengono sempre addebitati oltre allo SKU di base per la richiesta che li attiva. Ad esempio, una richiesta Places Details che include i campi Dati di base verrà addebitata sia con lo SKU Dati di base che con lo SKU Places Details.

Per il servizio web, le seguenti chiamate API Places supportano la specifica dei campi di dati da restituire:

• Places Details
• Trova un luogo

Per il servizio web, queste chiamate alle API di Places NON supportano la specifica dei campi restituiti. Queste chiamate restituiscono sempre tutti i dati di Places, addebitando i tre SKU di dati di Places in oltre al costo per ogni richiesta API:

• Locali – Ricerca nelle vicinanze
• Località - Ricerca di testo

---

SKU: dati di base

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

Utilizzando il parametro campi nella richiesta Place Details o Trova luogo, puoi limitare la risposta ai soli campi specificati. I campi della categoria Base sono inclusi nel costo base della richiesta di Places e non comportano alcun addebito aggiuntivo. Lo SKU Dati di base viene attivato quando viene richiesto uno di questi campi:

• Android: Place.Field.ACCESSIBILITY_OPTIONS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.ID, Place.Field.LOCATION, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT o Place.Field.UTC_OFFSET.
Nota: i campi Place.Field.ADDRESS, Place.Field.ICON_URL, Place.Field.LAT_LNG, Place.Field.NAME e Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE sono stati deprecati nella versione 4.0 di Places SDK per Android. Utilizza Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_MASK_URL, Place.Field.LOCATION, Place.Field.DISPLAY_NAME e Place.ACCESSIBILITY_OPTIONS, rispettivamente. Place.Field.ACCESSIBILITY_OPTIONS è disponibile solo per Place Details (Nuovo).
• 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: Contact Data

Nota: questo SKU è uno SKU di dati, addebitato oltre allo SKU di base per la richiesta che lo ha attivato.

Tramite il parametro campi nella richiesta Place Details o Find Place per i servizi web oppure in un array di Place.Field per Android o iOS, puoi limitare la risposta solo ai campi specificati. I campi della categoria Contatto comportano un addebito aggiuntivo. Lo SKU Dati di contatto viene attivato quando viene richiesto uno di questi campi:

• Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS o Place.Field.WEBSITE_URI
Nota: il campo Place.Field.PHONE_NUMBER è stato ritirato nella versione 4.0 dell'SDK Places per Android. Utilizza invece Place.Field.INTERNATIONAL_PHONE_NUMBER.
• 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 delle richieste di Places + 0,003 $ per ogni richiesta (+ 3,00 $ per 1000)	Costo delle richieste di Places + 0,0024 $ per ciascuna (+ 2,40 $ per 1000)	Contatta il team di vendita per i prezzi per volume

---

SKU: dati sull'ambiente

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

Utilizzando il parametro fields nella richiesta Places Details o Find Place, puoi limitare la risposta solo ai campi specificati. I campi della categoria Atmosphere comportano un addebito aggiuntivo. Lo SKU Dati atmosfera viene attivato quando viene richiesto uno dei 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_RATING_COUNT
  
  Nota: il campo Place.Field.USER_RATINGS_TOTAL è stato ritirato nella versione 4.0 di Places SDK per Android. Utilizza invece Place.Field.USER_RATING_COUNT.
• iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch o GMSPlaceFieldServesVegetarianFood.
• JavaScript: consulta Campi (dettagli dei luoghi)
• 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 delle richieste 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: Autocomplete – Per Request

Lo SKU Autocomplete - Per richiesta viene addebitato per qualsiasi chiamata o richiesta che non include un token di sessione:

• Android: findAutocompletePredictions()
• iOS: findAutocompletePredictionsFromQuery:
• JavaScript: servizio Place Autocomplete dell'API Maps JavaScript
• Servizio web: il servizio Place Autocomplete dell'API Places

Per le chiamate effettuate da una sessione Autocomplete non valida (ad esempio una sessione che riutilizza un token di sessione) viene addebitato anche uno SKU Autocomplete - Per richiesta.

Per le richieste di completamento automatico provenienti dal widget Place Autocomplete dell'API Maps JavaScript potrebbe essere addebitato uno SKU Autocomplete - 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 diversi o copia/incolla indirizzi diversi nel widget e non seleziona sempre una previsione di completamento automatico.

FASCIA DI VOLUME MENSILE (prezzo per RICHIESTA)
0-100.000	100.001-500.000	Più di 500.000
0,00283 $ per ciascuna (2,83 $ per 1000)	0,00227 $ per ciascuna (2,27 $ per 1000)	Contatta il team di vendita per i prezzi in base al volume

---

SKU: Autocomplete without Place Details – Per Session

Lo SKU Autocomplete senza Places Details - Per sessione viene addebitato per una sessione Autocomplete che non include una richiesta Places 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 un'unica sessione:

Android

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

iOS

• placesClient?.findAutocompletePredictions(fromQuery: "par" ...
• placesClient?.findAutocompletePredictions(fromQuery: "paris" ...

Servizio web

• Richiesta di completamento automatico dei luoghi (input=”par”, session_token: XYZ)
• Richiesta di completamento automatico dei luoghi (input = "paris", session_token: XYZ)

Sulla fattura, vedrai questo SKU nell'elenco (quando visualizzi la fattura per SKU):

• Completamento automatico senza Place Details - Per sessione (prezzo a partire da 0,017 $ per sessione)

---

SKU: Autocomplete (incluso con Place Details) - Per sessione

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

Lo SKU Autocomplete (incluso con Places Details) - Per sessione viene addebitato per una sessione Autocomplete che include uno dei seguenti elementi:

• Android: una chiamata a fetchPlace()
• iOS: una chiamata a fetchPlaceFromPlaceID:
• Servizio web: una richiesta di dettagli sui luoghi

La richiesta di completamento automatico è disponibile senza costi e la successiva chiamata a Places Details viene addebitata in base ai normali prezzi di Places Details.

Una richiesta Places Details genera SKU dei dati (Base, Contatto e/o Atmosfera) a seconda dei campi specificati nella richiesta.

Se non specifichi i campi nella richiesta Places Details, vengono attivati tutti gli SKU dei dati (di base, di contatto e sull'ambiente).

Le richieste di aggiornamento dell'ID luogo (richieste che specificano solo il campo place_id) durante una sessione di completamento automatico vengono fatturate come SKU: Autocomplete senza dettagli sul 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 tre chiamate seguenti in una singola sessione:

Android

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
• fetchPlace() (con un FetchPlaceRequest incluso l'ID posizione e il campo ADDRESS)

iOS

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

Servizio web

• Richiesta di completamento automatico di luoghi (input="par", session_token: XYZ)
• Richiesta di completamento automatico di Places (input=”paris”, session_token: XYZ)
• Dettagli dei luoghi (place_id, session_token: XYZ, fields:formatted_address)

Nella fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):

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

---

SKU: Query Autocomplete - Per richiesta

Viene addebitato uno SKU Query Autocomplete - Per Request per ogni richiesta a:

• JavaScript: il servizio Places Autocomplete dell'API Maps JavaScript (getQueryPredictions()) e l'utilizzo del widget SearchBox dell'API Maps JavaScript (le richieste Query Autocomplete vengono generate man mano che l'utente digita).
• Servizio web: il servizio di completamento automatico delle query dell'API Places

FASCIA DI VOLUME MENSILE (prezzo per RICHIESTA)
0-100.000	100.001-500.000	Più di 500.000
0,00283 $ per ciascuna (2,83 $ per 1000)	0,00227 $ per ogni (2,27 $ per 1000)	Contatta il team di vendita per i prezzi per volume

I prezzi per sessione Autocomplete non sono supportati con il completamento automatico delle query. Le chiamate subsequenti a Places Details vengono addebitate in base ai normali prezzi di Places Details.

---

SKU: Place Details

Le chiamate Place Details 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 viene generato da queste API:

• Android: Places SDK for Android (fetchPlace())
• iOS: Places SDK for iOS (fetchPlaceFromPlaceID:)
• JavaScript: Servizio Dettagli dei luoghi dell'API Maps JavaScript (getDetails)
• JavaScript: widget di completamento automatico dei luoghi dell'API Maps JavaScript (getPlace)
• JavaScript: metodo getPlaces() del widget SearchBox dei luoghi dell'API Maps JavaScript dopo che l'utente ha selezionato un risultato di ricerca (icona: segnaposto), *non* una query (icona: lente d'ingrandimento), come illustrato di seguito:

  

  Nei risultati del widget della casella di ricerca, dopo aver digitato "pizza" nella casella di ricerca, noterai che accanto a Pizza Autentico è presente un'icona a forma di segnaposto, che indica che si tratta di un risultato di ricerca (e non di una query).

• Servizio web: Servizio Dettagli dei luoghi dell'API Places

Con l'API e i servizi web, 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 Atmosphere), a seconda dei campi specificati nella chiamata o nella richiesta. Se i campi NO vengono specificati nella chiamata o nella richiesta Place Details, vengono attivati TUTTI gli SKU di dati e ti vengono addebitati i costi relativi alla chiamata o alla richiesta Places Details, più il 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 vedrai questi SKU (se visualizzi la fattura per SKU):
   • Place Details (prezzo a partire da 0.017 USD per sessione)
   • Basic Data (fatturato a 0.00 EUR)
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 di dettagli sul luogo e specifica il campo del numero di telefono: getPlaceDetails(fields: formatted_phone_number)
   Nella fattura vedrai questi SKU (se visualizzi la fattura per SKU):
   • Dettagli dei luoghi (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
   • API o servizio web:effettua una richiesta Place Details e specifica tutti i campi (questo tipo di richiesta è il valore predefinito se non specifichi nessun campo): getPlaceDetails().
   Nella fattura, vedrai i seguenti SKU (durante la visualizzazione della fattura per SKU):
   • Dettagli dei luoghi (prezzo a partire da 0,017 $ per sessione)
   • Dati di base (fatturati a 0,00 $)
   • Contact Data (prezzo a partire da 0.003 EUR a richiesta)
   • Atmosphere Data (prezzo a partire da 0.005 $ a richiesta)

---

SKU: Place Details – ID Refresh

Utilizza la richiesta Places Details per aggiornare gli ID luogo non aggiornati. Questi tipi di richieste sono disponibili senza costi.

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

Effettua una richiesta Place Details specificando solo il campo ID luogo: getPlaceDetails(fields: place_id). Nella fattura vedrai questo SKU elencato (quando visualizzi la fattura per SKU):

• Dettagli dei luoghi - Aggiornamento ID (fatturato a 0,00 $)

---

SKU: Trova luogo

Find Place viene addebitato per una richiesta di Find Place.

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

Le richieste Trova luogo generano anche SKU di dati (Base, Contatto e/o Atmosfera), a seconda dei campi specificati nella richiesta. Come per le richieste Place Details, puoi utilizzare il parametro campi nella richiesta Trova luogo per limitare la risposta ai soli campi specificati. Ti viene addebitato il costo della richiesta Find Place e dei dati richiesti. Per impostazione predefinita, se vengono richiesti campi NO, viene restituito solo l'ID luogo, quindi non vengono addebitati costi aggiuntivi per i dati.

Esempi

1. Invii una richiesta Find Place e specifichi solo il campo indirizzo: FindPlace(fields: formatted_address). Nella fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
   • Trova luogo (prezzo a partire da 0,017 $ per chiamata)
   • Basic Data (fatturato a 0.00 EUR)
2. Invii una richiesta Find Place e specifichi il campo del numero di telefono: FindPlace(fields: formatted_phone_number). Nella fattura, vedrai questi SKU elencati (quando visualizzi la fattura in base allo SKU):
   • Trova luogo (prezzo a partire da 0.017 EUR a chiamata)
   • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
3. Invii una richiesta Find Place e specifichi i campi di tutti e tre i bucket di tipo di dati: FindPlace(fields: formatted_address, opening_hours, price_level). Nella fattura, vedrai elencati i seguenti SKU (quando visualizzi la fattura in base allo SKU):
   • Trova luogo (prezzo a partire da 0,017 $ per chiamata)
   • Dati di base (fatturati a 0,00 $)
   • Contact Data (prezzo a partire da 0.003 EUR a richiesta)
   • Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

---

SKU: Find Place – ID only

L'opzione Trova luogo - Solo ID viene addebitata per le richieste Trova luogo che specificano solo l'ID luogo da restituire. Per impostazione predefinita, se nella richiesta Find Place non vengono 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

Effettua una richiesta Trova luogo e specifichi solo il campo place_id: FindPlace(fields: place_id). Nella fattura vedrai questo SKU elencato (quando visualizzi la fattura per SKU):

• Trova un luogo - Solo ID (fatturato a 0,00 $)

---

SKU: luogo – ricerca nelle vicinanze

L'attributo Place – Nearby Search viene addebitato per le richieste al servizio Place Nearby Search dell'API Maps JavaScript (nearbySearch()) o al servizio Nearby Search dell'API Places

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

Le richieste di Ricerca nelle vicinanze restituiscono un elenco di luoghi, ma non supportano la specifica dei campi da restituire. Le richieste di Ricerca nelle vicinanze restituiscono un sottoinsieme degli campi di dati supportati. Ti vengono addebitati i costi per la richiesta di Nearby Search a partire da 0, 032 $ per ciascuna, così come per tutti gli SKU di tipo di dati (Dati di base, Dati di contatto e Dati dell'atmosfera).

Esempio

Invii una richiesta di ricerca nelle vicinanze, ad esempio NearbySearch (San Francisco, 100 meters). Nella fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):

• Luogo - Ricerca nelle vicinanze (prezzo a partire da 0,032 $ per chiamata)
• Dati di base (fatturati a 0,00 $)
• Contact Data (prezzo a partire da 0.003 EUR a richiesta)
• Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

---

SKU: Place – Text Search

L'attributo Place – Text Search viene addebitato per le richieste al servizio Place Text Search dell'API Maps JavaScript (textSearch()) o al servizio Text Search dell'API Places.

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

Le richieste di ricerca di testo restituiscono un elenco di luoghi, ma non supportano la specifica dei campi da restituire. Le richieste di ricerca di testo restituiscono un sottoinsieme dei campi di dati supportati. Ti vengono addebitati i costi per le richieste di ricerca testuale a partire da 0, 032 $ per ciascuna, così come per tutti gli SKU di tipi di dati (Dati di base, Dati di contatto e Dati atmosfera).

Lo SKU Luogo – Ricerca di testo viene generato anche dal metodo getPlaces() del widget SearchBox dei luoghi dell'API Maps JavaScript quando l'utente seleziona una query sui luoghi (icona: lente d'ingrandimento), non un risultato (icona: segnaposto), come illustrato di seguito:

Nei risultati del widget della casella di ricerca, dopo aver digitato "pizza" nella casella di ricerca, noterai che accanto a consegna pizza è presente un'icona a forma di lente d'ingrandimento, che indica che si tratta di una query sui luoghi (e non di un risultato).

Esempio

Invii una richiesta di ricerca di testo, ad esempio TextSearch(123 Main Street). Sulla fattura, vedrai i seguenti SKU (quando visualizzi la fattura per SKU):

• Luogo - Ricerca di testo (prezzo a partire da 0,032 $ per chiamata)
• Basic Data (fatturato a 0.00 EUR)
• Contact Data (prezzo a partire da 0.003 EUR a richiesta)
• Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

---

SKU: Place Photo

Viene addebitato uno SKU Foto del luogo per:

• Android: chiamate a fetchPhoto()
• iOS: chiamate a loadPlacePhoto:
• JavaScript: a Places Library, servizio Place Photos dell'API Maps JavaScript quando richiedi dati dagli URL restituiti da PlacePhoto.getUrl() per caricare i dati dei pixel delle immagini
• 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 relativi ai 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 in base al volume

---

Altri limiti di utilizzo

Sebbene non sia previsto un numero massimo di richieste al giorno, valgono comunque i seguenti limiti di utilizzo:

• API Places (nuova): il limite di frequenza è di 600 QPM (richieste al minuto) per metodo API per progetto. Ciò significa che ogni metodo API ha una quota separata.

• API Places: il limite di frequenza è 6000 QPM (richieste al minuto). Viene calcolato come somma delle 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 di utilizzo, consulta le norme relative all'API Places e la sezione Limitazioni delle licenze dei Termini di servizio di Google Maps Platform.

Gestire il costo di utilizzo

Per gestire il costo di utilizzo dell'API Places o per soddisfare le esigenze del tuo 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.

Nota: puoi impostare limiti giornalieri per le quote fatturabili 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 l'API Places:

1. In Cloud Console, apri la pagina Quote di Google Maps Platform.
2. Fai clic sul menu 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 quel limite.
   Nella finestra di dialogo visualizzata, inserisci nel campo Limite quota il limite di quota giornaliera fatturabile preferito (fino all'eventuale limite della quota 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 di gestione dei costi correlate

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

---