Políticas y atribuciones de la API de Maps JavaScript

En este documento, se enumeran los requisitos para las aplicaciones desarrolladas con la API de Maps JavaScript. Ten en cuenta que el uso de la API de Maps JavaScript se rige por tu Acuerdo con Google.

Políticas

En esta sección, se describen las políticas pertinentes para la API de Maps JavaScript. Las políticas proporcionan lineamientos y requisitos de implementación prácticos para ayudarte a usar el Servicio de forma correcta y de acuerdo con las expectativas de Google Maps Platform.

Excepciones a las restricciones de almacenamiento en caché

Ten en cuenta que el ID del lugar, que se usa para identificar un lugar de forma unívoca, está exento de las restricciones de almacenamiento en caché. Por lo tanto, puedes almacenar valores del ID del lugar de manera indefinida. En las respuestas de la API, el ID de lugar se devuelve en el campo place_id. Consulta la guía sobre los IDs de lugar para saber cómo guardarlos, actualizarlos y administrarlos.

Recopilación de contenido

Es posible que se te devuelva el nombre del lugar en función de las interacciones del usuario con tu app. Si capturas o conservas el nombre del lugar para usarlo en cualquier otro contexto fuera de la sesión del usuario, esto constituirá una extracción de datos, lo que no está permitido según nuestras condiciones.

Países y territorios del Espacio Económico Europeo

Este producto tiene diferentes Condiciones del Servicio para los clientes con una dirección de facturación en el Espacio Económico Europeo (EEE) y también puede tener diferentes funciones. Antes de compilar con Google Maps Platform, revisa las siguientes condiciones y la información específicas del EEE:

• Condiciones del Servicio de Google Maps Platform para el EEE
• Condiciones Específicas del Servicio de Google Maps Platform para el EEE
• Preguntas frecuentes sobre el EEE
• Requisitos de seguridad vial de Google Maps Platform

Si tu dirección de facturación no se encuentra en el EEE, se te aplicarán las siguientes condiciones del servicio:

• Condiciones del Servicio de Google Maps Platform
• Condiciones Específicas del Servicio de Google Maps Platform

Requisitos de atribución de Google Maps

En esta sección, se proporcionan los requisitos y lineamientos de atribución para mostrar Google Maps y el Contenido en tus aplicaciones.

Ejemplo de atribución

A continuación, se muestra un ejemplo de atribución para el kit de IU de Places.

Muestra la atribución de Google Maps

Debes seguir los requisitos de atribución de Google Maps cuando muestres contenido de las APIs de Google Maps Platform en tu app o sitio web. No necesitas agregar atribuciones adicionales si el Contenido se muestra en un mapa de Google Maps donde la atribución ya es visible.

Se incluyó la atribución de Google Maps

Para la atribución de Google Maps que ya proporciona Google Maps Platform en la interfaz de usuario, como en el kit de IU de Places, haz lo siguiente:

• No quites la atribución incluida, independientemente de dónde se muestre. No alteres, ocultes ni oscurezcas la atribución, y asegúrate de que se vea claramente sobre el fondo.
• Distingue siempre visualmente el contenido de Google Maps Platform de otro contenido con indicadores de la IU, como un borde, un color de fondo, una sombra o un espacio en blanco suficiente.
• Cuando realices modificaciones visuales, debes cumplir con todos los requisitos de atribución de Google Maps.

Logotipo de Google Maps y atribución de texto

Siempre que sea posible, la atribución debe tener la forma del logotipo de Google Maps. En los casos en que el espacio sea limitado, se puede usar el texto Google Maps. Los usuarios finales siempre deben tener claro qué contenido proporciona Google Maps.

Atribución del logotipo

Descarga los logotipos de Google Maps

Usa los archivos oficiales del logotipo de Google Maps. Descarga los logotipos que aparecen a continuación y sigue los lineamientos de esta sección.

Cuando uses el logotipo de Google Maps, sigue estos lineamientos.

• No modifiques el logotipo de ninguna manera.
• Mantén la relación de aspecto del logotipo para evitar distorsiones.
• Usa el logotipo con contorno sobre un fondo cargado, como un mapa o una imagen.
• Usa el logotipo sin contorno sobre un fondo liso, como un color sólido o un degradado sutil.

Especificación del tamaño del logotipo

• Altura mínima del logotipo: 16 dp
• Altura máxima del logotipo: 19 dp
• Espacio mínimo libre del logotipo: 10 dp a la izquierda, a la derecha y en la parte superior, y 5 dp en la parte inferior

Para obtener más información sobre los dp, consulta Densidad de píxeles en el sitio web de Material Design.

Accesibilidad del logotipo

• Mantén un contraste accesible entre el logotipo y el fondo.
• Incluye una etiqueta de accesibilidad con el texto Google Maps.

