Dettagli degli SKU Places e Routes precedenti

Questa pagina fornisce dettagli sugli SKU, ID SKU, eventi fatturabili e trigger di fatturazione per gli SKU delle API Places, API Directions e API Distance Matrix legacy. Per le versioni attuali di questi servizi, consulta i dettagli degli SKU di Places (New) e i dettagli degli SKU di Routes and Navigation. Per una directory di tutte le categorie di prodotti, consulta la panoramica dei dettagli di utilizzo dell'API.

Informazioni sulle tabelle degli SKU

Le sezioni seguenti descrivono i dettagli di ogni SKU:

Categoria Se lo SKU rientra nella categoria Essentials, Pro o Enterprise.
Evento fatturabile L'evento per cui viene fatturato lo SKU.
Trigger Quali elementi di codice attivano eventi fatturabili.
Prezzi Link alla tabella dei prezzi per il gruppo di SKU.

SKU dei prodotti Places legacy

Consulta gli SKU dei prodotti Places (New) per le versioni più recenti.

Informazioni sugli SKU di Places Data

I tre SKU di Places Data sono: Basic Data, Contact Data e Atmosphere Data.

Vengono 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 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 con lo SKU Basic Data sia con lo SKU Place Details.

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

Per il servizio web, queste chiamate API Places NON supportano la specifica dei campi restituiti. Queste chiamate restituiscono sempre tutti i dati di Places, addebitando i tre SKU di Places Data oltre all'addebito per ogni richiesta API:

[ Essentials: Places Legacy ]

SKU: Autocomplete – Per Request

  Categoria Essentials
  ID SKU

7384-2DE4-D388 (globale)

2164-BC00-53DC (India)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Evento fatturabile Richiesta che non include un token di sessione
  Trigger
  Esempi

Se effettui una richiesta da una sessione Autocomplete non valida (ad esempio, una sessione che riutilizza un token di sessione), ti verrà addebitato anche uno SKU Autocomplete - Per Request.

Alle richieste di completamento automatico provenienti dal widget Place Autocomplete dell'API Maps JavaScript potrebbe essere addebitato uno SKU Autocomplete - Per Request quando effettui richieste da una sessione di completamento automatico non valida. Questa situazione può verificarsi quando un utente digita o copia/incolla più indirizzi diversi nel widget e non seleziona sempre una previsione di completamento automatico.
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Autocomplete (included with Place Details) – Per Session

  Categoria Essentials
  ID SKU

E9C9-934B-DDB1 (globale)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Evento fatturabile Sessione
  Trigger
  • Android: una chiamata a fetchPlace()
  • iOS: una chiamata a fetchPlaceFromPlaceID:
  • Servizio web: una richiesta Place Details

Campi nella richiesta:

Assicurati di specificare i campi necessari nella richiesta per evitare addebiti non necessari. A seconda dei campi specificati, una richiesta Place Details genera anche questi SKU di dati:

Se non specifichi i campi nella richiesta Place Details, vengono attivati tutti gli SKU di dati.

Se durante una sessione di completamento automatico richiedi solo un aggiornamento dell'ID Place Details (la tua richiesta specifica solo il campo place_id), la sessione viene fatturata come SKU: Autocomplete without Place Details – Per Session.
  Esempi

Le richieste di completamento automatico sono disponibili senza costi. Questo SKU legacy viene fatturato quando richiedi Place Details successivi in base ai normali prezzi di Place Details.

Questo esempio illustra una serie di richieste, per piattaforma, che genererebbero i seguenti SKU nella tua fattura, quando visualizzi la fattura per SKU:

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • Basic Data

Esempio di richiesta per piattaforma:

