Funzionalità del modello Gemini per l'API Places

Gemini per l'API Places (novità) supporta gli LLM l'API Places per consentirti di restituire i dati associati a un luogo (orari di apertura, recensioni, foto) oltre ai dati forniti dagli LLM. Questo i dati generativi contengono dati aggregati e riassunti degli LLM per migliorare i dati già associati a un luogo.

Ad esempio, uno standard Ricerca testuale (novità) per "Stazioni di ricarica EV" restituisce un elenco di luoghi che offrono la ricarica EV. Questo tipo di risposta va bene se cerchi soltanto il caricabatterie EV più vicino o quella più vicina compatibile con il tuo veicolo.

Ma potresti anche voler conoscere meglio l'area circostante il stazione di ricarica, soprattutto se ci si trova da un'ora o più durante la ricarica del veicolo. Quando si utilizzano le funzionalità del modello Gemini stessa ricerca, la risposta può contenere descrizioni dinamiche e generative di posto nella risposta, incluse informazioni sull'area circostante la ricarica stazione:

  • "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 ci sono diversi ristoranti e negozi tra cui Khao Kang Thai Kitchen, Roger's Deli e Ciambelle e La Costeña. Per il sushi, il Joy Sushi è una buona opzione. Per la spesa, un albero di un dollaro offre una varietà di prodotti a prezzi scontati."

Questo contenuto generativo degli LLM migliora la risposta e fornisce 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):

Riepiloghi generativi dei luoghi

I riepiloghi generativi dei luoghi sono specifici di un ID luogo. Riepiloghi dei luoghi aggregare 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 possono aiutare gli utenti a ottenere un'istantanea di un luogo.

  • Riepiloghi descrittivi: in media i riepiloghi più lunghi di un luogo. circa 400 caratteri, che forniscono una panoramica dettagliata aspetti del luogo.

I riepiloghi dei luoghi sono attualmente disponibili per i tipi di luogo mostrati in Supportato tipi di categorie Cultura, Intrattenimento e svago, Cibi e bevande, Shopping, e Sport.

Riepiloghi dell'area generativa

I riepiloghi delle aree generative vengono creati dall'LLM per l'area vicina intorno a un posto. Il riepilogo dell'area di un luogo può contenere tutte le informazioni necessarie per consentire a un utente di prendere una decisione, senza che l'utente debba effettuare ulteriori richieste per visualizzare in dettaglio l'area.

Oltre a una descrizione dell'area, la risposta contiene anche un elenco ID dei luoghi indicati nella descrizione e un elenco di luoghi ordinate in base ai diversi tipi di contenuti. Ad esempio, un tipo di contenuto contiene un elenco di luoghi associati ad attività nella zona e un'altra contiene un elenco ristoranti della zona.

I riepiloghi delle aree sono attualmente disponibili per i tipi di luogo mostrati in Tipi supportati per la categoria Alloggi, nonché i tipi di luoghi specifici electric_vehicle_charging_station, geocode e premise.

Generazione di riepiloghi di luoghi e aree

Sia i riassunti generativi dei luoghi che quelli dell'area generati offline spesso da Google. Generando questi riepiloghi offline, puoi sfruttare i contenuti di Gemini continuando a vedere le stesse prestazioni dell'API Places (Novità) che ti aspetti.

Google rigenera frequentemente questi riepiloghi per garantire che siano aggiornati in base alle informazioni più recenti disponibili. Ciò significa che visualizzerai i dati più recenti nel 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 Roma". Ricerca testuale (Nuova) risposta contiene un elenco di posizioni corrispondenti alla stringa di testo e a qualsiasi bias di località impostato nella richiesta.

Quando aggiungi risultati di ricerca contestuali alla risposta, la risposta ora includi recensioni, foto e giustificazioni che aiutino gli utenti a rispondere domande:

  • Perché vedo questo luogo nei risultati?
  • Perché dovrei scegliere questo luogo?

Ad esempio, se invii una richiesta a Place Details (Nuovo), a Ricerca testuale (Nuova) o Ricerca nelle vicinanze (nuova) oggi che include un luogo specifico nella risposta. La i dati di risposta per il luogo sono gli stessi per tutte e tre le richieste perché i dati restituiti siano associati al luogo.

Tuttavia, per una ricerca testuale (nuova) che utilizza le nuove funzionalità, la risposta può Includere i dati derivati dalla stringa di query di input stessa. Ciò significa i risultati di ricerca contestuali sono univoci per la stringa di query. Ad esempio, una richiesta 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 a:

"Ristorante vegano piccante a Mountain View, CA"