Atribución de texto

Si el tamaño de tu interfaz no admite el uso del logotipo de Google Maps, puedes escribir Google Maps en texto. Por ello, sigue estos lineamientos:

• No modifiques el texto Google Maps de ninguna manera:
  
  • No cambies el uso de mayúsculas de Google Maps.
  • No ajustes Google Maps en varias líneas.
  • No localices Google Maps 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:

  Requisitos de diseño de texto de Google Maps
  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 que ya se use en tu producto o "Sans-Serif" para invocar la fuente predeterminada del sistema
  Estilo de fuente	Normal
  Grosor de la fuente	400
  Color de la fuente	Blanco, negro (#1F1F1F) o gris (#5E5E5E). Mantén un contraste accesible (4.5:1) con el fondo.
  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 sp, consulta Unidades de tamaño de fuente en el sitio web de Material Design.
  Espacio entre letras	Normal

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

Requisitos visuales

• Coloca la atribución cerca de la parte superior o inferior del contenido, y dentro del mismo contenedor visual. Para una sola línea de contenido, la atribución se puede colocar a la derecha o a la izquierda.

• Distingue visualmente el Contenido de Google Maps Platform de otro contenido con indicadores de la IU, como un borde, un color de fondo, una sombra o un espacio en blanco suficiente.

• No tergiverses Google Maps atribuyéndole contenido que no sea de Google Maps Platform.
• Verifica que la atribución siempre sea visible y legible. Nunca la quites, ocultes, oscurezcas ni modifiques.

En las siguientes figuras, se muestran ejemplos de estos requisitos visuales.

proveedores externos de datos,

Algunos de los datos y las imágenes que se utilizan en nuestros productos de creación de mapas son de proveedores ajenos a Google. En el caso de algunos productos, como la API de Map Tiles, es posible que te proporcionemos la atribución requerida al proveedor de datos externo. Cuando lo hagamos, el texto de tu atribución deberá indicar el nombre "Google Maps" y los proveedores de datos correspondientes; por ejemplo, "Datos del mapa: Google y Maxar Technologies". Cuando Google proporciona atribución de terceros, no se considera una atribución adecuada incluir solo "Google Maps" o el logotipo de Google.

Otros requisitos de atribución

Sigue estas instrucciones para recuperar y mostrar atribuciones de terceros en tu aplicación.

Cómo recuperar las atribuciones de un lugar

Si muestra información de opiniones que se obtiene llamando a Place.fetchFields, tu aplicación también deberá mostrar las atribuciones de terceros que correspondan a los detalles del lugar.

La API devuelve un objeto Place. Para recuperar las atribuciones del objeto Place, usa la propiedad Place.attributions, que se devuelve con cada solicitud (no hace falta especificarla con campos). La propiedad devuelve una List de objetos String, o bien null si no hay atribuciones para mostrar. El siguiente código de ejemplo muestra cómo obtener un lugar y una lista de posibles atribuciones.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

Cómo mostrar una opinión

Un objeto Place puede contener hasta cinco opiniones, cada una representada con un objeto Review. Opcionalmente, puedes mostrar esas opiniones en tu aplicación.

Cuando muestras opiniones de los usuarios de Google, debes colocar el nombre del autor en una posición cercana. Te recomendamos incluir la foto del autor y también el vínculo a su perfil si están disponibles en su campo de atribución del objeto Review. La siguiente imagen muestra un ejemplo de una opinión sobre un parque:

El siguiente ejemplo muestra cómo obtener un lugar, verificar si hay opiniones y mostrar los datos de la primera opinión:

// Create a new Place instance.
const place = new Place({
    id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA
});

// Call fetchFields, passing 'reviews' and other needed fields.
await place.fetchFields({
    fields: ['displayName', 'formattedAddress', 'location', 'reviews'],
});

// Create an HTML container.
const content = document.createElement('div');
const title = document.createElement('div');
const rating = document.createElement('div');
const address = document.createElement('div');
const review = document.createElement('div');
const authorLink = document.createElement('a');

// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
    // Get info for the first review.
    const reviewRating = place.reviews[0].rating;
    const reviewText = place.reviews[0].text;
    const authorName = place.reviews[0].authorAttribution.displayName;
    const authorUri = place.reviews[0].authorAttribution.uri;

    // Safely populate the HTML.
    title.textContent = place.displayName || '';
    address.textContent = place.formattedAddress || '';
    rating.textContent = `Rating: ${reviewRating} stars`;
    review.textContent = reviewText || '';
    authorLink.textContent = authorName;
    authorLink.href = authorUri || '';
    authorLink.target = '_blank';

    content.appendChild(title);
    content.appendChild(address);
    content.appendChild(rating);
    content.appendChild(review);
    content.appendChild(authorLink);
} else {
    content.textContent = `No reviews were found for ${place.displayName}.`;
}

