Richtlinien für die Textattribution für Tools für Maps Experience-Agenten

Auf dieser Seite finden Sie die Anforderungen und Richtlinien für die Quellenangabe, wenn Sie Inhalte von Maps Experience Agent Tools in Ihren Anwendungen anzeigen. Die Anforderungen gelten für alle Ergebnisse, einschließlich Zusammenfassungen mit Informationen aus Rezensionen, Routen- und Umleitungsergebnissen sowie Wetter-, Luftqualitäts- und Pollendaten.

Nutzer über die Verwendung von Google Maps-Quellen informieren

Mit jedem Maps Experience Agent Tools-Ergebnis erhalten Sie eine Attribution-Nachricht, die die Antwort unterstützt:

  • search_places: places[].attribution
  • search_along_route: results[].place.attribution
  • compute_routes: routes[].attribution
  • lookup_weather: weather.attribution, airQuality.attribution und pollen.attribution (oder attribution auf oberster Ebene für alte Wetteranfragen)

Jede Attribution-Nachricht gibt die folgenden Metadaten zurück:

  • title: Der spezifische Titel, der für die Quelle angezeigt werden soll.
  • url: Die URL, über die Nutzer gegebenenfalls zu Google Maps oder der Google Suche weitergeleitet werden, um das Quellenmaterial aufzurufen.

Wenn Sie Ergebnisse aus Maps Experience Agent Tools präsentieren, müssen Sie die zugehörigen Google Maps-Quellen angeben und die folgenden Anforderungen erfüllen:

  • Die Google Maps-Quellen müssen unmittelbar auf die generierten Inhalte folgen, die sie unterstützen. Diese generierten Inhalte werden auch als Ergebnis der Maps Experience Agent Tools bezeichnet.
  • Die Google Maps-Quellen müssen innerhalb einer Nutzerinteraktion sichtbar sein.

Für sprachbasierte Oberflächen

Quellenangabe: Google Maps-Quellen müssen in einer begleitenden Benutzeroberfläche angezeigt werden, die eine wortgetreue Aufzeichnung aller KI-Sprachunterhaltungen enthält. Dieser Eintrag muss den Anforderungen an die Quellenangabe entsprechen und unterliegt den geltenden Limits für das Caching und die Speicherung von Daten.

Aktive Offenlegung von Quellen: Endnutzer müssen in angemessener Weise über die Rolle von Google Maps bei der Nutzung und darüber informiert werden, wie sie zum Zeitpunkt der Interaktion detaillierte Quellenangaben finden.

Die aktive Offenlegung von Quellen muss die folgenden Punkte enthalten:

  • KI-generierte Inhalte können Informationen aus Google Maps enthalten.
  • Detaillierte Quellen sind in der Companion-Benutzeroberfläche verfügbar.

Sie müssen die aktive Offenlegung von Quellen mit mindestens einer der folgenden Methoden vermitteln:

  • Visuelle Anzeige: Bei Sprachinteraktionen auf einem Gerät mit Bildschirm muss die aktive Offenlegung auf dem Bildschirm angezeigt werden, wenn Maps Experience-Agent-Tools verwendet werden.
  • Sprachansage: Lies dem Nutzer die aktive Offenlegung vor. Diese Ansage muss während der ersten Interaktion erfolgen, die von den Agent-Tools für Maps Experience unterstützt wird, und mindestens alle sechs Monate wiederholt werden.

Beispiel für eine Offenlegung: „KI-generierte Inhalte können Informationen aus Google Maps enthalten. Detaillierte Quellen findest du in der Companion-App.“

Dauerhafte Offenlegung: Eine Erklärung, dass Google Maps-Inhalte in KI-generierten Inhalten verwendet werden können, muss für den Endnutzer dauerhaft zugänglich sein, z. B. in einem Menü für die Spracheinstellungen oder in einer Offenlegung für die Sprachinteraktion.

Nutzeranfragen: Ihr Sprachassistent muss Anfragen von Endnutzern zur Quelle der Inhalte korrekt beantworten, auch wenn KI-generierte Inhalte Informationen aus Google Maps enthalten. Wenn Google Maps die Quelle ist, leiten Sie Endnutzer an die Companion-UI weiter, um auf bestimmte Quellinformationen zuzugreifen.

Generieren Sie für jede Quelle, die in der Attribution-Nachricht angegeben ist, eine Linkvorschau, die die folgenden Anforderungen erfüllt:

  1. Allgemeine Anforderungen:

    Beispiel für die Vorschau des Links zur Quellenangabe in Google Maps

  2. Optionale visuelle Verbesserungen:

    • Fügen Sie vor der Textattribution für Google Maps ein Google Maps-Favicon ein.
    • Füge ein Foto von der Quell-URL (og:image) hinzu.

Richtlinien für Google Maps-Quellenangaben als Text

Wenn Sie Quellen in Texten Google Maps oder Google zuordnen, beachten Sie die folgenden Richtlinien:

  • Ändern Sie den Text „Google Maps“ oder „Google“ in keiner Weise, auch nicht die Groß- und Kleinschreibung.
  • Fügen Sie keinen Zeilenumbruch in Google Maps ein.
  • Lokalisieren Sie „Google Maps“ oder „Google“ nicht in eine andere Sprache.
  • Verhindern Sie, dass Browser Google Maps übersetzen, indem Sie das HTML-Attribut translate="no" verwenden.

Formatieren Sie Google Maps-Text wie in der folgenden Tabelle beschrieben:

Attribut Stil
Schriftfamilie Roboto. Das Laden der Schriftart ist optional.
Fallback-Schriftfamilie Eine beliebige Sans Serif Schriftart für den Textkörper, die bereits in Ihrem Produkt oder in "Sans-Serif" verwendet wird.
Schriftstärke 400
Schriftfarbe Weiß, Schwarz (#1F1F1F) oder Grau (#5E5E5E). Achten Sie auf ein Kontrastverhältnis von 4,5:1.
Schriftgröße Mindestschriftgröße: 12 sp
Maximale Schriftgröße: 16 sp
Weitere Informationen zu sp findest du unter Material Design-Typografie.

Beispiel-CSS

Mit dem folgenden CSS wird Google Maps mit dem entsprechenden typografischen Stil und der entsprechenden Farbe auf einem weißen oder hellen Hintergrund dargestellt:

@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;
}