Le funzionalità del modello Gemini per l'API Places (Novità) supportano gli LLM nell'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 riepilogati 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 è ideale se stai solo cercando il caricabatterie EV più vicino o quello più vicino compatibile con il tuo veicolo.
Tuttavia, potresti anche voler conoscere meglio l'area circostante la stazione di ricarica, in particolare se rimarrai sul posto per un'ora o più durante la ricarica del veicolo. 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 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 si trovano diversi ristoranti 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 la spesa, Dollar Tree offre una varietà di prodotti a prezzi scontati."
Questo contenuto generativo degli LLM migliora la risposta e fornisce 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 (nuova) dell'API Places:
Riepiloghi generativi dei luoghi correlati a un luogo specifico. I riepiloghi dei luoghi sono supportati da Dettagli luogo (nuovo), Ricerca testuale (nuova) e Ricerca nelle vicinanze (nuova).
Riepiloghi generativi delle aree correlati a una specifica area intorno a un luogo. I riepiloghi delle aree sono supportati da Dettagli luogo (nuovo), 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é dati direttamente associati a un luogo. Questi dati aiutano a capire in che modo Ricerca testuale (Nuova) determina la risposta.
Riepiloghi generativi dei luoghi
I riepiloghi generativi dei luoghi 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 (Novità) fornisce due tipi di riassunti generativi dei luoghi:
Riepiloghi della panoramica: breve panoramica di un luogo, in media circa 100 caratteri, che può aiutare gli utenti a farsi 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 del luogo.
I riepiloghi dei luoghi sono attualmente disponibili per i tipi di luogo mostrati in Tipi supportati per le categorie Cultura, Intrattenimento e tempo libero, Cibo e bevande, Shopping e Sport.
Riepiloghi delle aree generative
I riepiloghi delle aree generative vengono creati dall'LLM per l'area nelle vicinanze intorno a un luogo. Il riepilogo dell'area di un luogo potrebbe contenere tutte le informazioni necessarie affinché un utente possa 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 indicati 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, mentre un altro contiene un elenco di ristoranti della zona.
Al momento, i riepiloghi delle aree sono disponibili per i tipi di luogo mostrati nella sezione Tipi supportati per la categoria Alloggio, nonché per i tipi specifici di luoghi electric_vehicle_charging_station, geocode e premise.
Generazione di riepiloghi di luoghi e aree
Sia i riassunti generativi dei luoghi che i riassunti dell'area generativa vengono generati spesso offline da Google. Generando questi riepiloghi offline, puoi sfruttare i contenuti forniti da Gemini continuando a usufruire delle stesse prestazioni dell'API Places (Novità) che già ti aspetti.
Google rigenera spesso questi riepiloghi per garantire che siano aggiornati in base alle informazioni disponibili più recenti. Ciò significa che verranno visualizzati i dati più recenti nel tuo servizio quando chiami l'API.
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 Ricerca testuale (Nuova) contiene un elenco di posizioni corrispondenti alla stringa di testo e qualsiasi bias di località impostato 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, oggi invii una richiesta a Dettagli luogo (Nuovo), Ricerca testuale (Nuova) o 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 a quel luogo.
Tuttavia, per una ricerca testuale (nuova) 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 contestuale sono univoci per la stringa di query. Ad esempio, crei una richiesta Ricerca testuale (Nuova) con la seguente stringa di query:
"Ristorante vegetariano piccante a Mountain View, CA"
Lascia quindi tutti i parametri di input invariati e modifica solo la stringa di query in:
"Ristorante vegano piccante a Mountain View, California"
Per un ristorante visualizzato in entrambe le risposte, i dati delle risposte relative al luogo sono gli stessi perché sono associati al luogo stesso. Tuttavia, i risultati di ricerca contestuale sono univoci per la query perché derivano dalla stringa di query. Puoi quindi mostrare agli utenti recensioni, foto e giustificazioni dai risultati di ricerca contestuale 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 (Novità) per utilizzare le funzionalità del modello Gemini per l'API Places (Novità). Per maggiori informazioni, consulta Configurare il progetto Google Cloud.
Limitazioni per la release sperimentale
Questa versione supporta solo i riepiloghi di luoghi e aree per luoghi negli Stati Uniti solo in inglese.
Cos'è Gemini?
Per informazioni sul modello Gemini, consulta le Domande frequenti su Gemini.
Richiedere un riassunto generativo di un luogo
I riepiloghi dei luoghi sono riassunti generativi creati dall'LLM per un luogo specifico. L'API Places (Novità) consente di aggiungere due tipi di riepiloghi a una risposta:
Panoramica riassunti generativi simili al riassunto editoriale statico associato a un luogo. I brevi riassunti generativi, con una media di 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 dall'LLM, quindi non è necessario che il proprietario li gestisca.
I riassunti generativi delle descrizioni derivano da molte fonti, tra cui le recensioni di Google Maps. La descrizione, di circa 400 caratteri in media, include un elenco di recensioni utilizzate per generare la descrizione lunga.
Per generare riassunti delle descrizioni manualmente, è necessario che una persona aggrega i dati provenienti da molte località e poi li crea e li gestisce. Le funzionalità del modello Gemini per l'API Places (Novità) creano questi riepiloghi dagli LLM per mantenere l'ambito e l'aggiornamento dei contenuti generati.
I riepiloghi dei luoghi sono supportati da Dettagli luogo (nuovo), Ricerca testuale (nuova) e Ricerca nelle vicinanze (nuova). Per includere il riepilogo del luogo nella risposta, includi il seguente campo nella maschera di 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 è presente un riepilogo della descrizione, questo array è vuoto.
Esempio di richiesta di riepilogo per una panoramica
Questo esempio di ricerca testuale restituisce solo il riepilogo overview per i ristoranti vegetariani speziati 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"
}
}
},
. . .
}
Panoramica di esempio e richiesta di riepilogo della descrizione
Questo esempio esegue la stessa query mostrata nell'esempio precedente, ma utilizza una maschera di campo 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 riepiloghi delle aree sono riassunti generativi creati dall'LLM per l'area nelle vicinanze di un luogo. I riepiloghi delle aree possono essere importanti per gli utenti che devono prendere decisioni riguardo a un luogo.
Ad esempio, se vuoi prenotare un hotel in una nuova città, puoi trovare un hotel che soddisfi i tuoi requisiti, ma vorresti anche saperne di più sulla zona nei dintorni. Anziché guardare una mappa dell'area circostante e dover analizzare ogni luogo sulla mappa, puoi generare un riepilogo dell'area per l'hotel.
I riepiloghi delle aree sono supportati da Dettagli luogo (nuovo), Ricerca testuale (nuova) e Ricerca nelle vicinanze (nuova).
Per includere il riepilogo dell'area nella risposta, includi la maschera di campo della richiesta:
areaSummary(dettagli del luogo)places.areaSummary(Ricerca testuale e Ricerca nelle vicinanze).
Il campo areaSummary per una posizione nella risposta contiene 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 dell'argomento includono:"overview","coffee","restaurant"e"store".Per un luogo di un tipo definito dalla categoria Alloggio e i tipi specifici di luogo
geocodeepremise, i blocchi degli argomenti includono:"overview","activity","restaurant"e"store".
Esempio di richiesta di riepilogo dell'area di una stazione di ricarica EV
Questo esempio di richiesta Dettagli luogo restituisce il riepilogo dell'area per una stazione di ricarica EV specifica 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 quell'argomento, incluso il codice lingua.L'array
referencesspecifica i nomi delle risorse di 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 contestuale
La risposta a una richiesta Text Search (New) contiene un array di luoghi che corrispondono ai criteri della stringa di ricerca di input. Ora puoi richiedere dati di ricerca contestuale nella risposta in base alla query di input all'API.
Per supportare i riepiloghi contestuali, la risposta di Ricerca testuale (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 come posizione nell'array places. Vale a dire che l'elemento in contextualContents[0] corrisponde alla posizione all'indirizzo 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 della recensione di un utente che potrebbe essere di interesse per un utente finale.businessAvailabilityAttributesJustification: include gli attributi di un'attività che potrebbero interessare un utente finale.
Per includere i risultati della ricerca contestuale nella risposta, includi
contextualContents nella
maschera di campo
della richiesta 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 posizione 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 i casi d'uso del settore auto e motori
Per la sicurezza del conducente, Google consiglia di eseguire il rendering dei riepiloghi con IA generativa in modalità parcheggiata per le esperienze in auto. Se esegui il rendering dei riepiloghi in modalità Auto, le informazioni sullo schermo devono essere semplici, chiare e concise per fare in modo che l'attenzione del conducente ritorni rapidamente sulla strada.
- Non più di 3 righe
- Massimo 120 caratteri o 24 parole
- Dimensione minima del fronte di 24 dp
Soprattutto in contesti automobilistici, è responsabilità dello sviluppatore visualizzare riepiloghi di IA generativa in modo sicuro e conforme a tutte le leggi e normative locali.
Attribuzioni
Quando nella tua app mostri recensioni, foto e riepiloghi di IA generativa, inclusi i riepiloghi di luoghi e aree, devi assicurarti di visualizzare anche le attribuzioni richieste.
Attribuzioni display per riassunti generativi
Quando mostri riepiloghi di IA generativa nella tua app, inclusi riepiloghi di luoghi e aree, devi visualizzare anche le attribuzioni necessarie. Questa sezione descrive come visualizzare le attribuzioni in base a come visualizzi i riepiloghi dell'IA generativa nella tua app.
In tutti i casi, l'attribuzione deve utilizzare lettere maiuscole e minuscole. L'attribuzione e il logo Google devono essere conformi a tutti gli standard in materia di colori, stili e caratteri. Per ulteriori informazioni su questi standard, consulta la pagina Criteri per l'API Places (novità).
Riepilogo dell'IA generativa visualizzato nel contesto di altri dati di Google
In questo caso, l'attribuzione dell'IA generativa può essere mostrata da sola sopra o sotto il riepilogo, basandosi 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 isolatamente
Quando un riepilogo con l'IA generativa viene visualizzato separatamente dagli altri contenuti di Google Maps, deve includere l'attribuzione dell'IA generativa e quella a Google separate da un interpunto. Per l'attribuzione, usa il testo "Riassunto dall'IA" e il logo di Google come mostrato in questa immagine:
Riepilogo dell'IA generativa ripetuto in un elenco
Quando si ripete una panoramica di riepilogo dei luoghi con l'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 da Google
L'attribuzione deve essere mostrata sopra o sotto l'elenco su un'unica riga. L'attribuzione dell'IA è allineata a sinistra e l'attribuzione di Google è allineata a destra:
Se in un elenco vengono utilizzati riepiloghi delle descrizioni di IA generativa più lunghi, ogni riepilogo deve avere l'attribuzione dell'IA ("Riassunto dall'IA" con l'icona/il pulsante delle informazioni).
Visualizza le informazioni su un riepilogo con l'IA generativa in una finestra di dialogo
Oltre a un riepilogo dell'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 delle descrizioni con l'IA generativa, devi includere informazioni sulle origini del riepilogo, denominate references.
Abilita l'accesso a questa finestra di dialogo includendo un'icona di informazioni (come affinità di interattività) insieme all'attribuzione dell'IA (come illustrato negli esempi precedenti) e facendo in modo che l'area e l'icona di attribuzione IA rispondano a una stampa/clic.
Per i riepiloghi generativi dei luoghi, visualizza:
| Informazioni | I riepiloghi dei luoghi creati dall'IA sono generati dalle recensioni Google e da altri dati. |
| Segnala un problema | Per segnalare a Google un problema relativo ai contenuti di un riepilogo, segui questo link. |
| Riferimenti | Recensioni fonte |
Ad esempio:
Per i riepiloghi generativi delle aree, mostra:
| Informazioni | I riepiloghi delle aree di IA sono generati dalle recensioni Google e dai dati locali. |
| Segnala un problema | Per segnalare a Google un problema relativo ai contenuti di un riepilogo, segui questo link. |
