Le funzionalità del modello Gemini per l'API Places (novità) offrono il supporto degli LLM all'API Places, in modo da poter 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 di testo (nuova) standard per "stazioni di ricarica EV" restituisce un elenco di luoghi che offrono la ricarica EV. Questo tipo di risposta è adatto se stai cercando solo la stazione di ricarica EV più vicina o quella più vicina compatibile con il tuo veicolo.
Potresti anche voler conoscere meglio la zona intorno alla stazione di ricarica, soprattutto se prevedi di rimanere lì per un'ora o più mentre il veicolo si ricarica. Quando utilizzi le funzionalità del modello Gemini per la stessa ricerca, la risposta può contenere descrizioni dinamiche e generative di ogni luogo nella risposta, incluse informazioni sull'area intorno alla stazione di ricarica:
"A 2-4 minuti a piedi ci sono diversi ristoranti e negozi, tra cui Chef Chu's, Gen Korean 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 di ristoro e negozi, tra cui Khao Kang Thai Kitchen, Roger's Deli & Donuts e La Costeña. Per il sushi, Joy Sushi è una buona opzione. Per quanto riguarda i generi alimentari, Dollar Tree offre una vasta gamma di prodotti a prezzi scontati".
Questi contenuti generativi degli LLM migliorano la risposta e forniscono informazioni aggiuntive 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):
Riassunti generativi dei luoghi correlati a un luogo specifico. I riepiloghi dei luoghi sono supportati da Place Details (versione nuova), Ricerca di testo (versione nuova), e Ricerca nelle vicinanze (versione nuova).
Riassunti generativi delle aree correlati a una area specifica intorno a un luogo. I riepiloghi delle aree sono supportati da Dettagli dei luoghi (novità), Ricerca di testo (novità) e Ricerca nelle vicinanze (novità).
I risultati della ricerca contestuale sono supportati dalla ricerca di testo (nuova) e contengono dati basati sulla stringa di ricerca passata nella richiesta anziché su quelli direttamente associati a un luogo. Questi dati aiutano a capire in che modo la ricerca di testo (nuova) determina la risposta.
Riepiloghi generativi dei luoghi
I riepiloghi dei luoghi generativi sono specifici per un ID luogo. I riepiloghi dei luoghi aggregano molti tipi diversi di dati in un unico riepilogo per il luogo.
L'API Places (nuova) fornisce due tipi di riepiloghi generativi dei luoghi:
Riassunti della panoramica: breve panoramica di un luogo, in media di circa 100 caratteri, che può aiutare gli utenti a farsi un'idea di un luogo.
Riassunti della descrizione: riepiloghi più lunghi di un luogo, in media circa 400 caratteri, che forniscono una panoramica dettagliata che copre gli aspetti principali del luogo.
I riepiloghi dei luoghi sono attualmente disponibili per i tipi di luoghi indicati in Tipi supportati per le categorie Cultura, Intrattenimento e svago, Cibo e bevande, Shopping e Sport.
Riepiloghi delle aree generativi
I riepiloghi delle aree generativi vengono creati dall'LLM per l'area nelle vicinanze di un luogo. Il riepilogo dell'area di un luogo potrebbe contenere tutte le informazioni necessarie per consentire a un utente di prendere una decisione, senza che 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 si fa riferimento nella descrizione e un elenco di luoghi ordinati in base a diversi tipi di contenuti. Ad esempio, un tipo di contenuti contiene un elenco di luoghi associati alle attività nella zona, mentre un altro contiene un elenco di ristoranti nella zona.
I riepiloghi delle aree sono attualmente disponibili per i tipi di località mostrati in
Tipi supportati
per la categoria Alloggi, nonché per i tipi di località specifici
electric_vehicle_charging_station, geocode e premise.
Generazione di riepiloghi di luoghi e aree
Sia i riepiloghi dei luoghi generativi sia i riepiloghi delle aree generativi vengono frequentemente generati offline da Google. Generando questi riepiloghi offline, puoi usufruire dei contenuti basati su Gemini, mantenendo al contempo lo stesso rendimento dell'API Places (nuova) che già prevedi.
Google rigenera spesso questi riepiloghi per assicurarsi che siano aggiornati in base alle informazioni più recenti disponibili. Ciò significa che quando chiami l'API, verranno visualizzati i dati più recenti nel tuo servizio.
Risultati di ricerca contestuale
Una ricerca di testo (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 di Text Search (Nuova) contiene un elenco di luoghi corrispondenti alla stringa di testo e a eventuali bias di località impostati nella richiesta.
Quando aggiungi i risultati di ricerca contestuale alla risposta, ora la risposta 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, oggi invii una richiesta a Dettagli dei luoghi (novità), Ricerca di testo (novità) o Ricerca nelle vicinanze (novità) 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 a quel luogo.
Tuttavia, per una ricerca di testo (nuova) che utilizza le nuove funzionalità, la risposta può includere i dati ricavati dalla stringa di query inserita stessa. Ciò significa che i risultati di ricerca contestuale sono specifici della stringa di query. Ad esempio, effettui una richiesta di ricerca di testo (nuova) con la seguente stringa di query:
"Ristorante vegetariano piccante a Mountain View, California"
Lascia tutti i parametri di input invariati e modifica solo la stringa di query in modo da:
"Ristorante vegano piccante a Mountain View, California"
Per un ristorante che compare in entrambe le risposte, i dati della risposta relativi al luogo sono gli stessi perché sono associati al luogo stesso. I risultati della ricerca contestuale sono invece specifici della query perché derivano dalla stringa di query. Puoi quindi mostrare ai tuoi utenti le recensioni, le foto e le giustificazioni dei risultati di ricerca contestuale per aiutarli a decidere quale luogo nella risposta è più applicabile alla loro richiesta di ricerca.
Abilitare le funzionalità del modello Gemini per l'API Places (novità)
Per utilizzare le funzionalità del modello Gemini per l'API Places (nuova), devi abilitare l'API Places (nuova). Per ulteriori informazioni, consulta Configurare il progetto Google Cloud.
Limitazioni per la versione sperimentale
Questa release supporta solo i riepiloghi di luoghi e aree per i luoghi negli Stati Uniti in inglese.
Cos'è Gemini?
Per scoprire di più sul modello Gemini, consulta le domande frequenti su Gemini.
Richiedere un riepilogo generativo dei luoghi
I riepiloghi dei luoghi sono riepiloghi generativi creati dall'LLM per un luogo specifico. L'API Places (nuova) aggiunge due tipi di riepiloghi a una risposta:
Riepiloghi generativi di Panoramica simili al riepilogo redazionale statico associato a un luogo. I brevi riepiloghi generativi, in media di circa 100 caratteri, presentano diversi vantaggi:
Molti luoghi non hanno riepiloghi redazionali, quindi colmano una lacuna nelle informazioni disponibili per un luogo.
Poiché vengono generati dall'LLM, il proprietario del luogo non deve gestirli.
I riepiloghi generativi della descrizione provengono da molte fonti, tra cui le recensioni di Google Maps. La descrizione, in media di circa 400 caratteri, include un elenco di recensioni utilizzate per generare la descrizione lunga.
Per generare manualmente i riepiloghi delle descrizioni, è necessario che una persona aggreghi i dati provenienti da molte località, poi li scriva e li gestisca. Le funzionalità del modello Gemini per l'API Places (novità) generano questi riepiloghi dall'LLM per mantenere l'ambito e l'aggiornamento dei contenuti generati.
I riepiloghi dei luoghi sono supportati da Place Details (versione nuova), Ricerca di testo (versione nuova), e Ricerca nelle vicinanze (versione nuova). Per includere il riepilogo del luogo nella risposta, includi il seguente campo nella maschera di campo della richiesta:
Place Details:
generativeSummaryRicerca di testo 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 è presente un riepilogo della descrizione, questo array è vuoto.overviewFlagContentUri: un link tramite il quale gli utenti possono segnalare un problema con il riepilogo della panoramica.descriptionFlagContentUri: un link tramite il quale gli utenti possono segnalare un problema con il riepilogo della descrizione.
Esempio di richiesta di riepilogo di panoramica e descrizione
Questo esempio utilizza una maschera di campo places.generativeSummary per restituire l'intero oggetto generativeSummary, inclusi i campi generativeSummary.overview, generativeSummary.description e generativeSummary.references:
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" \
https://places.googleapis.com/v1/places:searchText
La risposta è nel seguente formato:
{
"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": "John Smith",
"uri": "https://www.google.com/maps/contrib/11685942231/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
},
"publishTime": "2023-05-09T07:24:36Z"
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
},
. . .
]
},
"overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
"descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
}
},
{
"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"
},
. . .
}Esempio di richiesta di riepilogo della panoramica
Questo esempio di ricerca di testo restituisce solo il riepilogo overview dei ristoranti vegetariani piccanti a Mountain View, in California:
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"
}
}
},
. . .
}Richiedere un riepilogo delle aree generative
I riepiloghi delle aree sono riepiloghi generativi creati dall'LLM per l'area adiacente di un luogo. I riepiloghi delle aree possono essere importanti per gli utenti che devono prendere una decisione su un luogo.
Ad esempio, stai cercando di prenotare un hotel in una nuova città e, anche se riesci a trovare un hotel che soddisfa i tuoi requisiti, vorresti saperne di più sulla zona circostante. Anziché guardare una mappa dell'area circostante e dover esaminare ogni luogo sulla mappa, puoi generare un riepilogo dell'area per l'hotel.
I riepiloghi delle aree sono supportati da Dettagli dei luoghi (novità), Ricerca di testo (novità) e Ricerca nelle vicinanze (novità).
Per includere il riepilogo dell'area nella risposta, includi nella maschera di campo della richiesta:
areaSummary(Dettagli dei luoghi)places.areaSummary(ricerca di testo e ricerca nelle vicinanze).
Il
areaSummary
campo per un luogo nella risposta contiene il campo flagContentUri che puoi
utilizzare per segnalare contenuti inappropriati in modo che Google possa rimuoverli. Contiene inoltre un array di massimo quattro
contentBlocks.
L'argomento di ogni blocco si basa sul 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 Alloggio e dai tipi di luoghi specifici
geocodeepremise, i blocchi di argomenti includono:"overview","activity","restaurant"e"store".
Esempio di richiesta di riepilogo dell'area di una stazione di ricarica EV
Questo esempio di richiesta Places Details restituisce il riepilogo dell'area per una stazione di ricarica EV specifica a Mountain View, identificata dall'ID luogoChIJC5b6QKiwj4ARgn2EwlnJnWU:
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
topicspecifica il tipo di blocco di contenuti. Poiché il luogo in questo esempio è una stazione di ricarica EV, i quattro blocchi di contenuti sono"overview","coffee","restaurant"e"store".Il campo
contentinclude il riepilogo dell'argomento, incluso il codice lingua.L'array
referencesspecifica i nomi delle risorse dei luoghi, nel formatoplaces/PLACE_ID, utilizzati per fornire 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"
]
}
}
],
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
}
}Esempio di richiesta di riepilogo dell'area per un hotel
Questa richiesta di ricerca di testo di esempio richiede hotel a Mountain View, in California:
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" ] } } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12" } }, ... ] }
Richiedere risultati di ricerca contestuale
La risposta a una richiesta di ricerca di testo (nuova) contiene un array di luoghi che corrispondono ai criteri della stringa di ricerca inserita. Ora puoi richiedere i dati di ricerca contestuale nella risposta in base alla query di input all'API.
Per supportare i riepiloghi contestuali, la risposta della ricerca di testo (nuova) contiene un nuovo array denominato contextualContents allo stesso livello dell'array places nella risposta:
{
"places": [],
"contextualContents":[]
}Ogni elemento dell'array contextualContents, di tipo
ContextualContent,
si trova nella posizione dell'array corrispondente a quella dell'array places.
ovvero l'elemento in contextualContents[0] corrisponde al luogo in
places[0].
Ogni elemento dell'array contiene i seguenti campi dell'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 di una recensione dell'utente che potrebbe essere di interesse per un utente finale.businessAvailabilityAttributesJustification: include gli attributi di un'attività che potrebbero essere di interesse per un utente finale.
Per includere i risultati di ricerca contestuale nella risposta, includi
contextualContents nella
maschera di campo
della richiesta di ricerca di testo (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": "Jane Doe",
"uri": "https://www.google.com/maps/contrib/113193/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
},
"publishTime": "2023-04-18T02:48:02Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
"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": "Bob Jones",
"uri": "https://www.google.com/maps/contrib/11034435/reviews",
"photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
},
"publishTime": "2023-07-03T16:51:49Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
},
. . .
],
"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/113010465422",
"photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
}
],
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
},
{
"name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
"widthPx": 960,
"heightPx": 720,
"authorAttributions": [
{
"displayName": "Toast"
}
],
"flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
},
. . .
],
"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": "Stan Davis",
"uri": "https://www.google.com/maps/contrib/112959/reviews",
"photoUri": "https://lh3.googleuser-cc-rp-mo"
},
"publishTime": "2023-06-18T06:12:41Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
"googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
}
}
},
{
"businessAvailabilityAttributesJustification": {
"dineIn": true
}
}
]
},
. . .
]
}Indicazioni per l'implementazione dei casi d'uso nel settore auto e motori
Per la sicurezza del conducente, Google consiglia di eseguire il rendering dei riepiloghi dell'IA generativa in modalità parcheggiata per le esperienze nel settore auto e motori. Se vengono visualizzati riepiloghi in modalità di guida, le informazioni sullo schermo devono essere semplici, chiare e concise per garantire che l'attenzione del conducente ritorni rapidamente alla strada.
- Non più di 3 righe
- Massimo 120 caratteri o 24 parole
- Dimensioni minime anteriori di 24 dp
Soprattutto in contesti automobilistici, è responsabilità dello sviluppatore generare riepiloghi dell'IA generativa in modo sicuro e conforme a tutte le leggi e normative locali.
Attribuzioni
Quando mostri recensioni, foto e riepiloghi dell'IA generativa nella tua app, inclusi i riepiloghi di luoghi e aree, devi assicurarti di mostrare anche le attribuzioni richieste.
Mostrare le attribuzioni per i riepiloghi generativi
Quando mostri riepiloghi dell'IA generativa nella tua app, inclusi i riepiloghi di luoghi e aree, devi anche mostrare le attribuzioni necessarie. Questa sezione descrive come visualizzare le attribuzioni in base alla modalità di visualizzazione dei riepiloghi dell'IA generativa nella tua app.
In tutti i casi, l'attribuzione deve utilizzare la lettera maiuscola a inizio frase. L'attribuzione e il logo Google devono essere conformi a tutti gli standard di colore, stile e tipo di carattere. Per ulteriori informazioni su questi standard, consulta le norme per l'API Places (nuova).
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 singolarmente
Quando un riepilogo dell'IA generativa viene visualizzato separatamente da altri contenuti di Google Maps, deve includere sia l'attribuzione all'IA generativa sia l'attribuzione a Google, separate da un interpunct. Per l'attribuzione, utilizza il testo "Riassunto dall'IA" e il logo di Google come mostrato in questa immagine:
Riepilogo dell'IA generativa ripetuto in un elenco
Quando ripeti una panoramica del riepilogo dei luoghi dell'IA generativa in un elenco di luoghi, in cui tutti:
- I contenuti dell'elenco sono 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 in una riga singola. L'attribuzione AI è allineata a sinistra e l'attribuzione Google è allineata a destra:
Se in un elenco vengono utilizzati riepiloghi delle descrizioni con formato più lungo creati con l'IA generativa, ogni riepilogo deve avere l'attribuzione dell'IA ("Riassunto dall'IA" con l'icona/il pulsante Informazioni).
Mostrare informazioni su un riepilogo dell'IA generativa in una finestra di dialogo
Oltre a un riepilogo dell'IA generativa, devi rendere disponibile per gli utenti finali una finestra di dialogo che mostri informazioni sul riepilogo e un link per segnalare i problemi utilizzando l'identificatore univoco del riepilogo contenuto nel campo flagContentUri. Quando utilizzi un riepilogo della descrizione con l'IA generativa, devi includere informazioni sulle fonti del riepilogo, chiamate riferimenti.
Consenti l'accesso a questa finestra di dialogo includendo un'icona informativa (come prompt di interattività) insieme all'attribuzione AI (come mostrato negli esempi precedenti) e facendo in modo che l'area e l'icona di attribuzione AI rispondano a un pulsante/clic.
Per i riepiloghi dei luoghi generativi, mostra:
| Informazioni | I riepiloghi dei luoghi creati con l'IA vengono generati dalle recensioni di Google e da altri dati. |
| Segnala un problema | Per segnalare a Google un problema relativo ai contenuti di un riepilogo, utilizza il
link contenuto nel
campo
flagContentUri. |
| Riferimenti | Revisione delle fonti |
Ad esempio:
Per i riepiloghi delle aree generative, mostra:
| Informazioni | I riepiloghi delle aree creati con l'IA vengono generati dalle recensioni di Google e dai dati locali. |
| Segnala un problema | Per segnalare a Google un problema relativo ai contenuti di un riepilogo, utilizza il
link contenuto nel
campo
flagContentUri. |