// Create an infoWindow to display the review.
infoWindow = new InfoWindow({
    content,
    ariaLabel: place.displayName,
});
index.js

Consulta la documentación sobre las opiniones de lugares.

Cómo mostrar las atribuciones de una foto

Si tu aplicación muestra fotos, debes incluir la atribución del autor de cada foto que la incluya. En un objeto Place de una respuesta, los detalles de la foto se incluyen en el array photos. Para agregar el array photos a la respuesta, incluye el campo de datos photos en la solicitud.

Cada elemento del array de fotos es una instancia de Photo, que contiene el array authorAttributions, del tipo AuthorAttribution. Los campos del objeto AuthorAttribution son cadenas que contienen la información de displayName, uri y photoUri de la atribución, o bien una cadena nula si no hay atribuciones para mostrar.

Consulta la documentación sobre las fotos de lugares.

Atribuciones de los resultados de la búsqueda

En Europa, cuando se usa la clasificación sin adulterar de Google, los productos de búsqueda deben tener un texto explicativo a no más de 1 clic de distancia que describa los factores principales y la ponderación de los factores principales que determinan la clasificación de los resultados de la búsqueda. Texto explicativo:

Encabezado: Acerca de estos resultados

Cuerpo: Cuando busques empresas o lugares cerca de una ubicación, Google Maps te mostrará resultados locales. Varios factores, principalmente la relevancia, la distancia y la importancia, se combinan para ayudarte a encontrar los mejores resultados para tu búsqueda.

Botón 1: Más información
El texto "Más información" debe vincular a un artículo del Centro de ayuda.

Botón 2: OK

Autocompletado para las direcciones de los usuarios finales

Cuando un usuario final usa la funcionalidad de Autocompletar en tu Aplicación del Cliente para escribir una dirección, y ese usuario final habría proporcionado esa dirección de forma completa y precisa sin Autocompletar, la dirección seleccionada por el usuario final no está sujeta a las restricciones de contenido de Google Maps en tu Acuerdo de Google Maps Platform. Esta excepción se aplica solo a la dirección seleccionada por el usuario final y únicamente para la transacción específica de ese usuario final. No se aplica a la lista de direcciones sugeridas que proporciona la función de Autocomplete ni a otro Contenido de Google Maps. Esta excepción no se aplica a ninguna funcionalidad de búsqueda de lugares de interés o direcciones que ofrezcan otros servicios de Google Maps Platform.

En la imagen anterior, la lista de direcciones de la izquierda sigue sujeta a las restricciones del contenido de Google Maps. Una vez que el usuario final selecciona la dirección elegida, esa dirección no está sujeta a las restricciones del Contenido de Google Maps únicamente para el propósito de la transacción aplicable de ese usuario final.

Resúmenes potenciados por IA

Cuando muestres resúmenes potenciados por IA en tu app, incluidos los resúmenes de lugares, áreas y opiniones, debes hacer lo siguiente:

• Mostrar las atribuciones, los vínculos de informes y los vínculos de referencia requeridos, según se define a continuación
• Los usuarios finales deben poder leer el texto de resumen completo tal como lo proporciona Google Maps.

Muestra el texto de divulgación de los resúmenes potenciados por IA

Cuando muestres un resumen potenciado por IA de cualquier tipo, incluye siempre el texto de divulgación localizado (proporcionado en el campo disclosureText del cuerpo de la respuesta) justo debajo del resumen. Nunca modifiques ni aumentes el texto de divulgación que proporciona la API.

Requisitos adicionales para los resúmenes de lugares y áreas

Los resúmenes de lugares y áreas que se muestran en tu app deben estar acompañados del siguiente texto y los vínculos obligatorios:

Requisitos de los resúmenes de opiniones

Los resúmenes de opiniones que se muestren en tu app deben ir acompañados de un encabezado con el texto "Resumen de opiniones". Además, debes usar el siguiente texto y los vínculos obligatorios:

Orientación de la pantalla para casos de uso automotrices

Para garantizar la seguridad del conductor, Google recomienda renderizar los resúmenes potenciados por IA en el modo de estacionamiento para las experiencias automotrices. Si renderizas resúmenes en el modo Conducción, la información en pantalla debe ser simple, clara y concisa para garantizar que la atención del conductor vuelva rápidamente a la ruta:

• No más de 3 líneas
• 120 caracteres o 24 palabras como máximo
• Tamaño mínimo de 24 dp para el frente

Especialmente en contextos automotrices, es responsabilidad del desarrollador renderizar los resúmenes potenciados por IA de manera segura y de conformidad con todas las leyes y reglamentaciones locales.