Le funzionalità del modello Gemini per l'API Places (novità) integrano il supporto per gli LLM all'API Places per consentirti di restituire i dati associati a un luogo (orari di apertura, recensioni, foto) insieme ai dati forniti dagli LLM. Questi dati generativi contengono dati aggregati e riassunti degli LLM per migliorare i dati già associati a un luogo.
Ad esempio, una ricerca testuale (nuova) standard per "stazioni di ricarica EV" restituisce un elenco di luoghi che offrono la ricarica EV. Questo tipo di risposta è accettabile se cerchi semplicemente il caricabatterie EV più vicino o quello più vicino compatibile con il tuo veicolo.
Potresti anche voler capire meglio l'area circostante la stazione di ricarica, specialmente se il veicolo è in carica per un'ora o più. Quando si utilizzano le funzionalità del modello Gemini per la stessa ricerca, la risposta può contenere descrizioni dinamiche e generative di ogni punto della risposta, incluse informazioni sull'area circostante la stazione di ricarica:
"A 2-4 minuti a piedi ci sono diversi punti ristoro e negozi, tra cui Chef Chu's, Gen Korea BBQ House, Amber India, Pacific Catch e diversi negozi di alimentari come Walmart, Whole Foods Market e Trader Joe's".
"A 1-5 minuti a piedi ci sono diversi punti ristoro e negozi, tra cui Khao Kang Thai Kitchen, Roger's Deli & Donuts e La Costeña. Per il sushi, il Joy Sushi è una buona opzione. Per i generi alimentari, Dollar Tree offre una varietà di prodotti a prezzi scontati".
Questi contenuti generativi degli LLM migliorano la risposta e forniscono ulteriori informazioni per aiutare gli utenti a prendere una decisione consapevole.
Nuove funzionalità basate sull'IA aggiunte all'API Places (novità)
Queste funzionalità aggiungono i seguenti dati a una risposta dell'API Places (nuova):
Riepiloghi generativi dei luoghi relativi a un luogo specifico. I riepiloghi dei luoghi sono supportati da Dettagli luogo (nuova), Ricerca testuale (nuova) e Ricerca nelle vicinanze (nuova).
Riepiloghi dell'area generativa relativi a una specifica area nei dintorni di un luogo. I riepiloghi delle aree sono supportati da Dettagli luogo (nuova), Ricerca testuale (nuova) e Ricerca nelle vicinanze (nuova).
I risultati di ricerca contestuale sono supportati dalla ricerca testuale (nuova) e contengono dati basati sulla stringa di ricerca passata nella richiesta, anziché i dati direttamente associati a un luogo. Questi dati aiutano a capire in che modo Ricerca testuale (novità) determina la risposta.
Riepiloghi generativi dei luoghi
I riepiloghi generativi dei luoghi sono specifici di un ID luogo. I riepiloghi dei luoghi aggregano molti tipi diversi di dati in un unico riepilogo per il luogo.
L'API Places (novità) fornisce due tipi di riassunti generativi dei luoghi:
Riepiloghi di panoramica: breve panoramica di un luogo, in media circa 100 caratteri, che può aiutare gli utenti a ottenere un'istantanea di un luogo.
Riepiloghi delle descrizioni: riepiloghi più lunghi di un luogo, in media circa 400 caratteri, che forniscono una panoramica dettagliata degli aspetti principali di un luogo.
Al momento i riepiloghi dei luoghi sono disponibili per i tipi di luogo mostrati in Tipi supportati per le categorie Cultura, Intrattenimento e svago, Cibi e bevande, Shopping e Sport.
Riepiloghi dell'area generativa
I riepiloghi generativi dell'area vengono creati dall'LLM per l'area vicina intorno a un luogo. Il riepilogo dell'area di un luogo può contenere tutte le informazioni necessarie a un utente per prendere una decisione, senza che l'utente debba effettuare ulteriori richieste per visualizzare i dettagli dell'area.
Oltre a una descrizione dell'area, la risposta contiene anche un elenco di ID luogo per i luoghi a cui viene fatto riferimento nella descrizione e un elenco di luoghi ordinati per diversi tipi di contenuti. Ad esempio, un tipo di contenuto contiene un elenco di luoghi associati alle attività nella zona e un altro contiene un elenco di ristoranti della zona.
Al momento i riepiloghi delle aree sono disponibili per i tipi di luogo mostrati in Tipi supportati per la categoria Alloggi e per i tipi di luoghi specifici electric_vehicle_charging_station, geocode e premise.
Generazione di riepiloghi di luoghi e aree
Sia i riepiloghi generativi dei luoghi sia quelli dell'area generativa vengono generati spesso offline da Google. Generando questi riepiloghi offline, puoi sfruttare i contenuti basati su Gemini e ottenere dall'API Places (novità) le stesse prestazioni che ti aspetti.
Google rigenera frequentemente questi riepiloghi per garantire che siano aggiornati in base alle informazioni più recenti disponibili. Ciò significa che, quando chiami l'API, mostrerai i dati più aggiornati nel tuo servizio.
Risultati di ricerca contestuali
Una ricerca testuale (nuova) restituisce informazioni su un insieme di luoghi in base a una stringa, ad esempio "pizza a New York" o "negozi di scarpe vicino a Ottawa". La risposta della ricerca testuale (nuova) contiene un elenco di posizioni corrispondenti alla stringa di testo e eventuali bias di località impostati nella richiesta.
Quando aggiungi risultati di ricerca contestuali alla risposta, la risposta ora include recensioni, foto e giustificazioni che aiutano gli utenti a rispondere alle domande:
- Perché vedo questo luogo nei risultati?
- Perché dovrei scegliere questo luogo?
Ad esempio, presenti oggi una richiesta a Place Details (Nuovo), a Ricerca testuale (Nuova) o a Ricerca nelle vicinanze (Nuova) che include un luogo specifico nella risposta. I dati di risposta per il luogo sono gli stessi per tutte e tre le richieste perché i dati restituiti sono associati al luogo.
Tuttavia, per una ricerca testuale (novità) che utilizza le nuove funzionalità, la risposta può includere dati derivati dalla stringa di query di input stessa. Ciò significa che i risultati di ricerca contestuali sono univoci per la stringa di query. Ad esempio, effettui una richiesta di ricerca testuale (nuova) con la seguente stringa di query:
"Ristorante vegetariano piccante a Mountain View, CA"
Puoi quindi lasciare invariati tutti i parametri di input e modificare solo la stringa di query in:
"Ristorante vegano piccante a Mountain View, CA"
Per un ristorante visualizzato in entrambe le risposte, i dati di risposta sul luogo sono gli stessi perché sono associati al luogo stesso. Tuttavia, i risultati di ricerca contestuali sono univoci per la query perché derivano dalla stringa di query. Puoi quindi mostrare agli utenti recensioni, foto e giustificazioni provenienti dai risultati di ricerca contestuali per aiutarli a decidere quale posizione nella risposta è più adatta alla loro richiesta di ricerca.
Abilita le funzionalità del modello Gemini per l'API Places (novità)
Devi abilitare l'API Places (nuova) per utilizzare le funzionalità del modello Gemini per l'API Places (novità). Per ulteriori informazioni, consulta Configurare il progetto Google Cloud.
Limitazioni per la release sperimentale
Questa release supporta solo i riepiloghi di luoghi e aree per i luoghi degli Stati Uniti solo in inglese.
Cos'è Gemini?
Per saperne di più sul modello Gemini, consulta le Domande frequenti su Gemini.
Richiedi un riepilogo generativo del luogo
I riassunti dei luoghi sono riassunti generativi creati dall'LLM per un luogo specifico. L'API Places (Novità) aggiunge due tipi di riepiloghi a una risposta:
Riepiloghi generativi Panoramica simili al riepilogo editoriale statico associato a un luogo. I riassunti generativi brevi, in media circa 100 caratteri, offrono diversi vantaggi:
Molti luoghi non dispongono di riassunti editoriali, quindi colmano una lacuna nelle informazioni disponibili per un luogo.
Vengono generati a partire dall'LLM, quindi non è necessario che il proprietario del luogo li mantenga.
I riassunti generativi delle descrizioni derivano da molte fonti, tra cui recensioni di Google Maps. La descrizione, di circa 400 caratteri, include in media un elenco di recensioni utilizzate per generare la descrizione lunga.
Per generare manualmente i riepiloghi delle descrizioni, è necessario aggregare i dati provenienti da più località e poi creare e gestire i contenuti a mano. Le funzionalità del modello Gemini per l'API Places (novità) creano questi riassunti a partire dagli LLM per mantenere l'ambito e l'aggiornamento dei contenuti generati.
I riepiloghi dei luoghi sono supportati da Dettagli luogo (nuova), Ricerca testuale (nuova) e Ricerca nelle vicinanze (nuova). Per includere il riepilogo del luogo nella risposta, includi il seguente campo nella maschera del campo della richiesta:
Dettagli luogo:
generativeSummaryRicerca testuale e Ricerca nelle vicinanze:
places.generativeSummary
Il campo generativeSummary contiene i seguenti campi:
generativeSummary.overview: il riepilogo della panoramica generativa.generativeSummary.description: il riepilogo della descrizione generativa.generativeSummary.references: un array di massimo cinque recensioni utilizzato per fornire contenuti per il riepilogo della descrizione. Se non c'è un riepilogo della descrizione, l'array è vuoto.
Esempio di richiesta di riepilogo di panoramica
Questo esempio di ricerca testuale restituisce solo il riepilogo overview per i ristoranti vegetariani piccanti a Mountain View, CA:
curl -X POST -d '{
"textQuery": "Spicy Vegetarian Food",
"location_bias":{
"rectangle":{
"low": {
"latitude": 37.415,
"longitude": -122.091},
"high":{
"latitude": 37.429,
"longitude": -122.065}
}
},
"maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \
https://places.googleapis.com/v1/places:searchText
La risposta contiene il campo generativeSummary.overview che include overview.text e overview.languageCode:
{
"places": [
{
"id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
"displayName": {
"text": "Zareen's",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
"languageCode": "en-US"
}
}
},
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
"languageCode": "en-US"
}
}
},
. . .
}
Esempio di richiesta di riepilogo e descrizione
Questo esempio esegue la stessa query dell'esempio precedente, ma utilizza una
maschera di campo di places.generativeSummary per restituire l'intero
oggetto generativeSummary, inclusi i campi generativeSummary.overview, generativeSummary.description e generativeSummary.references:
{
"places": [
{
"id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
"displayName": {
"text": "Zareen's",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
"languageCode": "en-US"
},
"description": {
"text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
"languageCode": "en-US"
},
"references": {
"reviews": [
{
"name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
"relativePublishTimeDescription": "12 months ago",
"rating": 5,
"text": {
"text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
"languageCode": "en"
},
"originalText": {
"text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Anam Qureshi",
"uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
},
"publishTime": "2023-05-09T07:24:36Z"
},
. . .
]
}
}
},
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
},
"generativeSummary": {
"overview": {
"text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
"languageCode": "en-US"
},
. . .
}
Richiedi un riepilogo dell'area generativa
I riassunti delle aree sono riassunti generati dall'LLM per l'area circostante di un luogo. I riepiloghi delle aree possono essere importanti per la decisione degli utenti su un luogo.
Ad esempio, se stai cercando di prenotare un hotel in una nuova città e sebbene tu possa trovare un hotel che soddisfi le tue esigenze, vorresti anche saperne di più sull'area intorno all'hotel. Anziché guardare una mappa dell'area circostante per poi dover esaminare ogni luogo sulla mappa, puoi generare un riepilogo dell'area per l'hotel.
I riepiloghi delle aree sono supportati da Dettagli luogo (nuova), Ricerca testuale (nuova) e Ricerca nelle vicinanze (nuova).
Per includere il riepilogo dell'area nella risposta, includi nella maschera del campo della richiesta:
areaSummary(Dettagli luogo)places.areaSummary(Ricerca testuale e Ricerca nelle vicinanze).
Il campo areaSummary per un luogo nella risposta contiene un array di un massimo di quattro contentBlocks.
L'argomento di ogni blocco dipende dal tipo di luogo:
Per una stazione di ricarica EV, definita come luogo di tipo
electric_vehicle_charging_station, i blocchi di argomenti includono:"overview","coffee","restaurant"e"store".Per un luogo con un tipo definito dalla categoria Alloggi e i tipi di luogo specifici
geocodeepremise, i blocchi degli argomenti sono:"overview","activity","restaurant"e"store".
Esempio di richiesta di riepilogo dell'area di una stazione di ricarica EV
In questo esempio di richiesta Place Details viene restituito il riepilogo dell'area di una specifica stazione di ricarica EV a Mountain View, identificata dall'ID luogo ChIJC5b6QKiwj4ARgn2EwlnJnWU:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,areaSummary" \ https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU
La risposta contiene il campo areaSummary, incluso l'array contentBlocks:
Il campo
topicconsente di specificare il tipo di blocco di contenuti. Poiché in questo esempio si tratta di una stazione di ricarica EV, i quattro blocchi di contenuti sono"overview","coffee","restaurant"e"store".Il campo
contentinclude il riepilogo per l'argomento in questione, incluso il codice lingua.L'array
referencesspecifica i nomi delle risorse luogo, nel formatoplaces/PLACE_ID, utilizzati per fornire i contenuti per il blocco di contenuti.
{
"id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
"displayName": {
"text": "EVgo Charging Station",
"languageCode": "en"
},
"areaSummary": {
"contentBlocks": [
{
"topic": "overview",
"content": {
"text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
"places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
]
}
},
{
"topic": "coffee",
"content": {
"text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
]
}
},
{
"topic": "restaurant",
"content": {
"text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
"places/ChIJETHw0F-7j4AR85V_I6OobCI",
"places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
"places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
]
}
},
{
"topic": "store",
"content": {
"text": "Safeway provides a range of groceries, along with a deli and a bakery.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
]
}
}
]
}
}
Esempio di richiesta di riepilogo dell'area per un hotel
In questo esempio di richiesta di ricerca testuale, vengono richiesti gli hotel a Mountain View, CA:
curl -X POST -d '{
"textQuery": "Hotels",
"location_bias":{
"rectangle":{
"low": {
"latitude": 37.415,
"longitude": -122.091},
"high":{
"latitude": 37.429,
"longitude": -122.065}
}
},
"maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \
https://places.googleapis.com/v1/places:searchText
La risposta contiene il campo areaSummary, incluso l'array contentBlocks. La risposta per i luoghi di tipo hotel contiene blocchi di contenuti per
gli argomenti "overview", "activity", "restaurant" e "store":
{
"places": [
{
"id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
"displayName": {
"text": "Shashi Hotel Mountain View, an Urban Resort",
"languageCode": "en"
},
"areaSummary": {
"contentBlocks": [
{
"topic": "overview",
"content": {
"text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJOYvCo1W3j4AR1LAifgk13rs",
"places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
"places/ChIJo4za6vi5j4ARMua093RgGGA",
"places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
]
}
},
{
"topic": "activity",
"content": {
"text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJOYvCo1W3j4AR1LAifgk13rs",
"places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
"places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
]
}
},
{
"topic": "restaurant",
"content": {
"text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
"places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
"places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
]
}
},
{
"topic": "store",
"content": {
"text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
"languageCode": "en-US"
},
"references": {
"places": [
"places/ChIJh64-r0O3j4ARy1P41IH2j3k",
"places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
]
}
}
]
}
},
...
]
}
Richiedere risultati di ricerca contestuali
La risposta a una richiesta di ricerca testuale (nuova) contiene un array di posizioni che corrispondono ai criteri della stringa di ricerca di input. Ora puoi richiedere i dati della ricerca contestuale nella risposta in base alla query di input all'API.
Per supportare i riepiloghi contestuali, la risposta della Ricerca testuale (Nuova) contiene un nuovo array denominato contextualContents allo stesso livello dell'array places nella risposta:
{
"places": [],
"contextualContents":[]
}
Ogni elemento nell'array contextualContents, di tipo
ContextualContent,
si trova nella posizione dell'array corrispondente come posizione nell'array places. In altre parole, l'elemento in contextualContents[0] corrisponde al luogo in places[0].
Ogni elemento dell'array contiene i seguenti campi di array:
contextualContents.reviews: un array di massimo tre recensioni.contextualContents.photos: un array di massimo cinque foto.contextualContents.justifications: un array di giustificazioni per il luogo, tra cui:reviewJustification: evidenzia una sezione della recensione di un utente che potrebbe interessare un utente finale.businessAvailabilityAttributesJustification: include gli attributi di un'attività che potrebbero interessare a un utente finale.
Per includere i risultati di ricerca contestuali nella risposta, includi
contextualContents nella
maschera del campo
della richiesta di ricerca testuale (nuova):
curl -X POST -d '{
"textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
"openNow": true,
"maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText
La risposta contiene l'array contextualContents per ogni luogo nella
risposta:
{
"places": [
{
"id": "ChIJETHw0F-7j4AR85V_I6OobCI",
"displayName": {
"text": "Hyderabad Dum Biryani",
"languageCode": "en"
}
},
. . .
],
"contextualContents": [
{
"reviews": [
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
"relativePublishTimeDescription": "a year ago",
"rating": 5,
"text": {
"text": "Very tasty! Rich spices and textures. We really appreciated
all of the vegan options. We shared samosas (great sauce!) , tofu 65
(spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
enjoyed all of it, with the pakoras being the table's favorite.",
"languageCode": "en"
},
"originalText": {
"text": "Very tasty! Rich spices and textures. We really appreciated
all of the vegan options. We shared samosas (great sauce!) , tofu 65
(spicy!!), gobi manchurian (less flavorful but a nice sweet offset
to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
We enjoyed all of it, with the pakoras being the table's favorite.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Guillaume Riesen",
"uri": "https://www.google.com/maps/contrib/1131462893/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
},
"publishTime": "2023-04-18T02:48:02Z"
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
"relativePublishTimeDescription": "10 months ago",
"rating": 5,
"text": {
"text": "This is a nice little spot to eat at. I'm a big fan of
curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
"languageCode": "en"
},
"originalText": {
"text": "This is a nice little spot to eat at. I'm a big fan of curries,
and they are spot on when it comes to flavor and spice. I highly recommend this place.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Paul Sacks",
"uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
"photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
},
"publishTime": "2023-07-03T16:51:49Z"
},
. . .
],
"photos": [
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
"widthPx": 1920,
"heightPx": 1080,
"authorAttributions": [
{
"displayName": "A Google User",
"uri": "//maps.google.com/maps/contrib/113209927655010465422",
"photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
}
]
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
"widthPx": 960,
"heightPx": 720,
"authorAttributions": [
{
"displayName": "Toast"
}
]
},
. . .
],
"justifications": [
{
"reviewJustification": {
"highlightedText": {
"text": "\"Not too spicy or oily.\"",
"highlightedTextRanges": [
{
"startIndex": 9,
"endIndex": 14
}
]
},
"review": {
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
"relativePublishTimeDescription": "10 months ago",
"rating": 5,
"text": {
"text": "Not too spicy or oily. We have the mutton dum biryanis
and tandoori fish. Very flavorful. The food was served promptly.
Clean environment. A little small more like a hole in the wall.
We'd come back for sure.",
"languageCode": "en"
},
"originalText": {
"text": "Not too spicy or oily. We have the mutton dum biryanis
and tandoori fish. Very flavorful. The food was served promptly.
Clean environment. A little small more like a hole in the wall.
We'd come back for sure.",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "Harpal Kochar",
"uri": "https://www.google.com/maps/contrib/1166232959/reviews",
"photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
},
"publishTime": "2023-06-18T06:12:41Z"
}
}
},
{
"businessAvailabilityAttributesJustification": {
"dineIn": true
}
}
]
},
. . .
]
}
Indicazioni per l'implementazione per casi d'uso nel settore auto e motori
Per la sicurezza dei conducenti, Google consiglia di eseguire il rendering di riassunti basati sull'IA generativa in modalità parcheggiata per esperienze automobilistiche. Se i riepiloghi del rendering sono nella modalità Auto, le informazioni sullo schermo devono essere semplici, chiare e concise per garantire che l'attenzione del conducente ritorni rapidamente sulla strada.
- Non più di 3 righe
- Massimo 120 caratteri o 24 parole
- Dimensioni frontali minime di 24 dp
In particolare nei contesti automobilistici, è responsabilità dello sviluppatore trasmettere riassunti relativi all'IA generativa in modo sicuro e conforme a tutte le leggi e le normative locali.
Attribuzioni
Quando mostri recensioni, foto e riassunti basati sull'IA generativa nella tua app, inclusi i riepiloghi di luoghi e aree, devi assicurarti di mostrare anche le attribuzioni richieste.
Mostra le attribuzioni per i riassunti generativi
Quando mostri riepiloghi con l'IA generativa nella tua app, inclusi i riepiloghi di luoghi e aree, devi mostrare anche le attribuzioni necessarie. Questa sezione descrive come visualizzare le attribuzioni in base a come vengono mostrati i riepiloghi dell'IA generativa nella tua app.
In ogni caso, l'attribuzione deve utilizzare lettere maiuscole e minuscole. L'attribuzione e il logo Google devono essere conformi a tutti gli standard relativi a colore, stile e tipo di carattere. Per ulteriori informazioni su questi standard, consulta le norme per l'API Places (nuove).
Riepilogo dell'IA generativa visualizzato nel contesto di altri dati di Google
In questo caso, l'attribuzione dell'IA generativa può essere visualizzata da sola sopra o sotto il riepilogo, facendo affidamento sull'attribuzione dei contenuti da parte di Google altrove.
Per l'attribuzione, utilizza il testo "Riassunto dall'IA" come mostrato in questa immagine:
Riepilogo dell'IA generativa visualizzato in modo isolato
Quando un riassunto dell'IA generativa viene visualizzato separatamente da qualsiasi altro contenuto di Google Maps, deve includere sia l'attribuzione con l'IA generativa che l'attribuzione a Google separate da un interpuntto. Per l'attribuzione, usa il testo "Riassunto dall'IA" e il logo di Google come mostrati in questa immagine:
Riepilogo dell'IA generativa ripetuto in un elenco
Quando si ripete una panoramica di riepilogo del luogo con l'IA generativa in un elenco di luoghi, in cui:
- I contenuti dell'elenco vengono attribuiti a Google
- I riepiloghi mostrati sono creati con l'IA
- I contenuti sono disponibili su Google
L'attribuzione deve essere visualizzata sopra o sotto l'elenco su una sola riga. L'attribuzione dell'IA è allineata a sinistra, mentre quella di Google è allineata a destra:
Se in un elenco vengono utilizzati riepiloghi delle descrizioni con l'IA generativa più lunghi, ogni riepilogo deve disporre dell'attribuzione IA ("Riassunto dall'IA" con l'icona/il pulsante delle informazioni).
Mostra le informazioni su un riassunto dell'IA generativa in una finestra di dialogo
Oltre a un riepilogo con l'IA generativa, devi rendere disponibile agli utenti finali una finestra di dialogo che mostri informazioni sul riepilogo e un link per segnalare i problemi. Quando utilizzi un riepilogo della descrizione con l'IA generativa, devi includere informazioni sulle fonti del riassunto, chiamate references.
Abilita l'accesso a questa finestra di dialogo includendo un'icona delle informazioni (come offerta di interattività) insieme all'attribuzione dell'IA (come illustrato negli esempi sopra) e facendo in modo che l'area e l'icona dell'attribuzione IA rispondano a pressione o clic.
Per i riassunti generativi dei luoghi, mostra:
| Informazioni | I riepiloghi dei luoghi creati con l'IA vengono generati a partire da recensioni Google e altri dati. |
| Segnala un problema | Per segnalare a Google un problema relativo ai contenuti di un riepilogo, segui questo link. |
| Riferimenti | Recensioni delle fonti |
Ad esempio:
Per i riassunti dell'area generativa, visualizza:
| Informazioni | I riepiloghi delle aree IA vengono generati a partire da recensioni Google e dati locali. |
| Segnala un problema | Per segnalare a Google un problema relativo ai contenuti di un riepilogo, segui questo link. |
