Questa pagina è stata tradotta dall'API Cloud Translation.

SDK Places per l'utilizzo e la fatturazione di iOS

Le richieste dell'SDK Places per iOS per l'API Places vengono fatturate in base allo SKU. Fai clic sull'icona Informazioni Informazioni per visualizzare l'indice dei contenuti di questa pagina.

Fatturazione e prezzi per l'SDK Places per iOS

Per informazioni su come Google calcola la fatturazione e i prezzi, consulta l'elenco dei prezzi di Google Maps Platform o l'elenco dei prezzi di Google Maps Platform - India.

Dettagli SKU di Places SDK for iOS (nuovo)

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 Autocomplete (Nuova) e alla successiva richiesta Place Details (Nuova) o alla richiesta di convalida dell'indirizzo.

Una sessione inizia con la prima richiesta Autocomplete (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 un utente ha selezionato un luogo (ovvero è stata effettuata una richiesta di dettagli del luogo (nuova) o di convalida dell'indirizzo), devi avviare una nuova sessione utilizzando un nuovo token di 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: Autocomplete Requests

Questo SKU viene addebitato per le richieste all'API Autocomplete che non utilizzano una sessione. Per informazioni sull'utilizzo della sessione per limitare il numero di richieste fatturate durante una singola sessione di completamento automatico, consulta Token di sessione o SKU: utilizzo della sessione di completamento automatico.

	Categoria	Essentials
	Evento fatturabile	Richiesta
	Trigger	Questo SKU viene attivato alle seguenti condizioni: La tua richiesta non include un token di sessione. La richiesta include un token di sessione, ma abbandoni la sessione. La richiesta include un token di sessione, ma la sessione viene terminata in determinate condizioni. Per informazioni sull'utilizzo delle sessioni di completamento automatico, consulta Token di sessione o Utilizzo delle sessioni di completamento automatico.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: utilizzo della sessione Autocomplete

Questo SKU viene addebitato per ogni richiesta all'API Autocomplete (nuova) che include un token di sessione.

	Categoria	Essentials
	Evento fatturabile	Richiesta
	Trigger	Questo SKU viene attivato quando invii una richiesta all'API Autocomplete (nuova) che include un token di sessione. Questo SKU funge da wrapper per lo SKU delle richieste Autocomplete (nuovo) e ti consente di limitare il numero di richieste fatturate durante una singola sessione di completamento automatico. Per informazioni sull'utilizzo della sessione di completamento automatico, consulta Token di sessione. Nota: se non utilizzi le sessioni con Autocomplete (nuovo), ti viene addebitato un importo per ogni richiesta di Autocomplete utilizzando lo SKU: richieste Autocomplete. Per ulteriori informazioni, consulta Completamento automatico (nuovo) e prezzi delle sessioni.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places - Elementi essenziali dei dettagli dei luoghi (solo ID)

Questo SKU viene fatturato per le richieste a Places Details che restituiscono solo l'ID luogo.

	Categoria	Essentials
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando richiedi i seguenti campi: iOS: `GMSPlacePropertyPlaceID` `GMSPlacePropertyPhotos`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places - Elementi essenziali di Place Details

Questo SKU viene addebitato per le richieste all'API Place Details che recuperano i campi in questo SKU.

	Categoria	Essentials
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando richiedi i seguenti campi posizione: iOS: `GMSPlacePropertyAddressComponents` `GMSPlacePropertyFormattedAddress` `GMSPlacePropertyCoordinate` `GMSPlacePropertyPlusCode` `GMSPlacePropertyTypes` `GMSPlacePropertyViewport`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Place Details Pro

Questo SKU viene addebitato per i campi specificati in una richiesta Place Details Pro.

	Categoria	Pro
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando richiedi solo i seguenti campi o campi con tariffa inferiore: iOS: `GMSPlacePropertyBusinessStatus` `GMSPlacePropertyIconBackgroundColor` `GMSPlacePropertyIconImageURL` `GMSPlacePropertyName` `GMSPlacePropertyUTCOffsetMinutes` `GMSPlacePropertyWheelchairAccessibleEntrance`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Place Details Enterprise

Questo SKU viene addebitato per una richiesta di Places che include campi Enterprise.

	Categoria	Enterprise
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando richiedi i seguenti campi: Campi per iOS `GMSPlacePropertyCurrentOpeningHours` `GMSPlacePropertySecondaryOpeningHours` `GMSPlacePropertyPhoneNumber` `GMSPlacePropertyPriceLevel` `GMSPlacePropertyRating` `GMSPlacePropertyOpeningHours` `GMSPlacePropertyUserRatingsTotal` `GMSPlacePropertyWebsite` Se termini una sessione di completamento automatico con una chiamata a Places Details che richiede qualsiasi campo dall'SKU: Place Details Essentials, Pro, Enterprise o Enterprise + Atmosphere, la chiamata viene fatturata con lo SKU: Place Details Enterprise + Atmosphere. Per ulteriori informazioni, consulta SKU: utilizzo della sessione di completamento automatico.
	Fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Place Details Enterprise + Atmosphere

Questo SKU viene addebitato per le chiamate all'API Place Details che richiedono i campi dell'atmosfera specificati.

	Categoria	Enterprise
	Evento fatturabile	Richiesta
	Trigger	Questo SKU viene attivato quando richiedi i seguenti campi: iOS: `GMSPlacePropertyCurbsidePickup` `GMSPlacePropertyDelivery` `GMSPlacePropertyDineIn` `GMSPlacePropertyEditorialSummary` `GMSPlacePropertyReservable` `GMSPlacePropertyReviews` `GMSPlacePropertyServesBeer` `GMSPlacePropertyServesBreakfast` `GMSPlacePropertyServesBrunch` `GMSPlacePropertyServesDinner` `GMSPlacePropertyServesLunch` `GMSPlacePropertyServesVegetarianFood` `GMSPlacePropertyServesWine` `GMSPlacePropertyTakeout` Se una sessione di completamento automatico viene interrotta da una chiamata a Places Details che richiede qualsiasi campo dall'SKU: Place Details Essentials, Pro, Enterprise o Enterprise + Atmosphere, la chiamata viene fatturata in base allo SKU: Place Details Enterprise + Atmosphere. Per ulteriori informazioni, consulta SKU: utilizzo della sessione di completamento automatico.
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Nearby Search Pro

Questo SKU viene addebitato per i campi specificati in una richiesta Ricerca nelle vicinanze Pro.

	Categoria	Pro
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando richiedi solo i seguenti campi o campi con tariffa inferiore: iOS: `GMSPlacePropertyAddressComponents` `GMSPlacePropertyBusinessStatus` `GMSPlacePropertyCoordinate` `GMSPlacePropertyFormattedAddress` `GMSPlacePropertyName` `GMSPlacePropertyIconBackgroundColor` `GMSPlacePropertyIconImageURL` `GMSPlacePropertyPhotos` `GMSPlacePropertyPlaceID` `GMSPlacePropertyPlusCode` `GMSPlacePropertyTypes` `GMSPlacePropertyUTCOffsetMinutes` `GMSPlacePropertyViewport` `GMSPlacePropertyWheelchairAccessibleEntrance`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Nearby Search Enterprise

Questo SKU viene addebitato per le richieste di Ricerca nelle vicinanze che includono eventuali campi Enterprise.

	Categoria	Enterprise
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando richiedi i seguenti campi: iOS: `GMSPlacePropertyCurrentOpeningHours` `GMSPlacePropertySecondaryOpeningHours` `GMSPlacePropertyPhoneNumber` `GMSPlacePropertyPriceLevel` `GMSPlacePropertyRating` `GMSPlacePropertyOpeningHours` `GMSPlacePropertyUserRatingsTotal` `GMSPlacePropertyWebsite`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Nearby Search Enterprise + Atmosphere

Questo SKU viene fatturato per le richieste di ricerca nelle vicinanze che includono i campi dell'atmosfera specificati.

	Categoria	Enterprise
	Evento fatturabile	Richiesta
	Trigger	Questo SKU viene attivato quando richiedi i seguenti campi: iOS: `GMSPlacePropertyCurbsidePickup` `GMSPlacePropertyDelivery` `GMSPlacePropertyDineIn` `GMSPlacePropertyEditorialSummary` `GMSPlacePropertyReservable` `GMSPlacePropertyReviews` `GMSPlacePropertyServesBeer` `GMSPlacePropertyServesBreakfast` `GMSPlacePropertyServesBrunch` `GMSPlacePropertyServesDinner` `GMSPlacePropertyServesLunch` `GMSPlacePropertyServesVegetarianFood` `GMSPlacePropertyServesWine` `GMSPlacePropertyTakeout`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API di Places - Elementi essenziali per la ricerca di testo (solo ID)

Questo SKU viene addebitato per le richieste all'API di ricerca di testo che restituiscono solo ID.

	Categoria	Essentials
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando richiedi solo i seguenti campi: iOS: `GMSPlacePropertyPlaceID` `GMSPlacePropertyName`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Text Search Pro

Questo SKU è uno SKU di dati per cui vengono addebitati i campi specificati in una richiesta Text Search Pro.

	Categoria	Pro
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando soltanto richiedi i seguenti campi o campi con tariffa inferiore: iOS: `GMSPlacePropertyAddressComponents` `GMSPlacePropertyBusinessStatus` `GMSPlacePropertyFormattedAddress` `GMSPlacePropertyIconBackgroundColor` `GMSPlacePropertyIconImageURL` `GMSPlacePropertyCoordinate` `GMSPlacePropertyPhotos` `GMSPlacePropertyPlusCode` `GMSPlacePropertyTypes` `GMSPlacePropertyUTCOffsetMinutes` `GMSPlacePropertyViewport` `GMSPlacePropertyWheelchairAccessibleEntrance`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Text Search Enterprise

Questo SKU viene addebitato per le richieste di ricerca di testo che includono eventuali campi Enterprise.

	Categoria	Enterprise
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Questo SKU viene attivato quando richiedi i seguenti campi: iOS: `GMSPlacePropertyCurrentOpeningHours` `GMSPlacePropertySecondaryOpeningHours` `GMSPlacePropertyPhoneNumber` `GMSPlacePropertyPriceLevel` `GMSPlacePropertyRating` `GMSPlacePropertyOpeningHours` `GMSPlacePropertyUserRatingsTotal` `GMSPlacePropertyWebsite`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places Ricerca di testo Enterprise + Atmosfera

Questo SKU viene addebitato per le richieste di ricerca di testo che includono eventuali campi di atmosfera.

	Categoria	Enterprise
	Evento fatturabile	Richiesta
	Trigger	Questo SKU viene attivato quando richiedi i seguenti campi: iOS: `GMSPlacePropertyCurbsidePickup` `GMSPlacePropertyDelivery` `GMSPlacePropertyDineIn` `GMSPlacePropertyEditorialSummary` `GMSPlacePropertyReservable` `GMSPlacePropertyReviews` `GMSPlacePropertyServesBeer` `GMSPlacePropertyServesBreakfast` `GMSPlacePropertyServesBrunch` `GMSPlacePropertyServesDinner` `GMSPlacePropertyServesLunch` `GMSPlacePropertyServesVegetarianFood` `GMSPlacePropertyServesWine` `GMSPlacePropertyTakeout`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Place Details Photos

Questo SKU viene addebitato per le richieste di foto di Place Details.

	Categoria	Enterprise
	Evento fatturabile	Richiesta
	Trigger	La fatturazione viene attivata quando richiedi una foto dall'API Place Details.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

Dettagli degli SKU precedenti dell'SDK Places per iOS

Informazioni sulle sessioni di completamento automatico

Una sessione Autocomplete include alcune richieste Autocomplete (per recuperare suggerimenti su un luogo man mano che 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 (ovvero dopo che è stata 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 Autocomplete 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 dell'utente. 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.

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 Places Data sono: Dati di base, Dati di contatto e Dati sull'ambiente.

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 campi di dati di base verrà addebitata sia con lo SKU Dati di base che con lo SKU Places Details.

SKU: dati di base

Questo SKU è uno SKU dei dati che viene addebitato per i campi Dati di base in una richiesta Place Details o Find Place. Questo SKU viene addebitato in aggiunta allo SKU di base per la richiesta che lo ha attivato.

I campi della categoria Base sono inclusi nel costo base della richiesta di Places e non comportano alcun addebito aggiuntivo.

	Categoria	Essentials
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	Lo SKU Dati di base viene attivato quando richiedi 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` `Place.Field.UTC_OFFSET`. Campi ritirati: i seguenti campi sono stati ritirati nella versione 4.0 di Places SDK for Android: `Place.Field.ADDRESS`, `Place.Field.ICON_URL`, `Place.Field.LAT_LNG`, `Place.Field.NAME` e `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` campi. Utilizza invece `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` `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` `wheelchair_accessible_entrance`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Contact Data

Questo SKU è uno SKU dei dati che viene addebitato per i campi Dati di contatto in una richiesta Place Details o Find Place. Questo SKU viene addebitato in aggiunta allo SKU di base per la richiesta che lo ha attivato.

Utilizzando il parametro fields nella richiesta di dettagli dei luoghi o di ricerca di luoghi 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 addebito aggiuntivo.

	Categoria	Enterprise
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	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` Campi deprecati: il campo `Place.Field.PHONE_NUMBER` è stato deprecato 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`
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Atmosphere Data

Questo SKU viene fatturato per le richieste all'API Atmosphere Data che specificano i campi in questo SKU.

	Categoria	Enterprise
	Evento fatturabile	Richiesta con le maschere di campo specificate.
	Trigger	La fatturazione viene attivata quando richiedi uno di questi campi: iOS `GMSPlaceFieldPriceLevel` `GMSPlaceFieldRating` `GMSPlaceFieldUserRatingsTotal` `GMSPlaceFieldTakeout` `GMSPlaceFieldDelivery` `GMSPlaceFieldDineIn` `GMSPlaceFieldCurbsidePickup` `GMSPlaceFieldReservable` `GMSPlaceFieldServesBreakfast` `GMSPlaceFieldServesLunch` `GMSPlaceFieldServesDinner` `GMSPlaceFieldServesBeer` `GMSPlaceFieldServesWine` `GMSPlaceFieldServesBrunch` `GMSPlaceFieldServesVegetarianFood`.
	Esempi di fatturazione delle maschere di campo	Questi sono esempi di come la richiesta viene fatturata in base ai campi selezionati nella maschera di campi. Se la maschera dei campi della richiesta include solo i campi di questo SKU: la richiesta viene fatturata a questa tariffa SKU. Ad esempio, puoi richiedere uno o più campi da questo SKU e ti verrà addebitato il prezzo di questo SKU. Se la maschera dei campi della richiesta include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi di più SKU, ad esempio uno SKU Essentials e uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Autocomplete – Per Request

Questo SKU viene fatturato per le richieste che non includono un token di sessione

Se effettui una richiesta da una sessione Autocomplete non valida (ad esempio una sessione che riutilizza un token di sessione), ti 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 quando invii richieste da una sessione di completamento automatico non valida. Questa situazione può verificarsi quando un utente digita o copia/incolla più indirizzi diversi nel widget e non seleziona sempre una previsione di completamento automatico.

	Categoria	Essentials
	Evento fatturabile	Richiesta
	Trigger	La fatturazione viene attivata per: Android: `findAutocompletePredictions()` iOS: `findAutocompletePredictionsFromQuery:` JavaScript: Il servizio Place Autocomplete dell'API Maps JavaScript Servizio web: servizio Place Autocomplete dell'API Places
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Autocomplete without Place Details – Per Session

Questo SKU viene addebitato per una sessione Autocomplete che non include una richiesta Place Details (entro pochi minuti dall'inizio della sessione).

	Categoria	Pro
	Evento fatturabile	Sessione
	Trigger	La fatturazione viene attivata se la tua applicazione invia queste due richieste in una singola sessione: Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... Servizio web Richiedi completamento automatico dei luoghi (input="par", session_token: XYZ) Richiedi completamento automatico dei luoghi (input="paris", session_token: XYZ) Quando visualizzi la fattura per SKU, viene visualizzato questo SKU: Autocomplete senza dettagli dei luoghi - Per sessione
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

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

Le richieste di completamento automatico sono disponibili senza costi. Questo SKU viene fatturato quando richiedi ulteriori dettagli sui luoghi in base ai normali prezzi di Places Details.

	Categoria	Essentials
	Evento fatturabile	Sessione
	Trigger	Lo SKU Autocomplete (richiesta inclusa con Places Details) - Per sessione viene addebitato per una sessione Autocomplete che include una delle seguenti richieste: Android: una chiamata a `fetchPlace()` iOS: una chiamata a `fetchPlaceFromPlaceID:` Servizio web: una richiesta di dettagli sul luogo Una richiesta Places Details genera SKU dei dati (Base, Contatto e/o Atmosfera) a seconda dei campi specificati nella richiesta. Se non chiedi campi specifici nella richiesta di dettagli dei luoghi, vengono attivati tutti gli SKU dei dati (Essentials, Pro, Enterprise ed Enterprise + Atmosphere). Specifica solo i campi necessari per evitare addebiti non necessari. Se richiedi solo un aggiornamento dell'ID dettagli sul luogo (la tua richiesta specifica solo il campo `place_id`) durante una sessione di completamento automatico, la sessione viene fatturata come SKU: completamento automatico senza dettagli sul luogo – Per sessione.
	Esempi	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` che include l'ID luogo e il campo ADDRESS) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (incluso l'ID luogo e il campo `GMSPlaceFieldFormattedAddress`) Servizio web Web service Richiesta di completamento automatico di Places (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 (richiesta inclusa con Places Details) - Per sessione Place Details Basic Data
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Place Details Pro

Questo SKU viene addebitato per le richieste Places Details precedenti.

	Categoria	Pro
	Evento fatturabile	Richiesta
	Trigger	La fatturazione viene attivata per le richieste provenienti dalle seguenti API: Android: Places SDK for Android (`fetchPlace()`) iOS: Places SDK for iOS (`fetchPlaceFromPlaceID:`) JavaScript: Servizio Dettagli sui luoghi dell'API Maps JavaScript (`getDetails`) JavaScript: widget di completamento automatico dei luoghi dell'API Maps JavaScript (`getPlace`) JavaScript: Il widget SearchBox dei luoghi dell'API Maps JavaScript: metodo `getPlaces()` dopo che l'utente ha selezionato un risultato di ricerca (icona: segnaposto), non una query (icona: lente d'ingrandimento), come illustrato qui: Nei risultati del widget della casella di ricerca, dopo aver digitato "pizza" nella casella di ricerca, 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 web e i servizi, lo SKU Dettagli dei luoghi viene addebitato indipendentemente dal fatto che fornisca o meno un token di sessione. Questo SKU attiva anche la fatturazione per gli SKU di dati: se includi campi di dati nella richiesta, può attivare la fatturazione aggiuntiva per gli SKU di dati: Base, Contatto e Atmosfera. Specifica solo i campi di dati per i quali vuoi evitare costi non necessari. Ti viene addebitato questo SKU, nonché i dati che richiedi.
	Esempi	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 di dettagli dei luoghi e specifica solo il campo indirizzo: `getPlaceDetails(fields: formatted_address)` Nella fattura vedrai questi SKU (se la visualizzi in base allo SKU): Place Details Basic Data 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 la visualizzi in base allo SKU): Place Details Contact Data Effettua una di queste chiamate o richieste: Dispositivo mobile: chiama `fetchPlace()` su Android o `fetchPlaceFromPlaceID:` su iOS e specifica tutti i campi API web o servizio: effettua una richiesta di dettagli dei luoghi e specifica tutti i campi (questo tipo di richiesta è predefinito se non specifichi alcun campo): `getPlaceDetails()`. Nella fattura vedrai questi SKU (se la visualizzi in base allo SKU): Place Details Basic Data Contact Data Atmosphere Data
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Find Current Place

Questo SKU viene fatturato per le richieste a Trova posizione attuale.

Questo SKU attiva anche la fatturazione per gli SKU di dati: se includi campi di dati nella richiesta, può attivare la fatturazione aggiuntiva per gli SKU di dati: Base, Contatto e Atmosfera. Specifica solo i campi di dati per i quali vuoi evitare costi non necessari. Ti viene addebitato questo SKU, nonché i dati che richiedi.

	Categoria	Pro
	Evento fatturabile	Richiesta
	Trigger	Questo SKU viene addebitato per le richieste ai seguenti metodi: `findCurrentPlace()` (Android) `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) Questo SKU attiva anche la fatturazione per gli SKU di dati: se includi campi di dati nella richiesta, può attivare la fatturazione aggiuntiva per gli SKU di dati: Base, Contatto e Atmosfera. Specifica solo i campi di dati per i quali vuoi evitare costi non necessari. Ti viene addebitato questo SKU, nonché i dati che richiedi.
	Esempi	Gli esempi riportati di seguito mostrano gli SKU per i quali ti viene addebitato un importo quando effettui una richiesta Find Current Place e specifichi i campi degli SKU dei dati di base, di contatto e sull'ambiente. Per visualizzare gli SKU nella fattura, visualizza la fattura per SKU come descritto in Analisi dell'utilizzo e del costo per SKU. Invii una richiesta `findCurrentPlace()` (Android) o `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) e specifichi solo il campo `ADDRESS`. La fattura mostra questi SKU: Find Current Place Basic Data Invii una richiesta `findCurrentPlace()` (Android) o `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) e specifichi il campo `PHONE_NUMBER`. La fattura mostra questi SKU: Find Current Place Contact Data Effettua una richiesta `findCurrentPlace()` (Android) o `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) e specifica i campi di tutti e tre i bucket di tipo di dati. La fattura mostra questi SKU: Find Current Place Basic Data Contact Data Atmosphere Data
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: API Places, foto dei dettagli dei luoghi

Questo SKU viene fatturato per il servizio precedente Foto di Places.

	Categoria	Enterprise
	Evento fatturabile	Richiesta
	Trigger	La fatturazione viene attivata 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. La fatturazione non viene attivata finché l'URL non viene effettivamente utilizzato per ottenere i dati del pixel. Servizio web: richieste al servizio Place Photos dell'API Places
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

Altri limiti di utilizzo

Sebbene non sia previsto un numero massimo di richieste al giorno, quando utilizzi l'SDK Places per iOS si applica comunque il seguente limite di utilizzo:

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 la sezione Restrizioni relative alle licenze dei Termini di servizio di Google Maps Platform.