Linee guida per l'attribuzione del testo degli strumenti dell'agente Maps Experience

Questa pagina fornisce i requisiti e le linee guida per l'attribuzione per la visualizzazione dei contenuti dei tool agentici di Maps Experience nelle tue applicazioni. I requisiti si applicano a tutti i risultati, inclusi i riepiloghi con approfondimenti dalle recensioni, i risultati relativi a percorsi e deviazioni e i dati su meteo, qualità dell'aria e pollini.

Informare l'utente sull'utilizzo delle fonti di Google Maps

Con ogni risultato dei tool agentici di Maps Experience, ricevi un messaggio Attribution che supporta la risposta:

• search_places: places[].attribution
• search_along_route: results[].place.attribution
• compute_routes: routes[].attribution
• lookup_weather: weather.attribution, airQuality.attribution e pollen.attribution (o attribution di primo livello per le richieste di informazioni meteo legacy)

Ogni messaggio Attribution restituisce i seguenti metadati:

• title: il titolo specifico da visualizzare per la fonte.
• url: l'URL utilizzato per reindirizzare gli utenti a Google Maps o alla Ricerca Google per visualizzare il materiale di origine, se applicabile.

Quando presenti i risultati dei tool agentici di Maps Experience, devi specificare le fonti di Google Maps associate e soddisfare i seguenti requisiti:

• Le fonti di Google Maps devono seguire immediatamente i contenuti generati che supportano. Questi contenuti generati sono anche chiamati risultato dei tool agentici di Maps Experience.
• Le fonti di Google Maps devono essere visualizzabili con una sola interazione dell'utente.

Per interfacce basate sulle funzioni vocali

Sourcing: le fonti di Google Maps devono essere visualizzate in una UI complementare che mostri un registro storico testuale di qualsiasi conversazione vocale con l'AI. Questo record deve seguire i requisiti di approvvigionamento ed è soggetto ai limiti di memorizzazione nella cache e archiviazione dei dati applicabili.

Divulgazione attiva delle fonti: gli utenti finali devono essere ragionevolmente informati del ruolo svolto da Google Maps nella loro esperienza e di come trovare informazioni dettagliate sulle fonti al momento dell'interazione.

La divulgazione attiva delle fonti deve comunicare i seguenti punti:

• I contenuti generati con l'AI potrebbero includere informazioni di Google Maps.
• Le fonti dettagliate sono disponibili nell'UI complementare.

Devi comunicare l'informativa attiva delle fonti utilizzando almeno uno dei seguenti metodi:

• Visualizzazione su schermo: per le interazioni vocali che avvengono su un dispositivo con uno schermo, visualizza l'informativa esplicita sullo schermo ogni volta che vengono utilizzati gli strumenti dell'agente Experimente Maps.
• Annuncio vocale: leggi l'informativa visibile all'utente. Questo annuncio deve essere effettuato durante la prima interazione supportata dagli strumenti degli agenti di Maps Experience e ripetuto almeno ogni sei mesi.

Esempio di informativa: "I contenuti generati con l'AI potrebbero includere informazioni di Google Maps. Puoi trovare fonti dettagliate nell'app complementare."

Informativa permanente: l'utente finale deve poter accedere in modo permanente a una spiegazione del fatto che i contenuti di Google Maps potrebbero essere utilizzati nei contenuti generati con l'AI, ad esempio in un menu delle impostazioni vocali o in un'informativa sull'interazione vocale.

Richieste degli utenti: l'assistente vocale deve rispondere con precisione alle richieste degli utenti finali relative alla fonte dei contenuti, anche quando i contenuti generati con l'AI includono informazioni di Google Maps. Se l'origine è Google Maps, indirizza gli utenti finali alla UI complementare per accedere alle informazioni specifiche dell'origine.

Visualizza le fonti di Google Maps con i link a Maps

Per ogni fonte fornita nel messaggio Attribution, genera un'anteprima del link che soddisfi questi requisiti:

1. Requisiti generali:

   • Attribuisci ogni fonte a Google Maps seguendo le linee guida per l'attribuzione del testo di Google Maps.
   • Mostra il titolo della fonte come fornito nella risposta.
   • Link alla fonte utilizzando l'url fornito nella risposta.

   

2. Miglioramenti visivi facoltativi:

   • Inserisci una favicon di Google Maps prima dell'attribuzione del testo di Google Maps.
   • Includi una foto dall'URL di origine (og:image).

Linee guida per l'attribuzione del testo di Google Maps

Quando attribuisci le fonti a Google Maps o Google nel testo, segui queste linee guida:

• Non modificare in alcun modo il testo Google Maps o Google: non cambiare le lettere maiuscole.
• Non mandare a capo Google Maps su più righe.
• Non localizzare Google Maps o Google in un'altra lingua.
• Impedisci ai browser di tradurre Google Maps utilizzando l'attributo HTML translate="no".

Applica uno stile al testo di Google Maps come descritto nella tabella seguente:

CSS di esempio

Il seguente CSS esegue il rendering di Google Maps con lo stile tipografico e il colore appropriati su uno sfondo bianco o chiaro:

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}