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 di prodotto 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:

Categoria Indica se lo SKU rientra nella categoria SKU Essentials, Pro o Enterprise.
Evento fatturabile L'evento addebitato per lo SKU.
Trigger Quali elementi di codice attivano gli eventi fatturabili.
Prezzi Link alla tabella dei prezzi del gruppo di 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 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:

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

  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:

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

  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:
  • Servizio web:
    accessibilityOptions
    businessStatus
    containingPlaces
    displayName
    googleMapsLinks*
    googleMapsUri
    iconBackgroundColor
    iconMaskBaseUri
    primaryType
    primaryTypeDisplayName
    pureServiceAreaBusiness
    subDestinations
    utcOffsetMinutes

    * Il campo 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.

  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:
  • 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.

  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 + 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

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:
  • 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-release 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.

  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:

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

  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:

  • 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

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:

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

  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:
  • 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-release e non è previsto alcun addebito, ovvero la fatturazione è pari a 0 $, per l'utilizzo durante l'anteprima.

  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:
  • Servizio web:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  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:
  • 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

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

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:

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.

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

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:

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.
  • 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
  • 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:
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
Place.Field.USER_RATING_COUNT
GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.
Consulta Campi (dettagli dei luoghi)
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
user_ratings_total.
  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.

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:

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:

Servizio web

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: 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:

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:

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
  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 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
  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 la visualizzi in base allo SKU):
    • Place Details
    • Contact Data
  3. 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 addebitato 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.

  1. Invii una richiesta Find Place e specifichi solo il campo indirizzo: FindPlace(fields: formatted_address). La fattura mostra questi SKU:
    • Find Place
    • Basic Data
  2. Invii una richiesta Find Place e specifichi il campo del numero di telefono: FindPlace(fields: formatted_phone_number). La fattura mostra questi SKU:
    • Find Place
    • Contact Data
  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). La fattura mostra questi SKU:
    • Find 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 campo place_id: 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:

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:

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:

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

Se effettui una richiesta di ricerca di testo, ad esempio TextSearch(123 Main Street), nella fattura vengono visualizzati 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:
  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 per l'API Places e la sezione Limitazioni della licenza dei Termini di servizio di Google Maps Platform.