Utilizzo e fatturazione dell'API Places

Fatturazione e prezzi per l'API Places

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.

SKU dei prodotti di Places (novità)

Fai clic sull'icona Informazioni Informazioni per visualizzare il sommario di questa pagina. Le sezioni seguenti descrivono i dettagli di ciascun SKU:

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. Ti verrà poi addebitato lo SKU più alto applicabile alla tua richiesta. Ciò significa che se selezioni campi sia negli SKU Essentials che in quelli Pro, la fatturazione avviene in base allo SKU Pro.

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 addebiti in 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 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 di completamento automatico

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) che 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. 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 addebitato 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: Campi per il servizio web attributions id name* photos * Il campo name contiene il nome della risorsa nel formato: places/PLACE_ID. Usa displayName per accedere al nome del luogo in formato testo.
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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: Campi per il servizio web addressComponents adrFormatAddress formattedAddress location plusCode postalAddress shortFormattedAddress types viewport
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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 soltanto richiedi i seguenti campi o campi con tariffa inferiore: Campi per il servizio web accessibilityOptions businessStatus containingPlaces displayName googleMapsLinks* googleMapsUri iconBackgroundColor iconMaskBaseUri primaryType primaryTypeDisplayName pureServiceAreaBusiness subDestinations utcOffsetMinutes * Il campo googleMapsLinks si trova 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.
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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 il servizio web currentOpeningHours currentSecondaryOpeningHours internationalPhoneNumber nationalPhoneNumber priceLevel priceRange rating regularOpeningHours regularSecondaryOpeningHours userRatingCount websiteUri 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	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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: Servizio web: allowsDogs curbsidePickup delivery dineIn editorialSummary evChargeOptions fuelOptions goodForChildren goodForGroups goodForWatchingSports liveMusic menuForChildren parkingOptions paymentOptions outdoorSeating reservable restroom reviews routingSummaries* servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine takeout * Solo Ricerca di testi e Ricerca nelle vicinanze 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	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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 Nearby 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: Campi per il 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.postalAddress places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.types places.utcOffsetMinutes places.viewport * Il campo places.googleMapsLinks si trova nella fase di anteprima pre-GA e non è previsto alcun addebito, ovvero 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.
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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: Campi per il servizio web places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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: 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 Ricerca di testi e Ricerca nelle vicinanze
	Esempi di fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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: Campi per il servizio web places.attributions places.id places.name* nextPageToken * Il campo places.name contiene il nome della risorsa nel formato: places/PLACE_ID. Usa places.displayName per accedere al nome del luogo in formato testo.
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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 di 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: Campi per il 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.postalAddress 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-release e non è previsto alcun addebito, il che significa che la fatturazione è pari a 0 $per l'utilizzo durante l'anteprima.
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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: Campi per il servizio web places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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: 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 Ricerca di testi e Ricerca nelle vicinanze
	Esempi di fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Foto dei dettagli del luogo

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

SKU dei prodotti legacy di Places

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

Per il servizio web, queste richieste dell'API Places ti consentono di specificare i campi di dati da restituire:

• Places Details Pro
• 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 oltre all'addebito per ogni richiesta API:

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

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: Campi per l'SDK Android Place.Field.ACCESSIBILITY_OPTIONS*    * Da usare al posto di Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (disponibile solo fino al 1° gennaio 2019) Place.Field.ADDRESS_COMPONENTS Place.Field.BUSINESS_STATUS Place.Field.DISPLAY_NAME*    * Da usare al posto di Place.Field.NAME (disponibile solo fino al 1° gennaio 2019) Place.Field.FORMATTED_ADDRESS*    * Da usare al posto di Place.Field.ADDRESS (disponibile solo fino al 1° gennaio 2019) Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL*    * Da usare al posto di Place.Field.ICON_URL (disponibile solo fino al 1° gennaio 2019) Place.Field.ID Place.Field.LOCATION*    * Da usare al posto di Place.Field.LAT_LNG (disponibile solo fino al 1° gennaio 2019) Place.Field.PHOTO_METADATAS Place.Field.PLUS_CODE Place.Field.TYPES Place.Field.VIEWPORT Place.Field.UTC_OFFSET. Campi per iOS GMSPlaceFieldFormattedAddress GMSPlaceFieldBusinessStatus GMSPlaceFieldID GMSPlaceFieldCoordinate GMSPlaceFieldName GMSPlaceFieldPhotos GMSPlaceFieldPlusCode GMSPlaceFieldTypes GMSPlaceFieldViewport Campi per il 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
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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 Places Details o Find Place per i servizi web o un array di Place.Field per Android o iOS, puoi limitare la risposta solo ai campi specificati. I campi della categoria Contatto comportano un 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: Campi per l'SDK Android Place.Field.CURRENT_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER*       * Da utilizzare al posto di Place.Field.PHONE_NUMBER (deprecato). Place.Field.OPENING_HOURS Place.Field.SECONDARY_OPENING_HOURS Place.Field.WEBSITE_URI Campi per l'SDK per iOS GMSPlaceFieldOpeningHours GMSPlaceFieldPhoneNumber GMSPlaceFieldWebsite Campi per il servizio web formatted_phone_number international_phone_number opening_hours current_opening_hours secondary_opening_hours website
	Fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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:
	Esempi di fatturazione delle maschere di campo	La richiesta viene fatturata in base ai campi specificati nella maschera di campi. Ad esempio: Se la maschera dei campi include solo i campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU. Se la maschera dei campi include campi di altri SKU: la richiesta viene fatturata alla tariffa SKU più alta per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di 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 se invii richieste da una sessione di completamento automatico non valida. Questa situazione può verificarsi quando un utente digita o copia/incolla più svariati indirizzi 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: Il 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 dettagli su luoghi successivi in base ai prezzi di Places Details standard.

	Categoria	Essentials
	Evento fatturabile	Sessione
	Trigger	Lo SKU Autocomplete (incluso con Places Details) - Per sessione viene addebitato per una sessione Autocomplete che richiede i dettagli dei luoghi. In particolare: Android: una chiamata a fetchPlace() iOS: una chiamata a fetchPlaceFromPlaceID: Servizio web: una richiesta di dettagli sul luogo Campi nella richiesta: Assicurati di specificare i campi necessari nella richiesta per evitare addebiti non necessari. A seconda dei campi specificati, una richiesta Places Details genera anche questi SKU dei dati: Dati di base (Essentials) Località - Dati di contatto (Enterprise) Luoghi - Atmosfera (Enterprise) Se non specifichi i campi nella richiesta di dettagli dei luoghi, vengono attivati tutti gli SKU dati. Se richiedi solo un aggiornamento dell'ID dettagli sul luogo (la tua richiesta specifica solo il place_id campo) durante una sessione di completamento automatico, la sessione viene fatturata come SKU: Autocomplete senza dettagli sul luogo – Per sessione.
	Esempi	Questo esempio illustra una serie di richieste, per piattaforma, che generano i seguenti SKU nella fattura quando visualizzi la fattura per SKU: Autocomplete (richiesta inclusa con Places Details) - Per sessione Place Details Basic Data Esempio di richiesta per piattaforma: Richieste Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) fetchPlace() (con un FetchPlaceRequest che include l'ID luogo e il campo ADDRESS) Richieste per iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (incluso l'ID luogo e il campo GMSPlaceFieldFormattedAddress) Richieste di servizi web 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)
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Query Autocomplete - Per richiesta

Questo SKU precedente viene addebitato per le richieste Query Autocomplete.

	Categoria	Essentials
	Evento fatturabile	Richiesta
	Trigger	Questo SKU viene attivato quando effettui una richiesta di completamento automatico delle query utilizzando i seguenti servizi: JavaScript: il servizio Places Autocomplete dell'API Maps JavaScript (getQueryPredictions()) e l'utilizzo del widget SearchBox dell'API Maps JavaScript (le richieste di Query Autocomplete vengono generate man mano che l'utente digita). Servizio web: il servizio Query Autocomplete dell'API Places I prezzi per sessione Autocomplete non sono supportati con il completamento automatico delle query. Le richieste di dettagli su luoghi successive vengono addebitate in base allo SKU di Places Details Pro.
	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: 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: Place Details – ID Refresh

