Questa pagina fornisce i requisiti e le linee guida per l'attribuzione per la visualizzazione dei contenuti di Grounding Lite nelle tue applicazioni.
Informa l'utente sull'utilizzo delle fonti di Google Maps
Con ogni risultato di Maps Grounding Lite, riceverai un messaggio di attribuzione che supporta la risposta. Vengono restituiti i seguenti metadati:
- titolo: 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.
Quando presenti i risultati di Maps Grounding Lite, devi specificare le fonti di Google Maps associate e informare gli utenti di quanto segue:
- Le fonti di Google Maps devono seguire immediatamente i contenuti generati che supportano. Questi contenuti generati sono anche chiamati risultato di Maps Grounding Lite.
- Le fonti di Google Maps devono essere visualizzabili con una sola interazione dell'utente.
Per le interfacce voice-first
Origine: le fonti di Google Maps devono essere visualizzate in un'interfaccia utente complementare che mostri una registrazione storica letterale di qualsiasi conversazione vocale con l'AI. Questa registrazione deve rispettare i requisiti di origine ed è soggetta ai limiti di memorizzazione nella cache e di archiviazione dei dati applicabili.
Divulgazione attiva delle fonti: gli utenti finali devono essere ragionevolmente consapevoli del ruolo di Google Maps nella loro esperienza e di come trovare informazioni dettagliate sull'origine al momento dell'interazione.
La divulgazione attiva delle fonti deve comunicare i seguenti punti:
- I contenuti generati dall'AI possono includere informazioni provenienti da Google Maps.
- Le fonti dettagliate sono disponibili nell'interfaccia utente complementare.
Devi comunicare la divulgazione attiva delle fonti utilizzando almeno uno dei seguenti metodi.
- Visualizzazione: per le interazioni vocali che si verificano su un dispositivo con schermo, visualizza l'informativa attiva sullo schermo ogni volta che viene utilizzato Grounding con Google Maps.
- Annuncio vocale: leggi la divulgazione attiva all'utente. Questa operazione deve avvenire durante la prima interazione supportata da Grounding con Google Maps e ripetersi almeno ogni 6 mesi.
Esempio di divulgazione: "I contenuti generati dall'AI possono includere informazioni provenienti da Google Maps. Puoi trovare le fonti dettagliate nell'app complementare."
Divulgazione persistente: una spiegazione che indica che i contenuti di Google Maps possono essere utilizzati nei contenuti generati dall'AI deve essere accessibile in modo persistente all'utente finale (ad es. in un menu delle impostazioni vocali o in una divulgazione dell'interazione vocale).
Richieste degli utenti: l'assistente vocale deve rispondere con precisione alle richieste degli utenti finali relative all'origine dei contenuti, anche quando i contenuti generati dall'AI includono informazioni provenienti da Google Maps. Se Google Maps è la fonte, indirizza gli utenti finali all'interfaccia utente complementare per accedere alle informazioni specifiche sull'origine.
Visualizza le fonti di Google Maps con i link di Google Maps
Per ogni fonte fornita nel messaggio di attribuzione, deve essere generata un'anteprima del link che rispetti i seguenti requisiti:
1. Requisiti generali
- Attribuisci ogni fonte a Google Maps seguendo le linee guida per l'attribuzione di testo di Google Maps.
- Visualizza il titolo della fonte esattamente come indicato nella risposta.
Collega alla fonte utilizzando l'url fornito nella risposta.
2. Miglioramento visivo (facoltativo)
- Prima dell'attribuzione di testo di Google Maps può essere inserita una favicon di Google Maps.
- Può essere inclusa una foto dall'URL di origine (og:image).
Linee guida per l'attribuzione di testo di Google Maps
Quando attribuisci le fonti a Google Maps o Google nel testo, segui queste linee guida:
- Non modificare il testo Google Maps o Google in alcun modo: non modificare le maiúscole.
- 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 lo stile al testo di Google Maps come descritto nella tabella seguente:
| Proprietà | Stile |
|---|---|
| Famiglia di caratteri | Roboto. Il caricamento del carattere è facoltativo. |
| Famiglia di caratteri di riserva | Qualsiasi carattere del corpo sans-serif già utilizzato nel tuo prodotto o "Sans-Serif". |
| Spessore carattere | 400 |
| Colore carattere | Bianco, nero (#1F1F1F) o grigio (#5E5E5E). Mantieni un contrasto di 4,5:1. |
| Dimensione carattere | Dimensione carattere minima: 12sp Dimensione carattere massima: 16sp Per scoprire di più su sp, consulta Unità di dimensione carattere sul sito web di Material Design. |
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;
}