Modalità di fatturazione dell'API Places
L'API Places (Novità) e l'API Places utilizzano un modello di determinazione del prezzo con pagamento a consumo. Le API e gli SDK di Google Maps Platform vengono fatturati per SKU. L'utilizzo viene monitorato per ogni SKU e qualsiasi API o SDK può avere più di uno SKU 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 mensile di 200 $per ogni account di fatturazione. Questo credito viene applicato automaticamente agli SKU idonei.
Prezzi per l'API Places (novità)
Informazioni sulle maschere dei campi
Per Place Details (New),
Nearby Search (New) e
Text Search (New), utilizza l'intestazione FieldMask
nelle richieste API per specificare l'elenco di campi da restituire nella risposta. Successivamente,
ti verrà addebitato lo SKU più alto applicabile alla tua richiesta. Ciò significa che se selezioni i campi sia nello SKU (di base) che nello SKU (Avanzato), la fatturazione ti verrà addebitata in base allo SKU (Avanzato).
L'utilizzo del mascheramento dei campi è una buona prassi di progettazione per evitare di richiedere dati non necessari, evitando così tempi di elaborazione e addebiti di fatturazione non necessari.
Informazioni sulle sessioni di completamento automatico (nuove)
Una sessione Autocomplete (Nuova) include una o più richieste Autocomplete (Nuova) e una Richiesta Place Details (Nuova) o una richiesta Address Validation. Lo stesso token di sessione viene passato alla richiesta di completamento automatico (nuova) e alla successiva richiesta Place Details (Nuova) o alla richiesta di Address Validation.
Una sessione inizia con la prima richiesta di completamento automatico (nuova). Quando l'utente ha selezionato uno dei suggerimenti di completamento automatico (nuovo), viene effettuata una richiesta Place Details (Nuova) o di convalida dell'indirizzo. Se una sessione viene abbandonata, vale a dire che non viene effettuata alcuna richiesta Place Details (nuova) o una richiesta di Address Validation, le richieste Autocomplete (New) vengono addebitate come se non fosse stato fornito alcun token di sessione.
Dopo che l'utente ha selezionato un luogo (ovvero è stata effettuata una richiesta Place Details (Nuova) o Address Validation, 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
Viene addebitato uno SKU Richieste di completamento automatico per ogni richiesta all'API Autocomplete (nuova) che non include un token di sessione.
L'addebito viene effettuato anche se utilizzi i token di sessione e:
- Termina le sessioni tramite una singola richiesta a Place Details (New) che
richiede tutti i campi definiti da SKU: Place Details (Location Only).
- Ogni richiesta di completamento automatico (nuova), fino a 12 richieste, viene fatturata utilizzando SKU: richieste di completamento automatico.
- Ogni richiesta di Autocomplete (Nuova) successiva viene fatturata utilizzando lo SKU: Autocomplete Session Usage.
- Abbandona la sessione o termina la sessione effettuando una chiamata a SKU: Place Details (solo ID). Tutte le richieste di completamento automatico (nuove) vengono quindi fatturate utilizzando SKU: richieste di completamento automatico.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,00283 $ per ciascuna (2,83 $ per 1000) |
0,00227 $ per ciascuna (2,27 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Utilizzo della sessione con completamento automatico
Per ogni richiesta all'API Autocomplete (nuova) che include un token di sessione, viene addebitato uno SKU Utilizzo del completamento automatico della sessione.
Questo SKU viene addebitato nei seguenti casi:
Sessione di completamento automatico terminata da una chiamata a SKU: Place Details (Location Only):
- Ogni richiesta di completamento automatico (nuova), fino a 12 richieste, viene fatturata utilizzando SKU: richieste di completamento automatico.
- Ogni richiesta di Autocomplete (Nuova) successiva viene fatturata utilizzando lo SKU: Autocomplete Session Usage.
Sessione di completamento automatico terminata con una chiamata a SKU: Place Details (Basic, Advanced o Preferred).
Una chiamata Place Details che richiede qualsiasi campo da SKU: Place Details (Basic, Advanced o Preferred) viene fatturata in base a SKU: Place Details (Preferred).
Sessione di completamento automatico terminata con una chiamata a SKU: Address Validation Preferred.
Per maggiori informazioni, consulta Completamento automatico (novità) e prezzi delle sessioni.
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: Place Details (solo ID)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Place Details (Nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
attributions
,
id
,
name
*,
photos
* Il campo name
contiene il nome della risorsa
del luogo 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: Place Details (solo località)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Place Details (Nuova), puoi limitare la risposta ai soli 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 unità (5,00 $ per 1000) |
0,004 $ per unità (4,00 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Dettagli luogo (di base)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Place Details (Nuova), puoi limitare la risposta ai soli 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), la chiamata viene fatturata con SKU: Place Details (Preferred). Per maggiori informazioni, consulta SKU: utilizzo della sessione con completamento automatico.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,0170 $ per unità (17,00 $ per 1000) |
0,0136 $ per ciascuna (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Place Details (funzionalità avanzata)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Place Details (Nuova), puoi limitare la risposta ai soli 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), la chiamata viene fatturata con SKU: Place Details (Preferred). Per maggiori informazioni, consulta SKU: utilizzo della sessione con completamento automatico.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,020 $ per unità (20,00 $ per 1000) |
0,016 $ per unità (16,00 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Place Details (opzione preferita)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Place Details (Nuova), puoi limitare la risposta ai soli 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
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
restroom
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
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), la chiamata viene fatturata con SKU: Place Details (Preferred). Per maggiori informazioni, consulta SKU: utilizzo della sessione con completamento automatico.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,025 $ per unità (25,00 $ per 1000) |
0,020 $ per unità (20,00 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Ricerca nelle vicinanze (base)
Utilizzando una maschera di campo o un elenco di campi nella richiesta di Nearby Search (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.attributions
,
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.accessibilityOptions
{2/resource.places.name
places.primaryTypeDisplayName
places.shortFormattedAddress
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 unità (32,00 $ per 1000) |
0,0256 $ per ciascuna (25,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Ricerca nelle vicinanze (avanzata)
Utilizzando una maschera di campo o un elenco di campi nella richiesta di Nearby Search (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.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 unità (35,00 $ per 1000) |
0,028 $ per unità (28,00 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Ricerca nelle vicinanze (opzione preferita)
Utilizzando una maschera di campo o un elenco di campi nella richiesta di Nearby Search (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.allowsDogs
,
places.curbsidePickup
,
places.delivery
,
places.dineIn
,
places.editorialSummary
,
places.evChargeOptions
,
places.fuelOptions
,
places.goodForChildren
,
places.goodForGroups
,
places.goodForWatchingSports
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
places.restroom
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,040 $ per unità (40,00 $ per 1000) |
0,032 $ per unità (32,00 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: ricerca testuale (solo ID)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Ricerca testuale (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.attributions
,
places.id
,
places.name
*,
nextPageToken
* Il campo places.name
contiene il nome della risorsa
del luogo nel formato places/PLACE_ID
. 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 campo o un elenco di campi nella richiesta Ricerca testuale (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.businessStatus
,
places.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.viewport
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,032 $ per unità (32,00 $ per 1000) |
0,0256 $ per ciascuna (25,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: ricerca testuale (avanzata)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Ricerca testuale (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.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 unità (35,00 $ per 1000) |
0,028 $ per unità (28,00 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: ricerca testuale (opzione preferita)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Ricerca testuale (nuova), puoi limitare la risposta ai soli campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:
Servizio web:
places.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.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
places.restroom
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,040 $ per unità (40,00 $ per 1000) |
0,032 $ per unità (32,00 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: foto del luogo
Per ogni richiesta inviata all'API, viene addebitato uno SKU per la foto del luogo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,007 $ per unità (7,00 $ per 1000) |
0,0056 $ per ciascuna (5,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
Prezzi per l'API Places
Informazioni sulle sessioni di completamento automatico
Una sessione Autocomplete include alcune richieste Autocomplete (per recuperare i suggerimenti su un luogo mentre l'utente digita) e al massimo una richiesta Places Details (per recuperare i dettagli sul luogo selezionato dall'utente). Lo stesso token di sessione viene passato al completamento automatico e alla successiva richiesta Place Details. Una sessione inizia con la prima richiesta di completamento automatico (che di solito si verifica quando l'utente inizia a digitare). Viene effettuata una chiamata Places Details quando l'utente ha selezionato uno dei suggerimenti di Autocomplete. Se un utente non seleziona un suggerimento, non viene effettuata alcuna chiamata Places Details.
Dopo che l'utente ha selezionato un luogo (ovvero viene 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 seguenti API:
- Il servizio Place Autocomplete dell'API Places o il servizio Places Autocomplete dell'API Maps JavaScript. Devi progettare la tua applicazione in modo che fornisca i 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 su questi widget, senza che sia richiesta alcuna 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 di completamento automatico e le richieste Places Details che utilizzano le sessioni vengono fatturate in base a SKU diversi.
Informazioni sugli SKU di dati di Places
I tre SKU di dati di Places sono: Dati di base, Dati di contatto e Dati atmosfera.Uno o più SKU di dati vengono attivati per:
- Android: ogni richiesta a
fetchPlace()
ofindCurrentPlace()
- iOS: ogni chiamata al numero
fetchPlaceFromPlaceID:
ofindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Servizio web: ogni richiesta a 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, una richiesta Place Details che include campi di dati di base verrà addebitata sia per lo SKU di dati di base che per con lo SKU Place Details.
Per il servizio web, le seguenti chiamate API Places supportano la specifica dei campi di dati da restituire:
Per il servizio web, queste chiamate API di Places NON supportano la specifica dei campi restituiti. Queste chiamate restituiscono sempre tutti i dati di Places, addebitando i tre SKU di dati di Places in oltre al costo per ogni richiesta API:
SKU: Dati di base
Utilizzando il parametro campi nella richiesta Place Details o Trova luogo, puoi limitare la risposta ai soli campi specificati. I campi della categoria Base sono inclusi nel costo base della richiesta 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 Field nella richiesta Place Details o Find Place per i servizi web oppure in un array di Place.Field
per Android o iOS, puoi limitare la risposta solo ai campi specificati. I campi nella categoria Contatto comportano un addebito aggiuntivo. Lo SKU Dati di contatto viene attivato quando viene richiesto uno dei seguenti 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 per richiesta di Places + 0,0024 $ per ciascuna (+ 2,40 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: dati sull'ambiente
Utilizzando il parametro Field nella richiesta Place Details o Find Place, puoi limitare la risposta ai soli campi specificati. I campi della categoria Atmosfera comportano un addebito aggiuntivo. Lo SKU Dati atmosfera viene attivato quando viene richiesto uno dei seguenti campi:
- Android:
Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.EDITORIAL_SUMMARY
,Place.Field.DINE_IN
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
,Place.Field.RESERVABLE
,Place.Field.SERVES_BEER
,Place.Field.SERVES_BREAKFAST
,Place.Field.SERVES_BRUNCH
,Place.Field.SERVES_DINNER
,Place.Field.SERVES_LUNCH
,Place.Field.SERVES_VEGETARIAN_FOOD
,Place.Field.SERVES_WINE
,Place.Field.TAKEOUT
oPlace.Field.USER_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
oGMSPlaceFieldServesVegetarianFood
. - JavaScript: consulta Campi (dettagli 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 in base al volume |
SKU: Autocomplete - Per Request
Lo SKU Completamento automatico - Per richiesta viene addebitato per una qualsiasi di queste chiamate o richieste che non includono un token di sessione:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: servizio Place Autocomplete dell'API Maps JavaScript
- Servizio web: il servizio Place Autocomplete dell'API Places
Anche alle chiamate effettuate da una sessione di completamento automatico non valida (ad esempio, una sessione che riutilizza un token di sessione) viene addebitato uno SKU Autocomplete - Per Request.
Per le richieste di completamento automatico del widget Place Autocomplete dell'API Maps JavaScript potrebbe essere addebitato uno SKU Autocomplete - Per Request se le chiamate vengono effettuate da una sessione di Autocomplete non valida. Questo può accadere quando un utente digita più indirizzi diversi o 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 ciascuna (2,83 $ per 1000) |
0,00227 $ per ciascuna (2,27 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Completamento automatico senza Place Details - Per sessione
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 unità (17,00 $ per 1000) |
0,0136 $ per ciascuna (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
Esempio
Se la tua applicazione invia queste due chiamate in un'unica sessione:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "parigi" ...
Servizio web
- Effettua richiesta di completamento automatico (input = "par", session_token: XYZ)
- Effettua richiesta di completamento automatico (input="parigi", session_token: XYZ)
Sulla fattura, vedrai questo SKU nell'elenco (quando visualizzi la fattura per SKU):
- Completamento automatico senza Place Details - Per sessione (prezzo a partire da 0,017 $ per sessione)
SKU: Autocomplete (incluso con Place Details) - Per sessione
Lo SKU Autocomplete (included with Place Details) - Per Session Viene addebitato per una sessione di completamento automatico che include uno qualsiasi dei seguenti elementi:
- Android::una chiamata a
fetchPlace()
- iOS: una chiamata al numero
fetchPlaceFromPlaceID:
- Web service: una richiesta Place Details
La richiesta di completamento automatico è disponibile senza costi aggiuntivi, mentre la successiva chiamata Place Details viene addebitata in base ai normali prezzi di Place Details.
Una richiesta Place Details genera SKU di dati (Base, Contact e/o Atmosphere), a seconda dei campi specificati nella richiesta.
Se non specifichi campi nella richiesta Place Details, vengono attivati tutti gli SKU di dati (di base, di contatto e ambiente).
Le richieste di aggiornamento dell'ID Place Details (le 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 invia le seguenti tre chiamate in un'unica sessione:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (con un
FetchPlaceRequest
che include l'ID luogo e il campo ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "parigi" ...
- fetchPlaceFromPlaceID:
(inclusi l'ID luogo e il campo
GMSPlaceFieldFormattedAddress
)
Servizio web
- Richiesta di completamento automatico di luoghi (input="par", session_token: XYZ)
- Richiesta di completamento automatico di luoghi (input="paris", session_token: XYZ)
- Dettagli luogo (place_id, session_token: XYZ, fields:formatted_address)
Sulla fattura, vedrai elencati i seguenti SKU (quando visualizzi la fattura per SKU):
- Autocomplete (incluso con Place Details) - Per sessione (fatturato a 0.00 USD)
- Place Details (prezzo a partire da 0.017 USD per sessione)
- Basic Data (fatturato a 0.00 EUR)
SKU: Query Autocomplete – Per Request
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 di completamento automatico delle query vengono generate come tipi di utente). - Servizio web: il servizio di completamento automatico delle query dell'API Places
INTERVALLO DI VOLUME MENSILE (prezzo per RICHIESTA) |
||
---|---|---|
0,00283 $ per ciascuna (2,83 $ per 1000) |
0,00227 $ per ciascuna (2,27 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
La sessione di determinazione dei prezzi per completamento automatico non è supportata utilizzando 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 Place Details vengono addebitate come segue:
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,017 $ per unità (17,00 $ per 1000) |
0,0136 $ per ciascuna (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
Lo SKU Place Details (Dettagli luogo) viene generato da queste API:
- Android: SDK Places per Android
(
fetchPlace()
) - iOS: SDK Places per iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
servizio Place Details dell'API Maps JavaScript (
getDetails
) - JavaScript:
widget Place Autocomplete dell'API Maps JavaScript (
getPlace
) - JavaScript:
widget Place SearchBox dell'API Maps JavaScript:
getPlaces()
metodo dopo che l'utente ha selezionato un risultato luogo (icona: segnaposto), *non* una query (icona: lente d'ingrandimento), come illustrato qui:Nei risultati del widget della casella di ricerca, dopo aver digitato "pizza" nella casella di ricerca, nota che Pizza Autentico ha un'icona a forma di segnaposto accanto al risultato, mentre 1} non è una query, ma non 1} - Servizio web: servizio Place Details dell'API Places
Con l'API e i servizi web, lo SKU Place Details viene addebitato indipendentemente dal fatto che venga fornito o meno un token di sessione.
Una chiamata o una richiesta Place Details genera anche SKU di dati (Basic, Contact e/o Atmosphere), a seconda dei campi specificati nella chiamata o nella richiesta. Se i campi NO vengono specificati nella chiamata o nella richiesta Place Details, vengono attivati TUTTI gli SKU di dati e ti vengono addebitati i costi relativi alla chiamata o alla richiesta Places Details, più il costo di tutti i dati.
Esempi
- 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)
- Place Details (prezzo a partire da 0.017 USD per sessione)
- Basic Data (fatturato a 0.00 EUR)
- 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)
- Place Details (prezzo a partire da 0.017 USD per sessione)
- Contact Data (prezzo a partire da 0.003 EUR a 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 - API o servizio web:effettua una richiesta Place Details e specifica tutti i campi (questo tipo di richiesta è il valore predefinito se non specifichi nessun campo):
getPlaceDetails()
.
- Place Details (prezzo a partire da 0.017 USD per sessione)
- Basic Data (fatturato a 0.00 EUR)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Atmosphere Data (prezzo a partire da 0.005 $ a richiesta)
- Dispositivo mobile: chiama
SKU: Place Details - ID Refresh
Utilizza la richiesta Place Details per aggiornare gli ID luogo 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 Place Details specificando solo il campo ID luogo: getPlaceDetails(fields: place_id)
.
Sulla fattura, vedrai questo SKU nell'elenco (quando
visualizzi la fattura per SKU):
- Dettagli luogo – Aggiornamento ID (fatturato a 0.00 USD)
SKU: Trova luogo
A Find Place viene addebitato un costo per una richiesta Trova luogo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,017 $ per unità (17,00 $ per 1000) |
0,0136 $ per ciascuna (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
Le richieste Trova luogo generano anche SKU di dati (Base, Contatto e/o Atmosfera), a seconda dei campi specificati nella richiesta. Come per le richieste Place Details, puoi utilizzare il parametro campi nella richiesta Trova luogo per limitare la risposta ai soli campi specificati. Ti verranno addebitati i costi per la richiesta Trova luogo e per i dati richiesti. Per impostazione predefinita, se vengono richiesti campi NO, viene restituito solo l'ID luogo, quindi non vengono addebitati costi aggiuntivi per i dati.
Esempi
- Effettua una richiesta Trova luogo e specifica solo il campo dell'indirizzo:
FindPlace(fields: formatted_address)
. Sulla fattura, vedrai i seguenti SKU (quando visualizzi la fattura in base allo SKU):- Trova luogo (prezzo a partire da 0.017 EUR a chiamata)
- Basic Data (fatturato a 0.00 EUR)
- Effettua una richiesta Trova luogo e specifica il campo del numero di telefono:
FindPlace(fields: formatted_phone_number)
. Nella fattura, vedrai questi SKU elencati (quando visualizzi la fattura in base allo SKU):- Trova luogo (prezzo a partire da 0.017 EUR a chiamata)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Effettua una richiesta Find Place e specifica i campi di tutti e tre i bucket di tipi di dati:
FindPlace(fields: formatted_address, opening_hours, price_level)
. Nella fattura, vedrai elencati i seguenti SKU (quando visualizzi la fattura in base allo SKU):- Trova luogo (prezzo a partire da 0.017 EUR a chiamata)
- Basic Data (fatturato a 0.00 EUR)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Atmosphere Data (prezzo a partire da 0.005 $ a richiesta)
SKU: Trova luogo - Solo ID
L'opzione Trova luogo - Solo ID viene addebitata per le richieste Trova luogo che specificano solo l'ID luogo da restituire. Per impostazione predefinita, se non viene specificato nessun campo nella richiesta Trova luogo, 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 solo il campo place_id
: FindPlace(fields: place_id)
.
Sulla fattura, vedrai questo SKU nell'elenco (quando
visualizzi la fattura per SKU):
- Find Place - Solo ID (fatturato a 0.00 EUR)
SKU: Luogo - Ricerca nelle vicinanze
Luogo - Ricerca nelle vicinanze viene addebitato per le richieste al
servizio Place Nearby Search dell'API Maps JavaScript
(nearbySearch()
) o al
servizio Nearby Search dell'API Places
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,032 $ per unità (32,00 $ per 1000) |
0,0256 $ per ciascuna (25,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
Le richieste di Ricerca nelle vicinanze restituiscono un elenco di luoghi, ma non supportano la specifica dei campi da restituire. Le richieste di Ricerca nelle vicinanze restituiscono un sottoinsieme dei campi di dati supportati. Ti vengono addebitati i costi per la richiesta di Nearby Search a partire da 0, 032 $ per ciascuna, così come per tutti gli SKU di tipo di dati (Dati di base, Dati di contatto e Dati dell'atmosfera).
Esempio
Effettua una richiesta di ricerca nelle vicinanze, ad esempio NearbySearch (San Francisco, 100 meters)
.
Sulla fattura, vedrai elencati i seguenti SKU (quando
visualizzi la fattura per SKU):
- Luogo - Ricerca nelle vicinanze (prezzo a partire da 0.032 EUR a chiamata)
- Basic Data (fatturato a 0.00 EUR)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Atmosphere Data (prezzo a partire da 0.005 $ a richiesta)
SKU: Luogo – Ricerca testuale
Place - Text Search viene addebitata 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 unità (32,00 $ per 1000) |
0,0256 $ per ciascuna (25,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
Le richieste di ricerca testuale restituiscono un elenco di luoghi, ma non supportano la specifica dei campi da restituire. Le richieste di ricerca testuale restituiscono un sottoinsieme dei campi di dati supportati. Ti vengono addebitati i costi per le richieste di ricerca testuale a partire da 0, 032 $ per ciascuna, nonché per tutti gli SKU di tipi di dati (Dati di base, Dati di contatto e Dati atmosfera).
Lo SKU Place - Text Search viene generato anche dal metodo
Widget Place SearchBox dell'API Maps JavaScript: getPlaces()
dopo che l'utente ha selezionato una query sul luogo (icona: lente d'ingrandimento), non
un risultato (icona: segnaposto), come illustrato qui:
![Selezione della query del widget Casella di ricerca Dettagli luogo](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/billing/images/places-details-search-box-widget-query.png?authuser=5&hl=it)
Esempio
Effettua una richiesta di ricerca testuale, ad esempio TextSearch(123 Main Street)
. Sulla fattura,
vedrai i seguenti SKU (quando
visualizzi la fattura per SKU):
- Località - Ricerca testuale (prezzo a partire da 0.032 EUR a chiamata)
- Basic Data (fatturato a 0.00 EUR)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Atmosphere Data (prezzo a partire da 0.005 $ a richiesta)
SKU: foto del luogo
Uno SKU per la foto del luogo viene addebitato per:
- Android: chiamate a
fetchPhoto()
- iOS: chiamate al numero
loadPlacePhoto:
- JavaScript:per utilizzare la libreria Places, il servizio Place Photo dell'API Maps JavaScript, quando vengono richiesti 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 relativi ai pixel.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,007 $ per unità (7,00 $ per 1000) |
0,0056 $ per ciascuna (5,60 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
Altri limiti di utilizzo
Anche se non esiste 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. il che significa che ogni metodo API ha una quota separata.
API Places: il limite di frequenza è di 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 relative ai Termini e condizioni d'uso
Per informazioni sui termini di utilizzo, consulta le norme per l'API Places e la sezione Limitazioni di licenza dei Termini di servizio di Google Maps Platform.
Gestisci i costi di utilizzo
Per gestire il costo di utilizzo dell'API Places o per soddisfare le esigenze del tuo traffico di produzione, imposta limiti di quota giornalieri su tutte le richieste a qualsiasi API. Le quote giornaliere vengono reimpostate a mezzanotte del fuso orario del Pacifico.
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 sull'elenco a discesa delle 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 di quota, fai clic sull'icona Modifica per quel limite.
Nella finestra di dialogo visualizzata, inserisci nel campo Limite quota il limite di quota giornaliera fatturabile preferito (fino all'eventuale limite della quota specificato da Google) e seleziona Salva.
Se l'utilizzo dell'API raggiunge il limite di quota fatturabile in un determinato giorno, l'applicazione non potrà accedere all'API per il resto della giornata.