Wytyczne dotyczące atrybucji tekstu w narzędziach agenta Maps Experience

Na tej stronie znajdziesz wymagania dotyczące podawania źródła i wytyczne dotyczące wyświetlania w aplikacjach treści z narzędzi agentowych Maps Experience. Wymagania dotyczą wszystkich wyników, w tym podsumowań ze statystykami z opinii, wyników dotyczących tras i objazdów oraz danych o pogodzie, jakości powietrza i pyłkach.

Poinformuj użytkownika o korzystaniu ze źródeł Map Google.

Z każdym wynikiem narzędzi agentowych Maps Experience otrzymujesz wiadomość Attribution, która obsługuje odpowiedź:

  • search_places: places[].attribution
  • search_along_route: results[].place.attribution
  • compute_routes: routes[].attribution
  • lookup_weather: weather.attribution, airQuality.attribution i pollen.attribution (lub attribution najwyższego poziomu w przypadku starszych żądań dotyczących pogody)

Każda wiadomość Attribution zwraca te metadane:

  • title: konkretny tytuł, który ma być wyświetlany w przypadku źródła.
  • url: adres URL używany do przekierowywania użytkowników do Map Google lub wyszukiwarki Google, aby mogli zobaczyć materiał źródłowy (jeśli jest dostępny).

Podczas prezentowania wyników z narzędzi agentowych Maps Experience musisz podać powiązane źródła Map Google i spełnić te wymagania:

  • Źródła Map Google muszą znajdować się bezpośrednio po wygenerowanych treściach, które te źródła obsługują. Te wygenerowane treści są też nazywane wynikiem narzędzi agentowych Maps Experience.
  • Źródła Map Google muszą być widoczne w ramach jednej interakcji użytkownika.

Interfejsy głosowe

Źródła: źródła Map Google muszą być wyświetlane w interfejsie towarzyszącym, który pokazuje dosłowny zapis historyczny każdej rozmowy głosowej AI. Ten rekord musi spełniać wymagania dotyczące pozyskiwania danych i podlega obowiązującym limitom buforowania i przechowywania danych.

Aktywne ujawnianie źródeł: użytkownicy muszą być w uzasadniony sposób informowani o roli, jaką Mapy Google odgrywają w ich doświadczeniach, oraz o tym, jak znaleźć szczegółowe informacje o źródłach w momencie interakcji.

Aktywne ujawnianie źródeł musi zawierać te informacje:

  • Treści generowane przez AI mogą zawierać informacje z Map Google.
  • Szczegółowe źródła są dostępne w interfejsie aplikacji towarzyszącej.

Musisz przekazać aktywne ujawnienie źródeł, korzystając z co najmniej jednej z tych metod:

  • Wyświetlanie: w przypadku interakcji głosowych, które odbywają się na urządzeniu z ekranem, wyświetlaj aktywne powiadomienie na ekranie za każdym razem, gdy używane są narzędzia agenta Maps Experience.
  • Komunikat głosowy: odczytaj użytkownikowi aktywne powiadomienie. To powiadomienie musi pojawić się podczas pierwszej interakcji obsługiwanej przez narzędzia agenta Maps Experience i powtarzać się co najmniej raz na 6 miesięcy.

Przykładowy komunikat: „Treści generowane przez AI mogą zawierać informacje z Map Google. Szczegółowe źródła znajdziesz w aplikacji towarzyszącej”.

Stałe ujawnianie informacji: wyjaśnienie, że treści z Map Google mogą być wykorzystywane w treściach generowanych przez AI, musi być stale dostępne dla użytkownika, np. w menu ustawień głosu lub w informacjach o interakcji głosowej.

Zapytania użytkowników: asystent głosowy musi dokładnie odpowiadać na zapytania użytkowników dotyczące źródła treści, w tym sytuacji, gdy treści generowane przez AI zawierają informacje z Map Google. Jeśli źródłem są Mapy Google, przekieruj użytkowników do interfejsu towarzyszącego, aby uzyskali dostęp do konkretnych informacji o źródle.

Dla każdego źródła podanego w wiadomości Attribution wygeneruj podgląd linku, który spełnia te wymagania:

  1. Wymagania ogólne:

    Przykład podglądu linku do źródła w Mapach Google.

  2. Opcjonalne ulepszenia wizualne:

    • Wstaw ikonę ulubionych Map Google przed tekstem atrybucji Map Google.
    • Dołącz zdjęcie z adresu URL źródła (og:image).

Wytyczne dotyczące atrybucji tekstowej w Mapach Google

Gdy w tekście przypisujesz źródła do Map Google lub Google, postępuj zgodnie z tymi wytycznymi:

  • Nie modyfikuj w żaden sposób tekstu Mapy Google ani Google: nie zmieniaj wielkości liter.
  • Nie zawijaj Map Google do wielu wierszy.
  • Nie tłumacz nazw „Mapy Google” ani „Google” na inny język.
  • Zablokuj przeglądarkom możliwość tłumaczenia Map Google, używając atrybutu HTML translate="no".

Tekst Map Google należy sformatować zgodnie z tabelą poniżej:

Właściwość Styl
Rodzina czcionek Roboto. Wczytywanie czcionki jest opcjonalne.
Rodzina czcionek zastępczych Dowolna czcionka Sans Serif używana już w Twoim produkcie lub "Sans-Serif".
Grubość czcionki 400
Kolor czcionki Biały, czarny (#1F1F1F) lub szary (#5E5E5E). Zachowaj kontrast 4,5:1.
Rozmiar czcionki Minimalny rozmiar czcionki: 12 sp
Maksymalny rozmiar czcionki: 16 sp
Więcej informacji o sp znajdziesz w artykule o typografii w Material Design.

Przykładowa usługa porównywania cen

Poniższy kod CSS renderuje Mapy Google z odpowiednim stylem typograficznym i kolorem na białym lub jasnym tle:

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