Per un ristorante che compare in entrambe le risposte, i dati delle risposte sul è lo stesso perché i dati sono associati al luogo stesso. Ma i risultati di ricerca contestuali sono univoci per la query perché derivano la stringa di query. Puoi quindi visualizzare recensioni, foto e giustificazioni dai risultati di ricerca contestuali agli utenti, per aiutarli decidere quale punto della risposta è più adatto alla 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 API Places (novità). Per ulteriori informazioni, vedi Configura 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 Stati solo in inglese.

Cos'è Gemini?

Per saperne di più sul modello Gemini, consulta la pagina Gemini Domande frequenti.

Richiedi un riepilogo generativo del luogo

I riassunti dei luoghi sono riassunti generativi creati dall'LLM per uno specifico posto. L'API Places (Novità) aggiunge due tipi di riepiloghi a una risposta:

  • Riepiloghi generativi di panoramica simili ai riassunti editoriali statici un riepilogo associato a un luogo. Riepiloghi brevi generativi, in media circa 100 caratteri, presentano diversi vantaggi:

    • Molti siti non dispongono di riassunti editoriali, quindi colmano una lacuna nella informazioni disponibili per un luogo.

    • Vengono generati dall'LLM, quindi non è necessario che il proprietario del luogo per mantenerli.

  • I riassunti generativi delle descrizioni derivano da molte fonti, incluse le recensioni di Google Maps. La descrizione, in media circa 400 include un elenco di recensioni utilizzate per generare il testo o l'audiodescrizione.

    Per generare manualmente i riepiloghi delle descrizioni, è necessario che una persona li aggrega dati provenienti da più luoghi e per poi realizzare e mantenere i contenuti a mano. 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 Place Details (Novità) (Dettagli luogo) Ricerca testuale (novità), e Ricerca nelle vicinanze (novità). Per includere il riepilogo del luogo nella risposta, includi il seguente campo nella maschera del campo della richiesta:

  • Dettagli luogo: generativeSummary

  • Ricerca testuale e Ricerca nelle vicinanze: places.generativeSummary

La generativeSummary contiene i seguenti campi:

  • generativeSummary.overview: il riepilogo della panoramica generativa.
  • generativeSummary.description: il riepilogo della descrizione generativa.
  • generativeSummary.references: una serie di massimo cinque recensioni usate per fornisci i contenuti per il riepilogo della descrizione. Se non viene fornita una descrizione questo array è vuoto.

Esempio di richiesta di riepilogo di panoramica

Questa ricerca testuale di esempio restituisce solo il riepilogo overview per le parole piccanti ristoranti vegetariani 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 il parametro 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 un parametro maschera di campo di places.generativeSummary per restituire l'intero generativeSummary, tra cui generativeSummary.overview, Campi 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 vicina di un luogo. I riepiloghi delle aree possono essere importanti per consentire agli utenti di prendere una decisione su un posto.

Ad esempio, se volete prenotare un hotel in una nuova città, potete trovare un hotel che soddisfi le tue esigenze, vorresti anche saperne di più sull'area circostante l'hotel. Invece di guardare una mappa dell'ambiente circostante di un'area specifica e poi devi esaminare ogni luogo sulla mappa, puoi generare un riepilogo dell'area per l'hotel.

I riepiloghi delle aree sono supportati da Place Details (Novità) (Dettagli luogo) Ricerca testuale (novità), e Ricerca nelle vicinanze (novità).

Per includere il riepilogo dell'area nella risposta, includi nel maschera del campo della richiesta:

  • areaSummary (Dettagli luogo)
  • places.areaSummary (Ricerca testuale e Ricerca nelle vicinanze).

La areaSummary un campo specifico di un luogo nella risposta contiene un array di massimo 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 dal Alloggi categoria e i tipi di luogo specifici geocode e premise, l'argomento i blocchi includono: "overview", "activity", "restaurant" e "store".

di Gemini Advanced.

Esempio di richiesta di riepilogo dell'area di una stazione di ricarica EV

Questa richiesta Dettagli luogo di esempio restituisce il riepilogo dell'area per un EV specifico stazione di ricarica di 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 contentBlocks array:

  • Il campo topic consente di specificare il tipo di blocco di contenuti. Poiché il luogo in questo esempio una stazione di ricarica EV, i quattro blocchi di contenuti "overview", "coffee", "restaurant" e "store".

  • Il campo content include il riepilogo per quell'argomento, tra cui del linguaggio naturale.

  • L'array references specifica i nomi delle risorse dei luoghi, nel formato places/PLACE_ID, utilizzata per fornire contenuti per il blocco dei 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 contentBlocks un array di dati. La risposta per i luoghi di tipo hotel contiene blocchi di contenuti per la 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 un Ricerca testuale (novità) contiene un array di posizioni che corrispondono ai criteri della ricerca di input stringa. Ora puoi richiedere i dati della ricerca contestuale nella risposta in base al una query di input all'API.