Questo SKU viene addebitato per le richieste all'API Places Details che aggiornano gli ID luogo non aggiornati.

	Categoria	Essentials
	Evento fatturabile	Richiesta
	Trigger	La fatturazione viene attivata quando effettui una richiesta Places Details specificando solo il campo ID luogo: getPlaceDetails(fields: place_id).
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Trova luogo

Questo SKU viene addebitato per le richieste a Trova luoghi che restituiscono più campi rispetto all'ID luogo.

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 fatturato per le richieste ai seguenti metodi: Find Current Place 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. Esegui una richiesta Find Place con solo il campo ADDRESS: La fattura mostra questi SKU: Find Current Place Basic Data Esegui una richiesta Find Place con solo il campo PHONE_NUMBER: Nella fattura sono riportati questi SKU: Find Current Place Contact Data Esegui una richiesta Find Place con tutti e tre i campi di tipo di dato: Nella fattura sono riportati questi SKU: Find Current Place Basic Data Contact Data Atmosphere Data
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Find Place – ID only

Questo SKU viene addebitato per le richieste a Trova luoghi che restituiscono solo l'ID luogo. Per impostazione predefinita, se non specifichi alcun campo nella richiesta Trova luogo, viene restituito solo l'ID luogo.

	Categoria	Essentials
	Evento fatturabile	Richiesta
	Trigger	Invii una richiesta Find Place senza specificare alcun campo oppure specifichi solo il place_id campo: FindPlace(fields: place_id).
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Places – Nearby Search

Questo SKU viene fatturato per le richieste di Ricerca nelle vicinanze.

	Categoria	Pro
	Evento fatturabile	Richiesta
	Trigger	Questo SKU viene attivato quando effettui una richiesta di Ricerca nelle vicinanze utilizzando una delle seguenti API: Servizio di ricerca di luoghi nelle vicinanze dell'API Maps JavaScript (nearbySearch()) Servizio di ricerca nelle vicinanze dell'API Places Questa richiesta non supporta la specifica dei campi da restituire. La risposta restituisce un elenco di luoghi e un sottoinsieme dei campi di dati supportati. 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	Invii una richiesta di ricerca nelle vicinanze, ad esempio NearbySearch (San Francisco, 100 meters). Nella fattura vengono visualizzati questi SKU quando visualizzi la fattura per SKU: Luogo Basic Data Contact Data Atmosphere Data
	Prezzi	Tabella dei prezzi principale Tabella dei prezzi per l'India

SKU: Places – Text Search

Questo SKU viene fatturato per le richieste al servizio di ricerca di testo di Places.

	Categoria	Pro
	Evento fatturabile	Richiesta
	Trigger	La fatturazione viene attivata per le richieste ai seguenti servizi: Servizio Places Text Search dell'API Maps JavaScript (textSearch()). Servizio di ricerca di testo dell'API Places 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 viene addebitato il costo della richiesta di ricerca di testo e di tutti gli SKU di tipo di dati: Dati di base, Dati di contatto e Dati sull'ambiente. Lo SKU Luogo - Ricerca di testo viene attivato anche dal metodo widget SearchBox per i luoghi dell'API Maps JavaScript: getPlaces() dopo che l'utente seleziona una query sui luoghi (icona: lente d'ingrandimento), non un risultato (icona: segnaposto), come illustrato di seguito:
	Esempio	Se effettui una richiesta di ricerca di testo, ad esempio TextSearch(123 Main Street), la fattura mostra questi SKU quando visualizzi la fattura per SKU: Luogo - Ricerca di testo 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, valgono comunque i seguenti limiti di utilizzo:

• API Places (nuova): il limite di frequenza è 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 della licenza dei Termini di servizio di Google Maps Platform.