Questa pagina fornisce i requisiti e le linee guida per l'attribuzione per la visualizzazione dei contenuti degli strumenti dell'agente di Maps Experience nelle tue applicazioni. I requisiti si applicano a tutti i risultati, inclusi i riepiloghi con approfondimenti tratti dalle recensioni.
Informare l'utente sull'utilizzo delle fonti di Google Maps
Con ogni risultato degli strumenti dell'agente Experimente Maps, riceverai un messaggio di attribuzione che supporta la risposta. Vengono restituiti 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.
Quando presenti i risultati degli strumenti dell'agente Maps Experience, 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 degli strumenti dell'agente di Experimente Maps.
- 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 mostra un registro storico letterale di qualsiasi conversazione vocale con l'AI. Questo record deve rispettare 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 la divulgazione attiva delle fonti utilizzando almeno uno dei seguenti metodi.
- Visualizzazione: per le interazioni vocali che avvengono su un dispositivo con uno schermo, visualizza l'informativa attiva sullo schermo ogni volta che vengono utilizzati gli strumenti dell'agente di Maps Experience.
- Annuncio vocale: leggi l'informativa attiva all'utente. Ciò deve avvenire durante la prima interazione supportata dagli strumenti dell'agente di Maps Experience e ripetersi almeno ogni 6 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 all'interfaccia utente 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 di attribuzione, deve essere generata un'anteprima del link che soddisfi i seguenti 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 esattamente come fornito nella risposta.
Link alla fonte utilizzando l'url fornito nella risposta.
2. Visual Enhancement (Optional)
- È possibile inserire una favicon di Google Maps prima dell'attribuzione del testo di Google Maps.
- Può essere inclusa una foto dell'URL di origine (og:image).
Linee guida per l'attribuzione del testo di Google Maps
Quando attribuisci le fonti a Google Maps o a Google nel testo, segui queste linee guida:
- Non modificare in alcun modo il testo Google Maps o Google: non cambiare le lettere maiuscole.
- Non andare a capo con 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".
Stile del 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 sans serif per il corpo 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 minima del carattere: 12 sp Dimensione massima del carattere: 16 sp Per scoprire di più sugli sp, consulta le unità di misura delle dimensioni dei caratteri 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;
}