Lineamientos de atribución de texto para las herramientas de agentes de Maps Experience

En esta página, se proporcionan los requisitos y lineamientos de atribución para mostrar el contenido de las herramientas de agentes de Maps Experience en tus aplicaciones. Los requisitos se aplican a todos los resultados, incluidos los resúmenes con estadísticas de opiniones, los resultados de rutas y desvíos, y los datos de clima, calidad del aire y polen.

Informa al usuario sobre el uso de las fuentes de Google Maps

Con cada resultado de las herramientas de agentes de Maps Experience, recibes un mensaje Attribution que respalda la respuesta:

  • search_places: places[].attribution
  • search_along_route: results[].place.attribution
  • compute_routes: routes[].attribution
  • lookup_weather: weather.attribution, airQuality.attribution y pollen.attribution (o attribution de nivel superior para solicitudes meteorológicas heredadas)

Cada mensaje de Attribution devuelve los siguientes metadatos:

  • title: Es el título específico que se mostrará para la fuente.
  • url: Es la URL que se usa para redireccionar a los usuarios a Google Maps o a la Búsqueda de Google para ver el material de referencia, cuando corresponda.

Cuando presentes resultados de las herramientas de agentes de Maps Experience, debes especificar las fuentes de Google Maps asociadas y cumplir con los siguientes requisitos:

  • Las fuentes de Google Maps deben aparecer inmediatamente después del contenido generado que respaldan. Este contenido generado también se conoce como el resultado de las herramientas de agentes de Maps Experience.
  • Las fuentes de Google Maps deben poder verse en una interacción del usuario.

Para interfaces centradas en la voz

Fuentes: Las fuentes de Google Maps deben mostrarse en una IU complementaria que incluya un registro histórico textual de cualquier conversación de voz con la IA. Este registro debe cumplir con los requisitos de abastecimiento y está sujeto a los límites aplicables de almacenamiento en caché y almacenamiento de datos.

Divulgación activa de las fuentes: Los usuarios finales deben conocer de forma razonable el rol que desempeña Google Maps en su experiencia y cómo encontrar fuentes detalladas en el momento de la interacción.

La divulgación activa de las fuentes debe transmitir los siguientes puntos:

  • El contenido generado por IA puede incluir información de Google Maps.
  • Las fuentes detalladas están disponibles en la IU complementaria.

Debes transmitir la divulgación activa de las fuentes con al menos uno de los siguientes métodos:

  • Visualización: En el caso de las interacciones por voz que se producen en un dispositivo con pantalla, muestra la divulgación activa en la pantalla cada vez que se usen las herramientas de agente de la experiencia de Maps.
  • Anuncio de voz: Lee la divulgación activa al usuario. Este anuncio debe realizarse durante la primera interacción que se admita con las herramientas de agentes de Maps Experience y repetirse, al menos, cada seis meses.

Ejemplo de divulgación: "El contenido generado por IA podría incluir información de Google Maps. Puedes encontrar fuentes detalladas en la app complementaria".

Divulgación persistente: El usuario final debe poder acceder de forma persistente a una explicación de que el contenido de Google Maps se puede usar en el contenido generado por IA, por ejemplo, en un menú de configuración de voz o en una divulgación de interacción por voz.

Consultas de los usuarios: Tu asistente de voz debe responder con precisión las consultas de los usuarios finales sobre la fuente del contenido, incluso cuando el contenido generado por IA incluya información de Google Maps. Si Google Maps es la fuente, dirige a los usuarios finales a la IU complementaria para que accedan a información específica de la fuente.

Para cada fuente proporcionada en el mensaje Attribution, genera una vista previa del vínculo que cumpla con estos requisitos:

  1. Requisitos generales:

    Ejemplo de la vista previa del vínculo de atribución de la fuente de Google Maps.

  2. Mejoras visuales opcionales:

    • Inserta un ícono de Google Maps antes de la atribución de texto de Google Maps.
    • Incluye una foto de la URL de origen (og:image).

Lineamientos para la atribución de texto de Google Maps

Cuando atribuyas fuentes a Google Maps o Google en texto, sigue estos lineamientos:

  • No modifiques el texto Google Maps ni Google de ninguna manera: No cambies el uso de mayúsculas.
  • No dividas Google Maps en varias líneas.
  • No localices Google Maps ni Google a otro idioma.
  • Evita que los navegadores traduzcan Google Maps con el atributo HTML translate="no".

Asigna un estilo al texto de Google Maps como se describe en la siguiente tabla:

Propiedad Estilo
Familia de fuentes Roboto. La carga de la fuente es opcional.
Familia de fuentes de resguardo Cualquier fuente sans-serif para el cuerpo del texto que ya se use en tu producto o "Sans-Serif".
Grosor de la fuente 400
Color de la fuente Blanco, negro (#1F1F1F) o gris (#5E5E5E). Mantén un contraste de 4.5:1.
Tamaño de fuente Tamaño de fuente mínimo: 12 sp
Tamaño de fuente máximo: 16 sp
Para obtener información sobre los sp, consulta Tipografía de Material Design.

Ejemplo de CSS

El siguiente código CSS renderiza Google Maps con el estilo tipográfico y el color adecuados sobre un fondo blanco o claro:

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