Per supportare i riepiloghi contestuali, la risposta da Ricerca testuale (novità) contiene un nuovo array denominato contextualContents allo stesso livello del Array places nella risposta:

{
  "places": [],
  "contextualContents":[]
}

Ogni elemento dell'array contextualContents, di tipo ContextualContent, è nella posizione dell'array corrispondente come la posizione nell'array places. Questo è che 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 un sezione di una recensione di un utente che potrebbe interessare un utente finale.
    • businessAvailabilityAttributesJustification: Include gli attributi di un'attività che potrebbe essere interessante per un obiettivo utente.

Per includere i risultati di ricerca contestuali nella risposta, includi contextualContents in maschera del 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 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 riepiloghi dall'IA generativa in modalità di parcheggio per esperienze automobilistiche. Se visualizzi i riepiloghi in modalità Auto, le informazioni sullo schermo devono essere semplici, chiare e concise per garantire l'attenzione del conducente torna rapidamente sulla strada.

  • Non più di 3 righe
  • Massimo 120 caratteri o 24 parole
  • Dimensioni frontali minime di 24 dp

Nello specifico, in contesti automobilistici, è responsabilità dello sviluppatore eseguire il rendering dei riassunti creati con l'IA generativa in modo sicuro e conforme a tutti leggi e normative locali.

Attribuzioni

Quando mostri recensioni, foto e riepiloghi con l'IA generativa nella tua app, inclusi i riepiloghi dei luoghi e delle aree, devi assicurarti di visualizzare anche le attribuzioni richieste.

Mostra le attribuzioni per i riassunti generativi

Quando mostri riepiloghi con l'IA generativa nella tua app, inclusi luogo e area riepiloghi, devi anche visualizzare le attribuzioni necessarie. Questa sezione descrive come visualizzare le attribuzioni in base a come viene mostrata l'IA generativa i riepiloghi nella tua app.

In ogni caso, l'attribuzione deve utilizzare lettere maiuscole e minuscole. L'attribuzione e Il logo Google deve essere conforme a tutti gli standard relativi a colore, stile e tipo di carattere. Per ulteriori informazioni informazioni su questi standard, consulta Norme 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:

Per l'attribuzione, utilizza il testo Riassunto dall'IA.

Riepilogo dell'IA generativa visualizzato in modo isolato

Quando un riassunto dell'IA generativa viene mostrato isolatamente da qualsiasi altro contenuto da Google Maps, deve includere sia l'attribuzione all'IA generativa che l'attribuzione Google separate da un interpuntto. Per l'attribuzione, utilizza il testo "Riassunto dall'IA" e il logo di Google come mostrato in questa immagine:

Per il riepilogo visualizzato in modo isolato, includi l'attribuzione basata sull'IA generativa e Attribuzione di Google separata da un interpuntto.

Riepilogo dell'IA generativa ripetuto in un elenco

Quando si ripete un'IA generativa una panoramica di riepilogo dei luoghi in un elenco di luoghi, dove tutti:

  • 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 allineamento a destra:

Per un elenco, mostra l'attribuzione sopra o sotto l'elenco su una singola riga.

Se riassunti delle descrizioni creati con l'IA generativa in formato più lungo vengono utilizzati in un elenco, ogni riassunto deve includere l'attribuzione ("Riassunto dall'IA" con l'icona/pulsante delle informazioni).

Mostra le informazioni su un riassunto dell'IA generativa in una finestra di dialogo

Insieme a un riassunto con l'IA generativa, devi rendere disponibile una finestra di dialogo per terminare utenti che visualizzano informazioni sul riepilogo e un link per segnalare i problemi. Quando si utilizza un'IA generativa riepilogo della descrizione, devi includere informazioni sulle fonti del riepilogo, denominate riferimenti.

Consenti l'accesso a questa finestra di dialogo includendo un'icona delle informazioni (come interattività offerta) insieme all'attribuzione dell'IA (come illustrato sopra esempi) e fare in modo che l'area e l'icona di attribuzione dell'IA rispondano a un premi o fai clic.

Per i riassunti generativi dei luoghi, mostra:

Informazioni I riepiloghi dei luoghi creati dall'IA vengono generati a partire da recensioni Google e da altri e i dati di Google Cloud.
Segnala un problema Per segnalare a Google un problema relativo ai contenuti di un riepilogo: segui questo link.
Riferimenti Recensioni delle fonti

Ad esempio:

Visualizza le informazioni su un riassunto dell'IA generativa in una finestra di dialogo.

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.

Attribuzione riepilogo dell'area di visualizzazione.