Utilizzo e fatturazione dell'API Places

L'API Places (nuova) e l'API Places utilizzano un modello di prezzi di pagamento a consumo. Le richieste all'API Places (nuovo) e all'API Places generano chiamate a uno di più SKU. Oltre ai Termini e condizioni d'uso generali di Google, sono previsti limiti di utilizzo specifici per l'API Places. Gestisci i costi e l'utilizzo con gli strumenti disponibili nella console Google Cloud.

Modalità di fatturazione dell'API Places

L'API Places (nuova) e l'API Places utilizzano un modello 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 prodotto. Il costo viene calcolato in base a:

Utilizzo SKU × Prezzo per utilizzo

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 Google Maps Platform per ogni account di fatturazione. Questo credito viene applicato automaticamente1 agli SKU idonei.

Prezzi per l'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 di campi da restituire nella risposta. Ti verrà quindi addebitato lo SKU più alto applicabile alla richiesta. Ciò significa che se selezioni campi sia nello SKU (base) che nello SKU (avanzato), il costo ti viene addebitato in base allo SKU (avanzato).

L'utilizzo del mascheramento dei campi è una buona pratica di progettazione per garantire di non richiedere dati non necessari, per evitare tempi di elaborazione e addebiti di fatturazione superflui.

SKU: dettagli luogo (solo ID)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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 luogo nome risorsa nel formato: places/PLACE_ID. Utilizza displayName per accedere al nome testuale del luogo.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
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 (base)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), puoi limitare la risposta solo ai campi specificati. Questo SKU viene attivato quando richiedi solo i seguenti campi:

Servizio web: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, location, primaryType, primaryTypeDisplayName, plusCode, shortFormattedAddress, subDestinations, types, utcOffsetMinutes, {19/viewport

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,0170 $ per ogni
(17,00 $ per 1000)
0,0136 $ per ogni
(13,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: Dettagli luogo (avanzato)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,020 $ per ogni
(20,00 $ per 1000)
0,016 $ per ogni
(16,00 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: Dettagli luogo (opzione preferita)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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, goodForGroups, paymentOptions, outdoorSeating, paymentOptions, outdoorSeating, reservablerestroomreviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

Tutti gli altri campi utilizzati nella stessa chiamata API vengono fatturati normalmente. I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,025 $ per ogni
(25,00 $ per 1000)
0,020 $ per ogni
(20,00 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: ricerca nelle vicinanze (base)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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 il modulo, places.primaryTypeDisplayName, places.accessibilityOptionsplaces.nameplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport

places/PLACE_ID Utilizza places.displayName per accedere al nome testuale del luogo.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,032 $ per ogni
(32,00 $ per 1000)
0,0256 $ per ogni
(25,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: ricerca nelle vicinanze (avanzata)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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-100.000 100.001-500.000 Oltre 500.000
0,035 $ per ogni
(35,00 $ per 1000)
0,028 $ per ogni
(28,00 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: ricerca nelle vicinanze (opzione preferita)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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.goodForGroups, places.paymentOptions, places.outdoorSeating, places.paymentOptions, places.outdoorSeating, places.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

Tutti gli altri campi utilizzati nella stessa chiamata API vengono fatturati normalmente. I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,040 $ per ogni
(40,00 $ per 1000)
0,032 $ per ogni
(32,00 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: ricerca testuale (solo ID)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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 luogo nome risorsa nel formato: places/PLACE_ID. Utilizza places.displayName per accedere al nome testuale del luogo.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
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 (base)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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.utcOffsetMinutesplaces.viewport

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,032 $ per ogni
(32,00 $ per 1000)
0,0256 $ per ogni
(25,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: ricerca testuale (avanzata)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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-100.000 100.001-500.000 Oltre 500.000
0,035 $ per ogni
(35,00 $ per 1000)
0,028 $ per ogni
(28,00 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: ricerca testuale (opzione preferita)

Utilizzando una maschera per il campo o un elenco di campi nella richiesta Place Details (New) (Dettagli posizione), 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.goodForGroups, places.paymentOptions, places.outdoorSeating, places.paymentOptions, places.outdoorSeating, places.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

Tutti gli altri campi utilizzati nella stessa chiamata API vengono fatturati normalmente. I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,040 $ per ogni
(40,00 $ per 1000)
0,032 $ per ogni
(32,00 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: Foto del luogo

Per ogni richiesta all'API viene addebitato uno SKU Place Photo.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,007 $ per ogni
(7,00 $ per 1000)
0,0056 $ per ogni
(5,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

Prezzi per l'API Places

Informazioni sulle sessioni di completamento automatico

Una sessione di completamento automatico include alcune richieste di completamento automatico (per recuperare i 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 Dettagli. 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 ha selezionato uno dei suggerimenti di completamento automatico. Se l'utente non seleziona un suggerimento, non viene effettuata alcuna chiamata a Dettagli luogo.

Dopo che un 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 seguenti API:

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 Places Details utilizzando le sessioni vengono fatturate su 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 ambiente.

Sono stati attivati uno o più SKU di dati per:

  • Android: ogni richiesta a fetchPlace() o findCurrentPlace()
  • iOS: ogni chiamata a fetchPlaceFromPlaceID: o findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Servizio web: ogni richiesta di Places in base ai campi specificati nella richiesta

Gli SKU di dati vengono sempre addebitati in aggiunta allo SKU di base per la richiesta che li attiva. Ad esempio, una richiesta Dettagli luogo che include i campi Dati di base verrà addebitata sia nello SKU Dati di base sia nello SKU Dettagli luogo.

Per il servizio web, l'assistenza di queste API Places specifica 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 dati di Places in aggiunta all'addebito per ogni richiesta API:


SKU: dati di base

Utilizzando il parametro dei campi nella richiesta Place Details o Find Place, puoi limitare la risposta solo ai campi specificati. I campi della categoria Base sono inclusi nel costo base della richiesta Places e non comportano alcun costo 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 o Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes o GMSPlaceFieldViewport
  • Servizio web: address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity o wheelchair_accessible_entrance
INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
Costo richiesta di luoghi
+ 0,00 $
Costo richiesta di luoghi
+ 0,00 $
Costo richiesta di luoghi
+ 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 Dati di contatto 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 o Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber o GMSPlaceFieldWebsite
  • Servizio web: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours o website
INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
Costo richiesta di luoghi
+ 0,003 $ per unità
(+ 3,00 $ per 1000)
Costo richiesta di luoghi
+ 0,0024 $ per unità
(+ 2,40 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: Dati sull'ambiente

Utilizzando il parametro dei campi nella richiesta Place Details o Find Place, puoi limitare la risposta solo ai campi specificati. I campi della categoria Atmosfera comportano un addebito aggiuntivo. Lo SKU Environment 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 o Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch o GMSPlaceFieldServesVegetarianFood.
  • JavaScript: consulta la sezione 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 o user_ratings_total.
INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
Costo richiesta di luoghi
+ 0,005 $ per unità
(+ 5,00 $ per 1000)
Costo richiesta di luoghi
+ 0,004 $ per unità
(+ 4,00 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: Completamento automatico – Per richiesta

Lo SKU Autocomplete - Per richiesta viene addebitato per tutte le chiamate o richieste che non includono un token di sessione:

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 diversi oppure copia e incolla indirizzi diversi nel widget e non seleziona sempre una previsione di completamento automatico.

INTERVALLO DI VOLUME MENSILE
(Prezzo per RICHIESTA)
0-100.000 100.001-500.000 Oltre 500.000
0,00283 $ per ogni
(2,83 $ per 1000)
0,00227 $ per ogni
(2,27 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

SKU: completamento automatico senza dettagli luogo - per sessione

Lo SKU Autocomplete senza 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-100.000 100.001-500.000 Oltre 500.000
0,017 $ per ogni
(17,00 $ per 1000)
0,0136 $ per ogni
(13,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

Esempio

Se la tua applicazione emette queste due chiamate in una singola sessione:

Android

iOS

Servizio web

Nella fattura, vedrai questo SKU elencato (quando visualizzi la fattura per SKU):

  • Completamento automatico senza Place Details - Per sessione (prezzo a partire da 0,017 $ a sessione)

SKU: Completamento automatico (incluso in Dettagli luogo) - Per sessione

Lo SKU Autocomplete (included with Place Details) - Per sessione viene addebitato per una sessione di completamento automatico che include:

  • Android: una chiamata al numero 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 a Dettagli luogo viene addebitata in base ai normali prezzi di Dettagli luogo.

Una richiesta Place Details genera SKU di dati (Base, Contact e/o Ambiente), a seconda dei campi specificati nella richiesta.

Se non specifichi campi nella richiesta Place Details, vengono attivati tutti gli SKU di dati (di base, contatto e ambiente).

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-100.000 100.001-500.000 Oltre 500.000
0.00 EUR 0.00 EUR 0.00 EUR

Esempio

Se la tua applicazione emette le seguenti tre chiamate in una singola sessione:

Android

iOS

Servizio web

Nella tua fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):

  • Completamento automatico (incluso con i Dettagli luogo) - Per sessione (fatturazione a 0,00 $)
  • Dettagli del posto (prezzo a partire da 0.017 USD per sessione)
  • Dati di base (fatturati a 0.00 $)

SKU: Completamento automatico delle query - Per richiesta

Viene addebitato uno SKU Completamento automatico query - Per richiesta per ogni richiesta di:

INTERVALLO DI VOLUME MENSILE
(Prezzo per RICHIESTA)
0-100.000 100.001-500.000 Oltre 500.000
0,00283 $ per ogni
(2,83 $ per 1000)
0,00227 $ per ogni
(2,27 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

La determinazione dei prezzi per sessione con completamento automatico non è supportata se si utilizza 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 nel seguente modo:

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,017 $ per ogni
(17,00 $ per 1000)
0,0136 $ per ogni
(13,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

Lo SKU Place Details viene generato dalle seguenti API:

Con i servizi e l'API 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 (Base, Contact e/o Ambiente), a seconda dei campi specificati nella chiamata o nella richiesta. Se nella richiesta o nella chiamata Place Details vengono specificati NO, vengono attivati TUTTI gli SKU di dati e ti viene addebitato il costo della chiamata o della richiesta Places Details più il costo di tutti i dati.

Esempi

  1. Effettua una di queste chiamate o richieste:
    • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica solo il campo ADDRESS
    • API o servizio web: effettua una richiesta Place Details e specifica solo il campo dell'indirizzo: getPlaceDetails(fields: formatted_address)
    Nella tua fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Dettagli del posto (prezzo a partire da 0.017 USD per sessione)
    • Dati di base (fatturati a 0.00 $)
  2. Effettua una di queste chiamate o richieste:
    • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica solo il campo PHONE_NUMBER
    • API o servizio web: effettua una richiesta Dettagli luogo e specifica il campo del numero di telefono: getPlaceDetails(fields: formatted_phone_number)
    Nella tua fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Dettagli del posto (prezzo a partire da 0.017 USD per sessione)
    • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
  3. Effettua una di queste chiamate o richieste:
    • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica tutti i campi
    • API o servizio web: effettua una richiesta Dettagli luogo e specifica tutti i campi (questo tipo di richiesta è il valore predefinito se non specifichi alcun campo): getPlaceDetails().
    Nella tua fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Dettagli del posto (prezzo a partire da 0.017 USD per sessione)
    • Dati di base (fatturati a 0.00 $)
    • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
    • Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

SKU: Dettagli luogo - Aggiornamento ID

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-100.000 100.001-500.000 Oltre 500.000
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, vedrai questo SKU elencato (quando visualizzi la fattura per SKU):

  • Dettagli luogo - Aggiornamento ID (fatturazione a $ 0.00)

SKU: Trova luogo

L'opzione Trova luogo viene addebitata per una richiesta Trova luogo.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,017 $ per ogni
(17,00 $ per 1000)
0,0136 $ per ogni
(13,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

Le richieste Trova luogo generano anche SKU di dati (Base, Contatto e/o Ambiente), a seconda dei campi specificati nella richiesta. Come per le richieste Dettagli luogo, puoi utilizzare il parametro dei 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

  1. Effettua una richiesta Trova luogo e specifichi solo il campo dell'indirizzo: FindPlace(fields: formatted_address). Nella tua fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Trova posto (prezzo a partire da 0.017 EUR a chiamata)
    • Dati di base (fatturati a 0.00 $)
  2. Effettua una richiesta Trova luogo e specifichi il campo del numero di telefono: FindPlace(fields: formatted_phone_number). Nella tua fattura vedrai questi SKU elencati (se visualizzi la fattura per SKU):
    • Trova posto (prezzo a partire da 0.017 EUR a chiamata)
    • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
  3. Puoi effettuare una richiesta Find Place e specificare i campi di tutti e tre i bucket di tipi di dati: FindPlace(fields: formatted_address, opening_hours, price_level). Nella tua fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Trova posto (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'atmosfera (prezzo a partire da 0,005 $ per richiesta)

SKU: Trova luogo - Solo ID

L'addebito Find Place - only ID (Trova luogo – Solo ID) viene addebitato per le richieste Trova luogo che specificano solo l'ID luogo da restituire. Per impostazione predefinita, se non viene specificato alcun campo nella richiesta Trova luogo, viene restituito solo l'ID del luogo.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
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). Nella fattura, vedrai questo SKU elencato (quando visualizzi la fattura per SKU):

  • Trova luogo – Solo ID (fatturazione: 0.00 $)

Luogo - Ricerca nelle vicinanze riceve un addebito per le richieste al servizio di ricerca nelle vicinanze dell'API JavaScript di Google Maps (nearbySearch()) o al servizio di ricerca nelle vicinanze dell'API Places

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,032 $ per ogni
(32,00 $ per 1000)
0,0256 $ per ogni
(25,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

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 Ricerca nelle vicinanze 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'ambiente).

Esempio

Effettua una richiesta di ricerca nelle vicinanze, ad esempio NearbySearch (San Francisco, 100 meters). Nella tua fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):

  • Località - Ricerca nelle vicinanze (prezzo a partire da 0.032 EUR a chiamata)
  • Dati di base (fatturati a 0.00 $)
  • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
  • Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

Place – Text Search riceve un addebito per le richieste al servizio Place Text Search dell'API Maps JavaScript (textSearch()) o al servizio di ricerca testuale dell'API Places.

INTERVALLO DI VOLUME MENSILE
(Prezzo per CHIAMATA)
0-100.000 100.001-500.000 Oltre 500.000
0,032 $ per ogni
(32,00 $ per 1000)
0,0256 $ per ogni
(25,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

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 la richiesta di ricerca testuale a partire da 0, 032 $ per ciascuna, nonché per tutti gli SKU del tipo di dati (Dati di base, Dati di contatto e Dati sull'ambiente).

Lo SKU Place – Text Search viene generato anche dal widget Place SearchBox dell'API JavaScript di Maps: getPlaces() dopo che l'utente ha selezionato una query luogo (icona: lente d'ingrandimento), non un risultato (icona: segnaposto), come illustrato qui:

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

Esempio

Effettua una richiesta di ricerca testuale, ad esempio TextSearch(123 Main Street). Nella tua fattura vedrai questi SKU elencati (quando visualizzi la fattura per SKU):

  • Place - Text Search (prezzo a partire da 0.032 USD a chiamata)
  • Dati di base (fatturati a 0.00 $)
  • Dati di contatto (prezzo a partire da 0,003 $ per richiesta)
  • Dati sull'atmosfera (prezzo a partire da 0,005 $ per richiesta)

SKU: Foto del luogo

Uno SKU Foto del luogo viene addebitato per:

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-100.000 100.001-500.000 Oltre 500.000
0,007 $ per ogni
(7,00 $ per 1000)
0,0056 $ per ogni
(5,60 $ per 1000)
Contatta il team di vendita per conoscere i prezzi per grandi volumi

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. Ciò significa che ogni metodo API ha una quota separata.

  • API Places: la limitazione di frequenza è di 6000 QPM (richieste al minuto). Viene calcolata come somma delle richieste lato client e lato server per tutte le applicazioni che utilizzano le credenziali dello stesso progetto.

Restrizioni ai Termini e condizioni d'uso

Per informazioni sui termini e condizioni d'uso, consulta le norme dell'API Places e la sezione Limitazioni di licenza dei Termini di servizio di Google Maps Platform.

Gestire i costi di utilizzo

Per gestire i costi di utilizzo dell'API Places o per soddisfare le esigenze del traffico di produzione, imposta limiti di quota giornalieri su tutte le richieste inviate 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:

  1. In Cloud Console, apri la pagina Quote di Google Maps Platform.
  2. Fai clic sul menu a discesa delle API e seleziona l'API Places.
  3. Per visualizzare i limiti di quota, scorri verso il basso fino alla scheda Richieste.
    Una tabella elenca i nomi e i limiti delle quote.
  4. Per modificare un limite di quota, fai clic sull'icona Modifica relativa al limite.
    Nella finestra di dialogo visualizzata, inserisci nel campo Limite di 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.


  1. Per ricevere il credito di Maps Platform, gli utenti in India devono creare un account di fatturazione Google Cloud Platform prima di creare un account di fatturazione per Google Maps Platform.