Modalità di fatturazione dell'API Places
L'API Places (nuova) e l'API Places utilizzano un modello di prezzo di pagamento a consumo. Le API di Google Maps Platform mentre gli SDK vengono fatturati per SKU. L'utilizzo viene monitorato per ogni SKU e qualsiasi API o SDK può avere più di un 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 le qualifiche SKU di Google Maps Platform: ogni mese è disponibile un credito di 200 $per Google Maps Platform per ogni account di fatturazione. Questo credito viene applicato automaticamente agli SKU idonei.
Prezzi dell'API Places (novità)
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. Stai
e verranno addebitati allo SKU più alto applicabile alla tua richiesta. Ciò significa che
seleziona i campi dello SKU (di base) e dello SKU (avanzato), ti verranno addebitati
in base allo SKU (avanzato).
L'utilizzo del mascheramento dei campi è una buona prassi di progettazione per assicurarsi di non richiedere di dati non necessari, così da evitare tempi di elaborazione e fatturazione superflui addebiti.
Informazioni sulle sessioni di completamento automatico (nuove)
Una sessione di completamento automatico (nuova) include una o più richieste di completamento automatico (nuova) e una Place Details (Nuova) richiesta o Address Validation. Lo stesso token di sessione viene passato Richiesta Autocomplete (Nuova) e successiva richiesta Place Details (Nuova) o Address Validation richiesta.
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 una richiesta Place Details (Nuova) o una 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 durante la sessione. Se riutilizzi un token di sessione, la sessione viene considerata non valida e le richieste vengono addebitati come se non fosse stato fornito alcun token di sessione.
SKU: Autocomplete Requests
Per ogni richiesta inviata alla richiesta, viene addebitato uno SKU Richieste di completamento automatico API Autocomplete (nuova) che non include un token di sessione.
L'addebito viene effettuato anche se utilizzi token di sessione e:
- Chiudere le sessioni tramite una singola richiesta a Place Details (Novità) 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 il metodo SKU: richieste di completamento automatico.
- Ogni richiesta Autocomplete (Nuova) successiva viene fatturata utilizzando lo SKU: Utilizzo sessione Autocomplete.
- Abbandona la sessione o termina la sessione effettuando una chiamata al SKU: Place Details (solo ID). Tutte le richieste Autocomplete (New) vengono poi fatturate utilizzando lo SKU: Autocomplete Requests.
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 per 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 sessione Autocomplete.
Questo SKU viene addebitato nei seguenti scenari:
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 il metodo SKU: richieste di completamento automatico.
- Ogni richiesta Autocomplete (Nuova) successiva viene fatturata utilizzando lo SKU: Utilizzo sessione Autocomplete.
La sessione di completamento automatico è terminata con una chiamata a SKU: dettagli sul luogo (di base, avanzata o preferita).
Una chiamata Place Details che richiede qualsiasi campo dal SKU: Place Details (Basic, Advanced o Preferred) viene fatturato al SKU: Place Details (opzione preferita).
Sessione di completamento automatico terminata con una chiamata a SKU: Address Validation Preferito.
Per ulteriori informazioni, vedi Completamento automatico (nuovo) 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 solo ai campi specificati. Questo SKU viene attivato quando soltanto richiedi i seguenti campi:
Servizio web:
attributions
,
id
,
name
*,
photos
* Il campo name
contiene il luogo nome risorsa
nel formato: places/PLACE_ID
. Usa displayName
per accedere al nome del luogo in formato testo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0.0 $ 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 località)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Place Details (Nuova), puoi limitare 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 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: Place Details (Basic)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Place Details (Nuova), puoi limitare 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 SKU: Dettagli luogo (base, avanzato o preferito), il costo della chiamata sarà pari a SKU: Place Details (opzione preferita). Per ulteriori informazioni, vedi SKU: Utilizzo della sessione con completamento automatico.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,0170 $ per ogni (17,00 $ per 1000) |
0,0136 $ per ciascuna (13,60 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Place Details (funzionalità avanzata)
Utilizzando una maschera di campi o un elenco di campi nella richiesta di dettagli dei luoghi (nuova), puoi limitare la risposta solo ai campi specificati. Questo Lo 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 a Place Details che richiede qualsiasi campo dall'SKU: Place Details (Basic, Advanced, or Preferred), la chiamata viene fatturata in base allo SKU: Place Details (Preferred). Per ulteriori informazioni, consulta SKU: utilizzo della sessione di completamento automatico.
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 in base al volume |
SKU: Place Details (opzione preferita)
Utilizzando una maschera di campi o un elenco di campi nella richiesta di dettagli dei luoghi (nuova), puoi limitare la risposta solo ai campi specificati. Questo Lo 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
,
routingSummaries
,*
servesBeer
,
servesBreakfast
,
servesBrunch
,
servesCocktails
,
servesCoffee
,
servesDessert
,
servesDinner
,
servesLunch
,
servesVegetarianFood
,
servesWine
,
takeout
* Solo ricerca testuale e ricerca nelle vicinanze
Se una sessione di completamento automatico viene terminata da una chiamata Place Details che richiede qualsiasi campo SKU: Dettagli luogo (base, avanzato o preferito), il costo della chiamata sarà pari a SKU: Place Details (opzione preferita). Per ulteriori informazioni, consulta SKU: utilizzo della sessione di completamento automatico.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,025 $ per unità (25,00 $ per 1000) |
0,020 $ per ogni (20,00 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Ricerca nelle vicinanze (di base)
Utilizzando una maschera di campi o un elenco di campi nella richiesta di Ricerca nelle vicinanze (nuova), puoi limitare la risposta solo ai campi specificati. Questo Lo 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.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.subDestinations
,
places.types
,
places.utcOffsetMinutes
,
places.viewport
* Il campo places.name
contiene il luogo nome risorsa
nel formato: places/PLACE_ID
. Usa 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 campi o un elenco di campi nella richiesta di Ricerca nelle vicinanze (nuova), puoi limitare la risposta solo ai campi specificati. Questo Lo 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 unità (28,00 $ per 1000) |
Contatta il team di vendita per i prezzi per volume |
SKU: Ricerca nelle vicinanze (opzione preferita)
Utilizzando una maschera di campo o un elenco di campi nella richiesta di Ricerca nelle vicinanze (nuova), puoi limitare le solo ai campi specificati. Questo Lo 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.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 testuale e ricerca nelle vicinanze
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 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 le solo ai 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 luogo nome risorsa
nel formato: places/PLACE_ID
. Usa places.displayName
per accedere al nome del luogo in formato testo.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0.0 $ per ogni (0.00 $ per 1000) |
0,00 $ per ogni (0,00 $ per 1000) |
0,00 $ 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 le 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.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 per volume |
SKU: ricerca testuale (avanzata)
Utilizzando una maschera di campo o un elenco di campi nella richiesta Ricerca testuale (Nuova), puoi limitare le solo ai campi specificati. Questo Lo 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 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 di ricerca di testo (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.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 testuale e ricerca nelle vicinanze
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 Foto 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 di completamento automatico include alcune richieste di completamento automatico (per recuperare suggerimenti su una ogni volta che l'utente digita i nomi) e al massimo una richiesta Places Details (per recuperare i dettagli su al 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 solitamente si verifica 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 (ad es. viene 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:
- Lo il servizio Place Autocomplete dell'API Places o il Servizio Places Autocomplete dell'API Maps JavaScript. Devi progettare per fornire token di sessione (potrebbe essere necessario modificare il codice esistente).
- Il widget di completamento automatico dell'API Maps JavaScript. La fatturazione basata sulle sessioni viene attivata automaticamente su questi widget, senza alcuna modifica al codice.
Un token di sessione è valido per una sessione utente e non deve essere utilizzato per più di un utente durante la 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.
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 dati di Places 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()
ofindCurrentPlace()
- iOS: ogni chiamata a
fetchPlaceFromPlaceID:
ofindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Servizio web: ogni richiesta a Places in base ai campi specificati nella richiesta
Gli SKU di dati vengono sempre addebitati oltre allo SKU di base per l'attivazione della richiesta che li rappresentano. Ad esempio, una richiesta Place Details che include campi di dati di base verrà addebitata in entrambi i sensi lo SKU Basic Data e 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 campi. 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
Se utilizzi il parametro campi nella richiesta Place Details o Find Place, puoi limitare solo ai campi specificati. I campi della categoria Base sono inclusi nel costo base della richiesta di Places e non comportano alcun addebito aggiuntivo. Lo SKU Dati di base viene attivato quando uno qualsiasi di questi campi è richiesto:
-
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
oPlace.Field.UTC_OFFSET
. -
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
Utilizzare il parametro campi nella richiesta Place Details o Find Place per i servizi web; oppure
un array di Place.Field
per Android o iOS,
limita la risposta ai soli campi specificati. Campi nel Contatto
comportano un addebito aggiuntivo. 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
oppurePlace.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 delle richieste di Places + 0,0024 $ per ciascuna (+ 2,40 $ per 1000) |
Contatta il team di vendita per i prezzi in base al volume |
SKU: Atmosphere Data
Puoi utilizzare il parametro campi nella richiesta Place Details o Find Place limita la risposta ai soli campi specificati. I campi della categoria Atmosphere comportano un addebito aggiuntivo. Lo SKU Dati sull'atmosfera 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_RATING_COUNT
- 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 ognuna 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
Chiamate effettuate da una sessione di completamento automatico non valida (ad esempio, una sessione che riutilizza un token di sessione) viene addebitato anche uno SKU Autocomplete - Per Request.
delle richieste di completamento automatico API Maps JavaScript Nel caso in cui vengano effettuate chiamate, potrebbe essere addebitato uno SKU Autocomplete - Per Request - Place Autocomplete da una sessione di completamento automatico non valida. Questo può accadere quando un utente digita più indirizzi diversi. o copiare/incollare indirizzi diversi 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 senza Places Details - Per sessione viene addebitato per una sessione Autocomplete che non include una richiesta Places 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 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 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
- Richiesta di completamento automatico dei luoghi (input=”par”, session_token: XYZ)
- Effettua richiesta di completamento automatico (input="parigi", session_token: XYZ)
Nella fattura, vedrai questo SKU nell'elenco (quando visualizzare la fattura per SKU):
- Autocomplete senza Places Details - Per sessione (prezzo a partire da 0,017 $ per sessione)
SKU: Autocomplete (incluso con Place Details) - Per sessione
Lo SKU Autocomplete (incluso con Places Details) - Per sessione viene addebitato per una sessione Autocomplete che include uno dei seguenti elementi:
- Android: una chiamata a
fetchPlace()
- iOS: una chiamata a
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 alle Prezzi di Place Details.
Una richiesta Place Details genera SKU di dati (Basic, Contatto e/o Ambiente) a seconda dei campi specificati nella richiesta.
Se non specifichi i campi nella richiesta Place Details, vengono attivati tutti gli SKU di dati (Base, Contatti e Ambiente).
Richieste di aggiornamento dell'ID Place Details (richieste che specificano solo il campo place_id
)
durante una sessione di completamento automatico vengono fatturati come SKU: Autocomplete
senza Place Details - Per sessione.
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
incluso l'ID posizione 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)
Nella fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
- Autocomplete (incluso con Place Details) - Per sessione (fatturato a 0.00 USD)
- Dettagli dei luoghi (prezzo a partire da 0,017 $ per sessione)
- Dati di base (fatturati a 0,00 $)
SKU: Query Autocomplete - Per richiesta
Viene addebitato uno SKU Query Autocomplete - Per richiesta 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 man mano che l'utente digita). - Servizio web:il Servizio di completamento automatico delle query dell'API Places
FASCIA 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 per volume |
La sessione di determinazione dei prezzi per completamento automatico non è supportata utilizzando il completamento automatico delle query. Successiva Le chiamate a Places Details vengono addebitate in base alle Prezzi di Places Details.
SKU: Place Details
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 per volume |
Lo SKU Place Details (Dettagli luogo) viene generato da queste API:
- Android: Places SDK for 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()
dopo che l'utente ha selezionato un risultato di posizionamento (icona: puntina), *non* una query (icona: lente d'ingrandimento), come illustrato qui: - 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 un token di sessione forniti o meno.
Una chiamata o una richiesta Places Details genera anche SKU dati (Base, Contatto e/o Atmosfera), a seconda degli campi specificati nella chiamata o nella richiesta. Se vengono specificati campi NO durante la chiamata o la richiesta Place Details, vengono attivati TUTTI gli SKU di dati e ti vengono addebitati i costi relativi alla chiamata o alla richiesta Places Details.
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 di dettagli sul luogo e specifica solo il campo 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)
- 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 - API o servizio web:effettua una richiesta Place Details e specifica tutti i campi (questo tipo di
è l'impostazione predefinita se non specifichi nessun campo):
getPlaceDetails()
.
- Dettagli dei luoghi (prezzo a partire da 0,017 $ per sessione)
- Basic Data (fatturato a 0.00 EUR)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)
- Dispositivo mobile: chiama
SKU: Place Details - ID Refresh
Utilizza la richiesta Places Details per aggiornare gli ID luogo non aggiornati. 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
Fai una richiesta Places Details specificando solo il campo ID luogo:
getPlaceDetails(fields: place_id)
.
Nella fattura, vedrai questo SKU nell'elenco (quando
visualizzare la fattura per SKU):
- Dettagli dei luoghi - Aggiornamento ID (fatturato a 0,00 $)
SKU: Trova luogo
Find Place viene addebitato per una richiesta di Find Place.
INTERVALLO DI VOLUME MENSILE (prezzo per CHIAMATA) |
||
---|---|---|
0,017 $ per unità (17,00 $ per 1000) |
0,0136 $ per ogni (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 del nei campi specificati nella richiesta. Metti Mi piace ai dettagli del luogo richieste, puoi utilizzare il parametro campi nella richiesta Find Place per limitare la risposta solo ai campi specificati. Ti verranno addebitati i costi per la richiesta Trova luogo, richiesto. Per impostazione predefinita, se vengono richiesti campi NO, viene restituito solo l'ID luogo. evitando così che vengano addebitati costi aggiuntivi per i dati.
Esempi
- Effettua una richiesta Trova luogo e specifica solo il campo dell'indirizzo:
FindPlace(fields: formatted_address)
. Nella fattura, vedrai questi SKU elencati (quando visualizzazione della fattura per 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 elencati questi SKU (quando visualizzi la fattura per SKU):- Trova luogo (prezzo a partire da 0,017 $ per chiamata)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Effettuerai una richiesta Trova luogo e specifichi i campi di tutti e tre i bucket di tipi di dati:
FindPlace(fields: formatted_address, opening_hours, price_level)
. Nella fattura, vedrai elencati questi SKU (quando visualizzazione della fattura per SKU):- Trova luogo (prezzo a partire da 0,017 $ per chiamata)
- Dati di base (fatturati a 0,00 $)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)
SKU: Find Place – ID only
L'opzione Trova luogo - Solo ID viene addebitata per le richieste Trova luogo che specificare l'ID luogo da restituire. Per impostazione predefinita, se non viene specificato alcun campo in 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
Invii una richiesta Find Place e specifichi solo il campo place_id
: FindPlace(fields: place_id)
.
Nella fattura, vedrai questo SKU nell'elenco (quando
visualizzare 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 alla
Servizio Place Nearby Search dell'API Maps JavaScript
(nearbySearch()
) o alle
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 per volume |
Le richieste di Ricerca nelle vicinanze restituiscono un elenco di luoghi, ma non supportano la specifica di quali campi vengono restituito. Le richieste di Ricerca nelle vicinanze restituiscono un sottoinsieme dei campi di dati supportati. L'importo per la richiesta di Nearby Search ti viene addebitato a partire da 0.032 $ per ognuno, nonché per tutti gli SKU di tipi di dati (Dati di base, Dati di contatto e Dati sull'ambiente).
Esempio
Effettua una richiesta di ricerca nelle vicinanze, ad esempio NearbySearch (San Francisco, 100 meters)
.
Nella fattura, vedrai questi SKU elencati (quando
visualizzare 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)
- Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)
SKU: Luogo – Ricerca testuale
L'attributo Place – Text Search 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 unità (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 le supportano che specifica quali campi vengono restituiti. Le richieste di ricerca di testo restituiscono un sottoinsieme dei campi di dati supportati. Ti vengono addebitati 0,032 $ per ogni richiesta di ricerca di testo, nonché tutti gli SKU dei tipi di dati (Dati di base, Dati di contatto e Dati sull'ambiente).
Lo SKU Place - Text Search viene generato anche dalla
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:
Esempio
Effettua una richiesta di ricerca testuale, ad esempio TextSearch(123 Main Street)
. Nella fattura,
vedrai elencati questi SKU (quando
visualizzare la fattura per SKU):
- Località - Ricerca testuale (prezzo a partire da 0.032 EUR a chiamata)
- Dati di base (fatturati a 0,00 $)
- Contact Data (prezzo a partire da 0.003 EUR a richiesta)
- Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)
SKU: Place Photo
Uno SKU per la foto del luogo viene addebitato per:
- Android: chiamate a
fetchPhoto()
- iOS: chiamate al numero
loadPlacePhoto:
- JavaScript:nella Libreria Places, l'API Maps JavaScript
Servizio Place Photo quando vengono richiesti dati dagli URL restituiti da
PlacePhoto.getUrl()
per caricare i dati dei pixel dell'immagine - Servizio web: richieste al servizio Place Photos dell'API
Per il servizio JavaScript, l'invocazione del metodo PlacePhoto.getUrl()
non comporta la fatturazione finché l'URL non viene effettivamente utilizzato per ottenere i dati del 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 per volume |
Altri limiti di utilizzo
Anche se non esiste un numero massimo di richieste al giorno, quanto segue: rimangono in vigore i seguenti limiti di utilizzo:
API Places (nuova): il limite di frequenza è 600 QPM (richieste al minuto) per metodo API e progetto. Significato di 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 relative ai Termini e condizioni d'uso
Per informazioni sui termini di utilizzo, consulta le norme relative all'API Places e la sezione Limitazioni delle licenze dei Termini di servizio di Google Maps Platform.
Gestisci i costi di utilizzo
Per gestire i costi di utilizzo dell'API Places o per soddisfare le esigenze della tua produzione di traffico, imposta limiti di quota giornalieri per 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:
- In Cloud Console, 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 sezione 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 limite della quota giornaliera fatturabile preferita (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.