Richieste Android

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (con un FetchPlaceRequest che include l'ID luogo e il campo ADDRESS)

Richieste iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (inclusi l'ID luogo e il campo GMSPlaceFieldFormattedAddress)

Richieste di servizi web

Richiesta di Place Autocomplete (input="par", session_token: XYZ)
Richiesta di Place Autocomplete (input="paris", session_token: XYZ)
Place Details (place_id, session_token: XYZ, fields:formatted_address)

  Prezzi Listino prezzi (globale)
Listino prezzi (India)

Informazioni sulle sessioni di Autocomplete

Una sessione di completamento automatico include alcune richieste di completamento automatico (per recuperare suggerimenti su un luogo mentre l'utente digita) e al massimo una richiesta di Place Details (per recuperare i dettagli sul luogo selezionato dall'utente). Lo stesso token di sessione viene passato ad Autocomplete e alla richiesta Place Details successiva. 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 di Place 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 Place Details.

Dopo che un utente ha selezionato un luogo (ovvero dopo che è stata effettuata una chiamata di Place 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 di completamento automatico e quelle di Place Details che utilizzano le sessioni vengono fatturate in base a SKU diversi.

SKU: dati di base

Uno SKU Data che fattura i campi di dati Basic Data in una richiesta Places Details o Find Place.

  Categoria Essentials
  ID SKU

75D4-C522-326B (globale)

5D7B-1F7B-395E (India)
  API Places Details (Legacy) con campi di base
Find Place (Legacy) con campi di base
  Evento fatturabile Richiesta riuscita per i campi di dati di base
  Trigger

Campi per l'SDK Android

Place.Field.ACCESSIBILITY_OPTIONS*
   * Da utilizzare al posto di Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (deprecato)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Da utilizzare al posto di Place.Field.NAME (deprecato)
Place.Field.FORMATTED_ADDRESS*
   * Da utilizzare al posto di Place.Field.ADDRESS (deprecato)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Da utilizzare al posto di Place.Field.ICON_URL (deprecato)
Place.Field.ID
Place.Field.LOCATION*
   * Da utilizzare al posto di Place.Field.LAT_LNG (deprecato)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Campi per iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Campi per il servizio web

address_component
adr_address
business_status
formatted_address
geometry
icon
name
permanently_closed
photo
place_id
plus_code
type
url
utc_offset
vicinity
wheelchair_accessible_entrance

  Fatturazione della maschera di campo

La fatturazione della richiesta si basa sui campi forniti nella maschera di campo. Ad esempio:

  • Se la maschera di campo include solo campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU.
  • Se la maschera di campo include campi di altri SKU: la richiesta viene fatturata alla tariffa dello SKU più alto per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Find Place – ID only

  Categoria Essentials
  ID SKU

44A2-D839-A3AC (globale)

FE05-60A4-CDDF (India)
  API Find Place del servizio web Places
  Evento fatturabile Richiesta riuscita solo per place_id
  Trigger Richiesta Find Place senza campi specificati o con solo il campo place_id: FindPlace(fields: place_id).
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Place Details – ID Refresh

  Categoria Essentials
  ID SKU

2D88-4302-6299 (globale)

4604-F56B-7086 (India)
  API Place Details (Legacy)
  Evento fatturabile Richiesta riuscita solo per i campi ID
  Trigger Richiesta con solo il campo ID luogo: getPlaceDetails(fields: place_id).
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Query Autocomplete – Per Request

  Categoria Essentials
  ID SKU

C4B1-8805-63EF (globale)

59E9-EB83-5CA3 (India)
  API Servizio Query Autocomplete
  Evento fatturabile Richiesta riuscita
  Trigger

I prezzi per sessione di completamento automatico non sono supportati con Query Autocomplete. Le richieste Place Details successive vengono addebitate in base allo SKU Place Details Pro.

  Prezzi Listino prezzi (globale)
Listino prezzi (India)

[ Pro: Places Legacy ]

SKU: Autocomplete without Place Details – Per Session

  Categoria Pro
  ID SKU

B52C-8320-6DC5 (globale)

C625-D3CE-DF37 (India)
  API Place Autocomplete (Legacy) Android,
Place Autocomplete (Legacy) iOS,
Place Autocomplete (Legacy) Web
  Evento fatturabile Sessione
  Trigger
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Find Current Place

  Categoria Pro
  ID SKU

7218-264C-D1D7 (globale)

0862-F46E-1A1A (India)
  API Places SDK for Android,
Places SDK for iOS
  Evento fatturabile Richiesta riuscita
  Trigger
  Esempi

Gli esempi seguenti mostrano gli SKU che ti vengono addebitati quando effettui una richiesta Trova luogo attuale e specifichi i campi degli SKU di dati Basic, Contact e Atmosphere. Per visualizzare gli SKU nella fattura, visualizza la fattura per SKU come descritto in Analizza l'utilizzo e il costo per SKU.

Effettui una richiesta Trova luogo attuale solo con il campo ADDRESS:

La tua fattura mostra questi SKU:

  • Trova luogo attuale
  • Basic Data

Effettui una richiesta Trova luogo attuale solo con il campo PHONE_NUMBER:

La tua fattura mostra questi SKU:

  • Trova luogo attuale
  • Contact Data

Effettui una richiesta Trova luogo attuale con tutti e tre i campi dei tipi di dati:

La tua fattura mostra questi SKU:

  • Trova luogo attuale
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Find Place

  Categoria Pro
  ID SKU

DC67-3188-2294 (globale)

ECB4-087C-9A27 (India)
  API Find Place (Legacy)
  Evento fatturabile Richiesta riuscita per un campo diverso da quello dell'ID
  Trigger Richiesta Find Place con più del solo campo ID specificato.
  Esempi

Gli esempi seguenti mostrano gli SKU che ti vengono addebitati quando effettui una richiesta Trova luogo attuale e specifichi i campi degli SKU di dati Basic, Contact e Atmosphere. Per visualizzare gli SKU nella fattura, visualizza la fattura per SKU come descritto in Analizza l'utilizzo e il costo per SKU.

Effettui una richiesta Trova luogo solo con il campo ADDRESS:

La tua fattura mostra questi SKU:

  • Trova luogo attuale
  • Basic Data

Effettui una richiesta Trova luogo solo con il campo PHONE_NUMBER:

La tua fattura mostra questi SKU:

  • Trova luogo attuale
  • Contact Data

Effettui una richiesta Find Place con tutti e tre i campi dei tipi di dati:

La tua fattura mostra questi SKU:

  • Trova luogo attuale
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Places – Nearby Search

  Categoria Pro
  ID SKU

6B23-8A17-D29D (globale)

CC66-BE0E-2477 (India)
  API Nearby Search (Legacy)
  Evento fatturabile Richiesta di funzionalità Pro riuscita
  Trigger

Questa richiesta non supporta la specifica dei campi da restituire. La risposta restituisce un elenco di luoghi e un sottoinsieme dei campi di dati supportati.
  Esempi

Effettui una richiesta di ricerca nelle vicinanze, ad esempio NearbySearch (San Francisco, 100 meters). La fattura mostra questi SKU quando visualizzi la fattura per SKU:

  • Luogo
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Places – Text Search

  Categoria Pro
  ID SKU

E95A-86C7-7F47 (globale)

102E-888D-5596 (India)
  API Ricerca testuale (legacy)
  Evento fatturabile Richiesta riuscita a Ricerca testuale (legacy)
  Trigger

Le richieste di Ricerca testuale restituiscono un elenco di luoghi, ma non supportano la specifica dei campi restituiti. Le richieste di Ricerca testuale restituiscono un sottoinsieme dei campi di dati supportati. Ti viene addebitato il costo della richiesta di Ricerca testuale e di tutti gli SKU dei tipi di dati: Dati di base, Dati di contatto e Dati sull'atmosfera.

SKU: Places – Ricerca testuale viene attivato anche dal widget Place SearchBox dell'API Maps JavaScript: metodo getPlaces() dopo che l'utente seleziona una query di luogo (icona: lente di ingrandimento), non un risultato (icona: segnaposto), come illustrato di seguito:

Selezione delle query del widget della casella di ricerca di Place Details
Nei risultati del widget della casella di ricerca, dopo aver digitato "pizza" nella casella di ricerca, nota che consegna pizza ha un'icona a forma di lente d'ingrandimento accanto, che indica che si tratta di una query di luogo (e non di un risultato).
  Esempi

Se effettui una richiesta di Ricerca testuale (legacy), la fattura mostra questi SKU quando visualizzi la fattura per SKU:

  • Places - Text Search
  • Basic Data
  • Contact Data
  • Atmosphere Data
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Places Details

  Categoria Pro
  ID SKU

FC5C-DF28-543F (globale)

F7AA-FEF9-C90E (India)
  API Place Details (Legacy)
  Evento fatturabile Richiesta di funzionalità Pro riuscita
  Trigger

Con l'API e i servizi web, lo SKU Place Details viene addebitato indipendentemente dal fatto che tu fornisca o meno un token di sessione.

  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 (Legacy) e specifica solo il campo dell'indirizzo: getPlaceDetails(fields: formatted_address)
    Nella fattura, vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Places Details
    • Basic Data
  2. Effettua una di queste chiamate o richieste:
    • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica solo il campo PHONE_NUMBER
    • API o servizio web: effettua una richiesta Place Details (Legacy) e specifica il campo del numero di telefono: getPlaceDetails(fields: formatted_phone_number)
    Nella fattura, vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Places Details
    • Contact Data
  3. Effettua una di queste chiamate o richieste:
    • Dispositivo mobile: chiama fetchPlace() su Android o fetchPlaceFromPlaceID: su iOS e specifica tutti i campi
    • API o servizio web: effettua una richiesta Place Details (Legacy) e specifica tutti i campi (questo tipo di richiesta è l'impostazione predefinita se non specifichi alcun campo): getPlaceDetails().
    Nella fattura, vedrai questi SKU elencati (quando visualizzi la fattura per SKU):
    • Places Details
    • Basic Data
    • Contact Data
    • Atmosphere Data
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

[ Enterprise: Places Legacy ]

SKU: Atmosphere Data

Uno SKU di dati che fattura i campi di dati Atmosphere Data in una richiesta Place Details o Find Place.

  Categoria Enterprise
  ID SKU

D63D-5CC5-302A (globale)

0CE0-1963-137E (India)
  API Place Details (Legacy) con campi Atmosphere
Find Place (Legacy) con campi Atmosphere
  Evento fatturabile Richiesta di campi di dati Atmosphere riuscita
  Trigger
  Esempi di fatturazione con maschera di campo

La fatturazione della richiesta si basa sui campi forniti nella maschera di campo. Ad esempio:

  • Se la maschera di campo include solo campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU.
  • Se la maschera di campo include campi di altri SKU: la richiesta viene fatturata alla tariffa dello SKU più alto per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: dati dei contatti

Uno SKU di dati che fattura i campi Dati di contatto in una richiesta Place Details o Find Place.

  Categoria Enterprise
  ID SKU

F095-CD01-81B2 (globale)

A03F-5079-C66C (India)
  API Place Details (Legacy) con campi di contatto
Find Place (Legacy) con campi di contatto
  Evento fatturabile Richiesta riuscita per i campi dei dati di contatto
  Trigger

Campi per l'SDK Android

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Da utilizzare al posto di Place.Field.PHONE_NUMBER (deprecato).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Campi per l'SDK per iOS

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Campi per il servizio web

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Fatturazione della maschera di campo

La fatturazione della richiesta si basa sui campi forniti nella maschera di campo. Ad esempio:

  • Se la maschera di campo include solo campi di questo SKU: la richiesta viene fatturata alla tariffa di questo SKU.
  • Se la maschera di campo include campi di altri SKU: la richiesta viene fatturata alla tariffa dello SKU più alto per i campi richiesti. Ad esempio, se includi campi sia di uno SKU Essentials sia di uno SKU Enterprise, la richiesta viene fatturata alla tariffa dello SKU Enterprise.
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Places Photo

  Categoria Enterprise
  ID SKU

81E7-85D0-58A7 (globale)

9F4B-2E19-1B63 (India)
  API Places Photo (Legacy)
  Evento fatturabile Richiesta di una foto andata a buon fine
  Trigger
  • Android: richieste a fetchPhoto()
  • iOS: richieste a loadPlacePhoto:
  • JavaScript: richieste a PlacePhoto.getUrl() per caricare i dati dei pixel immagine.
  • Servizio web: richieste al servizio Foto dei luoghi dell'API Places.
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU dell'API Routes precedente

[ Essentials: Routes Legacy ]

SKU: Directions

  Categoria Essentials
  ID SKU

28A8-3EB4-4595 (globale)

4714-291C-3199 (India)
  API Servizio Directions dell'API Maps JavaScript,
API Directions (legacy)
  Evento fatturabile Richiesta riuscita senza funzionalità Pro o Enterprise
  Trigger Query che non attivano uno SKU con un rating più elevato
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Distance Matrix

  Categoria Essentials
  ID SKU

C1B6-FF9D-7700 (globale)

558A-4F88-F361 (India)
  API API Distance Matrix (legacy),
Servizio Distance Matrix dell'API Maps JavaScript
  Evento fatturabile Ogni elemento che non contiene funzionalità Pro o Enterprise. Ogni richiesta inviata all'API Distance Matrix genera elementi, dove il numero di origins moltiplicato per il numero di destinations è uguale al numero di elementi.
  Trigger Richieste di elementi che non attivano SKU con prezzi più elevati
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

[ Pro: Routes Legacy ]

SKU: Directions Advanced

  Categoria Pro
  ID SKU

9407-00C2-CF85 (globale)

E27B-BD57-FD7D (India)
  API Servizio Directions dell'API Maps JavaScript,
API Directions (legacy)
  Evento fatturabile Richiesta riuscita con funzionalità Pro
  Trigger
  Prezzi Listino prezzi (globale)
Listino prezzi (India)

SKU: Distance Matrix Advanced

  Categoria Pro
  ID SKU

DFAE-763F-CF6E (globale)

C0F4-32AE-F6D1 (India)
  API API Distance Matrix (legacy),
Servizio Distance Matrix dell'API Maps JavaScript
  Evento fatturabile Ogni elemento restituito con le funzionalità Pro. Ogni richiesta inviata all'API Distance Matrix genera elementi, dove il numero di origins moltiplicato per il numero di destinations è uguale al numero di elementi.
  Trigger
  Prezzi Listino prezzi (globale)
Listino prezzi (India)