Modalità di fatturazione dell'API Places
L'API Places (Novità) e l'API Places utilizzano un modello di determinazione del prezzo di pagamento a consumo. Le API e gli SDK di Google Maps Platform sono fatturati per SKU. L'utilizzo viene monitorato per ogni SKU e qualsiasi API o SDK può avere più di uno SKU di prodotto. Il costo viene calcolato in base a:
Utilizza il nostro Calcolatore prezzi e utilizzo per stimare il costo di utilizzo per API o SDK. Per gli SKU di Google Maps Platform idonei, è disponibile un credito di 200 $per Google Maps Platform al mese per ogni account di fatturazione. Questo credito viene applicato automaticamente1 agli SKU idonei.
Prezzi dell'API Places (novità)
Informazioni sulle maschere dei campi
Per Dettagli luogo (Nuova), Ricerca nelle vicinanze (Nuova) e Ricerca testuale (Nuova), utilizza l'intestazione FieldMask
nelle richieste API per specificare l'elenco dei campi da restituire nella risposta. Ti verrà quindi addebitato lo SKU più elevato applicabile alla tua richiesta. Ciò significa che se selezioni i campi sia nello SKU (di base) che nello SKU (avanzato), l'addebito avviene in base allo SKU (avanzato).
L'utilizzo del mascheramento dei campi è una buona pratica di progettazione per garantire di non richiedere dati non necessari, il che contribuisce a evitare tempi di elaborazione e addebiti di fatturazione superflui.
Informazioni sulle sessioni di completamento automatico (nuove)
Una sessione di completamento automatico (nuova) include una o più richieste di completamento automatico (nuova) e al massimo una richiesta di dettagli luogo (nuova) o richiesta di convalida indirizzo. Lo stesso token di sessione viene trasmesso alla richiesta Autocomplete (New) e alla successiva richiesta Place Details (New) o Address Validation.
Una sessione inizia con la prima richiesta di completamento automatico (nuova). Viene quindi effettuata una richiesta Dettagli luogo (Nuova) o Convalida indirizzo quando l'utente ha selezionato uno dei suggerimenti di Completamento automatico (Nuovo). Se una sessione viene abbandonata, ossia non viene effettuata alcuna richiesta Place Details (New) o Address Validation, le richieste di completamento automatico (New) vengono addebitate come se non fosse stato fornito alcun token di sessione.
Dopo che un utente ha selezionato un luogo (ovvero viene effettuata una richiesta Place Details (Nuovo) o Convalida 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 di sessione, la sessione viene considerata non valida e le richieste vengono addebitate come se non fosse stato fornito alcun token di sessione.
SKU: richieste di completamento automatico
Uno SKU Richiesta di completamento automatico viene addebitato per ogni richiesta all'API Autocomplete (New) che non include un token di sessione.
Viene addebitato anche se utilizzi i token di sessione e:
- Termina le sessioni con una singola richiesta a Place Details (New) che
richiede tutti i campi definiti dallo SKU: Place Details (Location Only).
- Ogni richiesta di completamento automatico (nuova), fino a un massimo di 12 richieste, viene fatturata utilizzando lo SKU: Autocomplete richieste.
- Ogni richiesta successiva di completamento automatico (nuova) viene fatturata utilizzando lo SKU: Utilizzo del completamento automatico della sessione.
- Abbandona la sessione o terminala effettuando una chiamata allo SKU: Place Details (solo ID). Tutte le richieste di completamento automatico (nuova) vengono quindi fatturate utilizzando lo SKU: Richieste di completamento automatico.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,00283 $ per ogni (2,83 $ per 1000) |
0,00227 $ per ogni (2,27 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Utilizzo del completamento automatico della sessione
Uno SKU Autocomplete Session Usage viene addebitato per ogni richiesta all'API Autocomplete (New) che include un token di sessione.
Questo SKU viene addebitato in due casi:
Sessione di completamento automatico terminata da una chiamata a SKU: Place Details (solo posizione):
- Ogni richiesta di completamento automatico (nuova), fino a un massimo di 12 richieste, viene fatturata utilizzando lo SKU: Autocomplete richieste.
- Ogni richiesta successiva di completamento automatico (nuova) viene fatturata utilizzando lo SKU: Utilizzo del completamento automatico della sessione.
La sessione di completamento automatico è terminata con una chiamata a SKU: Place Details (Base, Advanced o Preferred) o una chiamata a SKU: Address Validation Preferred.
Una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred) viene fatturata tramite lo SKU: Place Details (Preferred). Per maggiori informazioni, consulta Prezzi per completamento automatico (nuovo) e sessione.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0.00 $ per ogni (0.00 $ per 1000) |
0.00 $ per ogni (0.00 $ per 1000) |
0.00 $ per ogni (0.00 $ per 1000) |
SKU: dettagli luogo (solo ID)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
id
,
name
*,
photos
* Il campo name
contiene il nome della risorsa
nel formato places/PLACE_ID
. Utilizza displayName
per accedere al nome testuale del luogo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,0 $ per ogni (0,00 $ per 1000) |
0,0 $ per ogni (0,00 $ per 1000) |
0,0 $ per ogni (0,00 $ per 1000) |
SKU: dettagli luogo (solo località)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
shortFormattedAddress
,
types
,
viewport
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,005 $ per ogni (5,00 $ per 1000) |
0,004 $ per ogni (4,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: dettagli posizione (base)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
accessibilityOptions
,
businessStatus
,
displayName
,
googleMapsUri
,
iconBackgroundColor
,
iconMaskBaseUri
,
primaryType
,
primaryTypeDisplayName
,
subDestinations
,
utcOffsetMinutes
Se una sessione di completamento automatico viene terminata da una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred), il costo della chiamata verrà fatturato tramite SKU: Place Details (Preferred). Per maggiori informazioni, consulta SKU: Utilizzo del completamento automatico delle sessioni.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,0170 $ per ogni (17,00 $ per 1000) |
0,0136 $ per ogni (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Dettagli luogo (avanzato)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
currentOpeningHours
,
currentSecondaryOpeningHours
,
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
regularSecondaryOpeningHours
,
userRatingCount
,
websiteUri
Se una sessione di completamento automatico viene terminata da una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred), il costo della chiamata verrà fatturato tramite SKU: Place Details (Preferred). Per maggiori informazioni, consulta SKU: Utilizzo del completamento automatico delle sessioni.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,020 $ per ogni (20,00 $ per 1000) |
0,016 $ per ogni (16,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Dettagli luogo (opzione preferita)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Dettagli luogo (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
allowsDogs
,
curbsidePickup
,
delivery
,
dineIn
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
goodForChildren
,
goodForGroups
,
goodForWatchingSports
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
outdoorSeating
,
reservable
,
restroom
,
reviews
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDesserts
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
Se una sessione di completamento automatico viene terminata da una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred), il costo della chiamata verrà fatturato tramite SKU: Place Details (Preferred). Per maggiori informazioni, consulta SKU: Utilizzo del completamento automatico delle sessioni.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,025 $ per ogni (25,00 $ per 1000) |
0,020 $ per ogni (20,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: ricerca nelle vicinanze (di base)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Ricerca nelle vicinanze (nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Il servizio web:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.id
,
places.location
,
places.name
*,
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
places.name
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
places/PLACE_ID
Utilizza places.displayName
per accedere al nome testuale del luogo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,032 $ per ogni (32,00 $ per 1000) |
0,0256 $ per ogni (25,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Ricerca nelle vicinanze (avanzata)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Ricerca nelle vicinanze (nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,035 $ per ogni (35,00 $ per 1000) |
0,028 $ per ogni (28,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: ricerca nelle vicinanze (preferita)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Ricerca nelle vicinanze (nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.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.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDesserts
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,040 $ per ogni (40,00 $ per 1000) |
0,032 $ per ogni (32,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: ricerca testuale (solo ID)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Ricerca testuale (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.id
,
places.name
*
* Il campo places.name
contiene il nome della risorsa
nel formato places/PLACE_ID
. Utilizza places.displayName
per accedere al nome testuale del luogo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,0 $ per ogni (0,00 $ per 1000) |
0,0 $ per ogni (0,00 $ per 1000) |
0,0 $ per ogni (0,00 $ per 1000) |
SKU: ricerca testuale (di base)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Ricerca testuale (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.location
,
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.subDestinations
,
places.types
,
places.utcOffsetMinutes
,
places.utcOffsetMinutes
places.viewport
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,032 $ per ogni (32,00 $ per 1000) |
0,0256 $ per ogni (25,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: ricerca testuale (avanzata)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Ricerca testuale (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,035 $ per ogni (35,00 $ per 1000) |
0,028 $ per ogni (28,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: ricerca testuale (opzione preferita)
Utilizzando una maschera di campi o un elenco di campi nella richiesta Ricerca testuale (Nuova), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.allowsDogs
,
places.curbsidePickup
,
places.delivery
,
places.dineIn
,
places.editorialSummary
,
places.evChargeOptions
,
places.fuelOptions
,
places.goodForChildren
,
places.goodForGroups
,
places.goodForWatchingSports
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.restroom
,
places.reviews
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDesserts
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,040 $ per ogni (40,00 $ per 1000) |
0,032 $ per ogni (32,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: foto del luogo
Per ogni richiesta all'API viene addebitato uno SKU Place Photo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,007 $ per ogni (7,00 $ per 1000) |
0,0056 $ per ogni (5,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
Prezzi per l'API Places
Informazioni sulle sessioni di completamento automatico
Una sessione Autocomplete include alcune richieste di completamento automatico (per recuperare suggerimenti su un luogo come tipi di utente) e al massimo una richiesta Places Details (per recuperare i dettagli sul luogo selezionato dall'utente). Lo stesso token di sessione viene passato al completamento automatico e alla successiva richiesta Place Details. Una sessione inizia con la prima richiesta di completamento automatico (che in genere si verifica quando l'utente inizia a digitare). Viene effettuata una chiamata Places Details quando l'utente seleziona uno dei suggerimenti di completamento automatico. Se un utente non seleziona un suggerimento, non viene effettuata alcuna chiamata Places Details.
Dopo che l'utente ha selezionato un luogo (ad esempio, è stata effettuata una chiamata Places Details, devi avviare una nuova sessione utilizzando un nuovo token di sessione.
Le sessioni di completamento automatico possono essere generate dalle API seguenti:
- Il servizio Place Autocomplete dell'API Places o il servizio Places Autocomplete dell'API Maps JavaScript. Devi progettare l'applicazione in modo da fornire token di sessione (potrebbe essere necessario modificare il codice esistente).
- Il widget di completamento automatico dell'API Maps JavaScript. La fatturazione basata sulla sessione viene attivata automaticamente sui widget, senza che sia richiesta la modifica del codice.
Un token di sessione è valido per una sessione utente e non deve essere utilizzato per più di una sessione utente. Se riutilizzi un token di sessione, la sessione viene considerata non valida e le richieste vengono addebitate come se non fosse stato fornito alcun token di sessione.
Le richieste Autocomplete e le richieste Places Details utilizzando le sessioni vengono fatturate in SKU diversi.
Informazioni sugli SKU di dati di Places
I tre SKU di dati di luogo sono: Dati di base, Dati dei contatti e Dati dell'atmosfera.Uno o più SKU di dati vengono attivati per:
- Android: ogni richiesta inviata a
fetchPlace()
ofindCurrentPlace()
- iOS: ogni chiamata a
fetchPlaceFromPlaceID:
ofindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Servizio web: ogni richiesta di Places in base ai campi specificati nella richiesta.
Gli SKU di dati vengono sempre addebitati in aggiunta allo SKU di base per la richiesta che li attiva. Ad esempio, per una richiesta Place Details che include i campi di dati di base vengono addebitati sia lo SKU Basic Data sia lo SKU Place Details.
Per il servizio web, queste API Places chiama l'assistenza specificando i campi di dati da restituire:
Per il servizio web, queste chiamate dell'API Places NON supportano la specifica dei campi restituiti. Queste chiamate restituiscono sempre tutti i dati di Places, addebitando i tre SKU di Places Data in aggiunta al costo per ogni richiesta API:
SKU: dati di base
Tramite il parametro dei campi nella richiesta Place Details o Find Place, puoi limitare la risposta solo ai campi specificati. I campi nella categoria Base sono inclusi nel costo base della richiesta Places e non comportano alcun addebito aggiuntivo. Lo SKU Dati di base viene attivato quando viene richiesto uno dei seguenti campi:
-
Android:
Place.Field.ADDRESS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_URL
,Place.Field.ID
,Place.Field.LAT_LNG
,Place.Field.NAME
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
,Place.Field.UTC_OFFSET
oPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
oGMSPlaceFieldViewport
-
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
owheelchair_accessible_entrance
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
Costo della richiesta di Places + 0,00 $ |
Costo della richiesta di Places + 0,00 $ |
Costo della richiesta di Places + 0,00 $ |
SKU: dati di contatto
Utilizzando il parametro dei campi nella richiesta Dettagli luogo o Trova luogo per i servizi web, oppure
un array di Place.Field
per Android o iOS, puoi
limitare la risposta solo ai campi specificati. I campi nella categoria Contatto comportano un addebito aggiuntivo. Lo SKU Contact Data viene attivato quando viene richiesto uno di questi campi:
-
Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
,Place.Field.SECONDARY_OPENING_HOURS
oPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
oGMSPlaceFieldWebsite
-
Servizio web:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
owebsite
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
Costo della richiesta di Places + 0,003 $ per ciascuna (+ 3,00 $ per 1000) |
Costo della richiesta di Places + 0,0024 $ per ciascuna (+ 2,40 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Dati ambiente
Tramite il parametro dei campi nella richiesta Place Details o Find Place, puoi limitare la risposta solo ai campi specificati. I campi della categoria Ambiente comportano un addebito aggiuntivo. Lo SKU Ambient Data viene attivato quando viene richiesto uno di questi campi:
- Android:
Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.EDITORIAL_SUMMARY
,Place.Field.DINE_IN
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
,Place.Field.RESERVABLE
,Place.Field.SERVES_BEER
,Place.Field.SERVES_BREAKFAST
,Place.Field.SERVES_BRUNCH
,Place.Field.SERVES_DINNER
,Place.Field.SERVES_LUNCH
,Place.Field.SERVES_VEGETARIAN_FOOD
,Place.Field.SERVES_WINE
,Place.Field.TAKEOUT
oPlace.Field.USER_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
oGMSPlaceFieldServesVegetarianFood
. - JavaScript: consulta i campi (dettagli del luogo)
- Servizio web:
curbside_pickup
,delivery
,dine_in
,editorial_summary
,price_level
,rating
,reservable
,reviews
,serves_beer
,serves_breakfast
,serves_brunch
,serves_dinner
,serves_lunch
,serves_vegetarian_food
,serves_wine
,takeout
ouser_ratings_total
.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
Costo della richiesta di Places + 0,005 $ per ciascuna (+ 5,00 $ per 1000) |
Costo della richiesta di Places + 0,004 $ per ciascuna (+ 4,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Completamento automatico – Per richiesta
Lo SKU Autocomplete - Per Request viene addebitato per tutte le chiamate o richieste che non includono un token di sessione:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: il servizio Place Autocomplete dell'API Maps JavaScript
- Servizio web: il servizio Place Autocomplete dell'API Places
Anche per le chiamate effettuate da una sessione di completamento automatico non valida (ad esempio, una sessione che riutilizza un token di sessione) viene addebitato uno SKU di completamento automatico - Per richiesta.
Alle richieste di completamento automatico dal widget Place Autocomplete dell'API Maps JavaScript potrebbe essere addebitato uno SKU di completamento automatico - Per richiesta nel caso in cui le chiamate vengano effettuate da una sessione di completamento automatico non valida. Questo può accadere quando un utente digita più indirizzi oppure copia/incolla diversi indirizzi nel widget e non sempre seleziona una previsione di completamento automatico.
INTERVALLO DI VOLUME MENSILE (prezzo per RICHIESTA) |
||
---|---|---|
0,00283 $ per ogni (2,83 $ per 1000) |
0,00227 $ per ogni (2,27 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Autocomplete senza Place Details - Per Session
Lo SKU Autocomplete without Place Details - Per Session viene addebitato per una sessione di completamento automatico che non include una richiesta Place Details (entro pochi minuti dall'inizio della sessione).
INTERVALLO DI VOLUME MENSILE (prezzo per SESSIONE) |
||
---|---|---|
0,017 $ per ogni (17,00 $ per 1000) |
0,0136 $ per ogni (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
Esempio
Se la tua applicazione invia queste due chiamate in una singola sessione:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placeClient?.findAutocompletePredictions(fromQuery: "par" ...
- placeClient?.findAutocompletePredictions(fromQuery: "parigi" ...
Servizio web
- Place Autocomplete Request (input="par", session_token: XYZ)
- Place Autocomplete Request (input="paris", session_token: XYZ)
Nella fattura troverai il seguente SKU (quando vedrai la fattura per SKU):
- Autocomplete senza Place Details - Per Session (prezzo a partire da 0,017 $ a sessione)
SKU: Autocomplete (included with Place Details) - Per Session
Lo SKU Autocomplete (included with Place Details) - Per Session viene addebitato per una sessione di completamento automatico che include:
- Android: una chiamata a
fetchPlace()
- iOS: una chiamata a
fetchPlaceFromPlaceID:
- Servizio web:una richiesta Dettagli luogo
La richiesta di completamento automatico è disponibile senza costi aggiuntivi, mentre la successiva chiamata Place Details viene addebitata in base ai normali prezzi Place Details.
Una richiesta Place Details genera SKU di dati (Basic, Contact e/o Ambient), a seconda dei campi specificati nella richiesta.
Se non specifichi i campi nella richiesta Place Details, verranno attivati tutti gli SKU di dati (Base, Contact e Ambient).
Le richieste di aggiornamento dell'ID Place Details (richieste che specificano solo il campo place_id
)
durante una sessione di completamento automatico vengono fatturate come SKU: Autocomplete
senza Place Details - Per Session.
INTERVALLO DI VOLUME MENSILE (prezzo per SESSIONE) |
||
---|---|---|
0.00 EUR | 0.00 EUR | 0.00 EUR |
Esempio
Se la tua applicazione effettua le seguenti tre chiamate in una singola sessione:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (con un
FetchPlaceRequest
che include l'ID luogo e il campo INDIRIZZO)
iOS
- placeClient?.findAutocompletePredictions(fromQuery: "par" ...
- placeClient?.findAutocompletePredictions(fromQuery: "parigi" ...
- fetchPlaceFromPlaceID
(inclusi l'ID luogo e il campo
GMSPlaceFieldFormattedAddress
)
Servizio web
- Richiesta di completamento automatico di Places (input="par", session_token: XYZ)
- Richiesta di completamento automatico di Places (input="paris", session_token: XYZ)
- Places Details (place_id, session_token: XYZ, Fields:formatted_address)
Nella fattura troverai i seguenti SKU (quando vedrai la fattura per SKU):
- Autocomplete (incluso con Place Details) - Per sessione (fatturato a 0.00 USD)
- Dettagli posizione (prezzo a partire da 0,017 $ per sessione)
- Dati di base (fatturati a 0.00 $)
SKU: Completamento automatico query - Per richiesta
Viene addebitato uno SKU Query Autocomplete - Per Request per ogni richiesta a:
- JavaScript: il
servizio Places Autocomplete dell'API Maps JavaScript (
getQueryPredictions()
) e l'utilizzo del widget SearchBox dell'API Maps JavaScript (le richieste Query Autocomplete vengono generate come i tipi di utenti). - Servizio web: il servizio Query Autocomplete dell'API Places
INTERVALLO DI VOLUME MENSILE (prezzo per RICHIESTA) |
||
---|---|---|
0,00283 $ per ogni (2,83 $ per 1000) |
0,00227 $ per ogni (2,27 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
I prezzi per sessione di completamento automatico non sono supportati con il completamento automatico delle query. Le chiamate Places Details successive vengono addebitate in base ai normali prezzi di Places Details.
SKU: Dettagli luogo
Le chiamate a Dettagli luogo vengono addebitate come segue:
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,017 $ per ogni (17,00 $ per 1000) |
0,0136 $ per ogni (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
Lo SKU Place Details (Dettagli del luogo) viene generato da queste API:
- Android: SDK Places per Android
(
fetchPlace()
) - iOS: SDK Places per iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
il servizio Place Details dell'API Maps JavaScript (
getDetails
) - JavaScript:
widget Place Autocomplete dell'API Maps JavaScript (
getPlace
) - JavaScript:
il widget Place SearchBox dell'API Maps JavaScript: metodo
getPlaces()
dopo che l'utente ha selezionato un risultato luogo (icona: segnaposto), *non* una query (icona: lente d'ingrandimento), come illustrato qui: - Servizio web: servizio Place Details dell'API Places
Con l'API web e i servizi, lo SKU Place Details viene addebitato indipendentemente dal fatto che venga fornito o meno un token di sessione.
Una chiamata o una richiesta Place Details genera anche SKU di dati (Basic, Contact e/o Ambient), a seconda dei campi specificati nella chiamata o nella richiesta. Se nella chiamata o nella richiesta Place Details vengono specificati i campi NO, vengono attivati TUTTI gli SKU di dati e ti viene addebitato l'importo per la chiamata o la richiesta Places Details oltre al costo di tutti i dati.
Esempi
- Effettua una di queste chiamate o richieste:
- Dispositivo mobile: chiama
fetchPlace()
su Android ofetchPlaceFromPlaceID:
su iOS e specifica solo il campoADDRESS
- API o servizio web: effettua una richiesta Place Details e specifica solo il campo dell'indirizzo:
getPlaceDetails(fields: formatted_address)
- Dettagli posizione (prezzo a partire da 0,017 $ per sessione)
- Dati di base (fatturati a 0.00 $)
- Dispositivo mobile: chiama
- Effettua una di queste chiamate o richieste:
- Dispositivo mobile: chiama
fetchPlace()
su Android ofetchPlaceFromPlaceID:
su iOS e specifica solo il campoPHONE_NUMBER
- API o servizio web: effettua una richiesta Place Details e specifica il campo del numero di telefono:
getPlaceDetails(fields: formatted_phone_number)
- Dettagli posizione (prezzo a partire da 0,017 $ per sessione)
- Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
- Dispositivo mobile: chiama
- Effettua una di queste chiamate o richieste:
- Dispositivo mobile: chiama
fetchPlace()
su Android ofetchPlaceFromPlaceID:
su iOS e specifica tutti i campi - Servizio o API web:effettua una richiesta Place Details e specifica tutti i campi (questo tipo di richiesta è l'impostazione predefinita se non specifichi nessun campo):
getPlaceDetails()
.
- Dettagli posizione (prezzo a partire da 0,017 $ per sessione)
- Dati di base (fatturati a 0.00 $)
- Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
- Dati sull'ambiente (prezzo a partire da 0,005 $ per richiesta)
- Dispositivo mobile: chiama
SKU: Dettagli luogo - Aggiornamento ID
Utilizza la richiesta Dettagli luogo per aggiornare gli ID dei luoghi inattivi. Questi tipi di richieste sono disponibili senza costi aggiuntivi.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0.00 EUR | 0.00 EUR | 0.00 EUR |
Esempio
Effettua una richiesta Dettagli luogo specificando solo il campo ID luogo:
getPlaceDetails(fields: place_id)
.
Nella fattura troverai il seguente SKU (quando
vedrai la fattura per SKU):
- Place Details - ID refresh (fatturato a 0,00 $)
SKU: Trova luogo
L'opzione Find Place riceve un addebito per una richiesta Find Place.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,017 $ per ogni (17,00 $ per 1000) |
0,0136 $ per ogni (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
Le richieste Find Place generano anche SKU di dati (Base, Contact e/o Ambiente), a seconda dei campi specificati nella richiesta. Come nelle richieste Dettagli luogo, puoi utilizzare il parametro campi nella richiesta Trova luogo per limitare la risposta solo ai campi specificati. Ti verranno addebitati i costi per la richiesta Find Place e per i dati richiesti. Per impostazione predefinita, se vengono richiesti i campi NO, viene restituito solo l'ID luogo, quindi non vengono addebitati costi aggiuntivi per i dati.
Esempi
- Effettua una richiesta Trova luogo e specifichi solo il campo dell'indirizzo:
FindPlace(fields: formatted_address)
. Nella fattura troverai i seguenti SKU (quando visualizzi la fattura per SKU):- Find Place (prezzo a partire da 0,017 EUR a chiamata)
- Dati di base (fatturati a 0.00 $)
- Effettua una richiesta Trova luogo e specifichi il campo del numero di telefono:
FindPlace(fields: formatted_phone_number)
. Nella fattura troverai questi SKU elencati (quando visualizzi la fattura per SKU):- Find Place (prezzo a partire da 0,017 EUR a chiamata)
- Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
- Effettua una richiesta Find Place e specifichi i campi da tutti e tre i bucket di tipi di dati:
FindPlace(fields: formatted_address, opening_hours, price_level)
. Nella fattura troverai i seguenti SKU (quando visualizzi la fattura per SKU):- Find Place (prezzo a partire da 0,017 EUR a chiamata)
- Dati di base (fatturati a 0.00 $)
- Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
- Dati sull'ambiente (prezzo a partire da 0,005 $ per richiesta)
SKU: Trova luogo – Solo ID
L'opzione Find Place - only ID viene addebitata per le richieste Find Place che specificano solo l'ID luogo da restituire. Per impostazione predefinita, se non vengono specificati campi nella richiesta Find Place, viene restituito solo l'ID luogo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0.00 EUR | 0.00 EUR | 0.00 EUR |
Esempio
Effettua una richiesta Trova luogo e specifichi soltanto il campo place_id
: FindPlace(fields: place_id)
.
Nella fattura troverai il seguente SKU (quando
vedrai la fattura per SKU):
- Find Place – Solo ID (fatturato a 0.00 USD)
SKU: Luogo - Ricerca nelle vicinanze
Luogo – Ricerca nelle vicinanze riceve un addebito per le richieste al
servizio Place Nearby Search dell'API Maps JavaScript
(nearbySearch()
) o al
servizio Nearby Search dell'API Places
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,032 $ per ogni (32,00 $ per 1000) |
0,0256 $ per ogni (25,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
Le richieste di Ricerca nelle vicinanze restituiscono un elenco di luoghi, ma non supportano la specifica di quali campi restituire. Le richieste di ricerca nelle vicinanze restituiscono un sottoinsieme dei campi di dati supportati. Ti vengono addebitati i costi per la richiesta di Nearby Search a partire da 0, 032 $ per ciascuna, nonché per tutti gli SKU di tipo di dati (Dati di base, Dati dei contatti e Dati sull'atmosfera).
Esempio
Effettua una richiesta di Ricerca nelle vicinanze, ad esempio NearbySearch (San Francisco, 100 meters)
.
Nella fattura troverai i seguenti SKU (quando vedrai la fattura per SKU):
- Località - Ricerca nelle vicinanze (prezzo a partire da 0,032 $ a chiamata)
- Dati di base (fatturati a 0.00 $)
- Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
- Dati sull'ambiente (prezzo a partire da 0,005 $ per richiesta)
SKU: Luogo – Ricerca testuale
L'addebito Place – Text Search (Ricerca testo) viene addebitato per le richieste al
servizio Place Text Search dell'API Maps JavaScript
(textSearch()
) o al
servizio Text Search dell'API Places.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,032 $ per ogni (32,00 $ per 1000) |
0,0256 $ per ogni (25,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
Le richieste di ricerca testuale restituiscono un elenco di luoghi, ma non supportano la specifica di quali campi restituire. Le richieste di Ricerca testuale restituiscono un sottoinsieme di campi di dati supportati. Ti vengono addebitati i costi per la richiesta di ricerca testuale a partire da 0, 032 $ per ciascuna, così come per tutti gli SKU di tipo di dati (Dati di base, Dati dei contatti e Dati Ambiente).
Lo SKU Place - Text Search viene generato anche dal
widget Place SearchBox dell'API Maps JavaScript: getPlaces()
dopo che l'utente ha selezionato una query su un luogo (icona: lente d'ingrandimento), non
un risultato (icona: segnaposto), come illustrato qui:
Esempio
Effettua una richiesta di Ricerca testuale, ad esempio TextSearch(123 Main Street)
. Nella fattura troverai i seguenti SKU (quando vedrai la fattura per SKU):
- Posto - Ricerca testuale (prezzo a partire da 0,032 $ a chiamata)
- Dati di base (fatturati a 0.00 $)
- Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
- Dati sull'ambiente (prezzo a partire da 0,005 $ per richiesta)
SKU: foto del luogo
Lo SKU Place Photo viene addebitato per:
- Android: chiamate a
fetchPhoto()
- iOS: chiamate a
loadPlacePhoto:
- JavaScript:su Places Library, servizio Place Photo dell'API Maps JavaScript quando vengono richiesti i dati dagli URL restituiti da
PlacePhoto.getUrl()
per caricare i dati dei pixel dell'immagine. - Servizio web: richieste al servizio Place Photo dell'API Places
Per il servizio JavaScript, il richiamo del metodo PlacePhoto.getUrl()
non comporta la fatturazione finché l'URL non viene effettivamente utilizzato per ottenere i dati dei pixel.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,007 $ per ogni (7,00 $ per 1000) |
0,0056 $ per ogni (5,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
Altri limiti di utilizzo
Sebbene non sia previsto un numero massimo di richieste al giorno, si applicano comunque i seguenti limiti di utilizzo:
API Places (nuova): il limite di frequenza è di 600 QPM (richieste al minuto) per metodo API per progetto. Questo significa che ogni metodo API ha una quota separata.
API Places: il limite di frequenza è 6000 QPM (richieste al minuto). È calcolata come somma delle richieste lato client e lato server per tutte le applicazioni che utilizzano le credenziali dello stesso progetto.
Restrizioni relative ai Termini e condizioni d'uso
Per informazioni sui termini e condizioni d'uso, consulta le norme per l'API Places e la sezione Limitazioni di licenza dei Termini di servizio di Google Maps Platform.
Gestisci il costo di utilizzo
Per gestire i costi di utilizzo dell'API Places o soddisfare le esigenze del traffico di produzione, imposta limiti di quota giornalieri su tutte le richieste a qualsiasi API. Le quote giornaliere vengono reimpostate alla mezzanotte del fuso orario del Pacifico USA.
Per visualizzare o modificare i limiti di quota per l'API Places:
- Nella console Cloud, apri la pagina Quote di Google Maps Platform.
- Fai clic sul menu a discesa API e seleziona API Places.
- Per visualizzare i limiti di quota, scorri verso il basso fino alla scheda Richieste.
Una tabella elenca i nomi e i limiti delle quote. - Per modificare un limite della quota, fai clic sull'icona Modifica per il limite in questione.
Nella finestra di dialogo visualizzata, inserisci nel campo Limite di quota il limite giornaliero fatturabile preferito (fino al limite di quota, se presente, specificato da Google) e seleziona Salva.
Se l'utilizzo dell'API raggiunge il limite di quota fatturabile in un determinato giorno, l'applicazione non potrà accedere all'API per il resto della giornata.
Risorse per la gestione dei costi correlate
-
Gli utenti in India devono creare un account di fatturazione Google Cloud prima di creare un account di fatturazione Google Maps Platform per ricevere il credito di Maps Platform. ↩