En este documento, se enumeran los requisitos específicos de todas las aplicaciones desarrolladas con la API de Places, incluido el servicio Place Autocomplete que forma parte de esa API. Puedes encontrar información más general para desarrolladores de Google Maps en las Condiciones del Servicio de Google Maps Platform.
Divulgación de las Condiciones de Uso y la Política de Privacidad
Si desarrollas una aplicación con la API de Places, debes publicar en esa aplicación las Condiciones de Uso y la Política de Privacidad para satisfacer los lineamientos descritos en tu Acuerdo con Google:
- Las Condiciones de Uso y la Política de Privacidad deben estar disponibles públicamente.
- En las Condiciones de Uso de tu aplicación, debes indicar de forma explícita que, al utilizarla, los usuarios estarán vinculados a las Condiciones del Servicio de Google.
- En tu Política de Privacidad, debes notificar a los usuarios que utilizas las APIs de Google Maps y que incorporas por referencia la Política de Privacidad de Google.
El lugar recomendado para publicar tus Condiciones de Uso y tu Política de Privacidad dependerá de la plataforma de tu aplicación.
Aplicaciones para dispositivos móviles
Si desarrollas una aplicación para dispositivos móviles, te recomendamos que incluyas, en su página de descarga de la tienda de aplicaciones correspondiente y en un menú de parámetros de configuración de la aplicación, un vínculo a las Condiciones de Uso y la Política de Privacidad.
Aplicaciones web
Si desarrollas una aplicación web, te recomendamos que incluyas, en el pie de página de tu sitio web, un vínculo a las Condiciones de Uso y la Política de Privacidad.
Recuperación anticipada o almacenamiento (incluso en caché) del contenido
Las aplicaciones que utilizan la API de Places están vinculadas a las condiciones de tu Acuerdo con Google. Sujeto a las condiciones de tu Acuerdo, no debes recuperar anticipadamente, indexar ni almacenar en caché y otros medios ningún contenido, salvo de acuerdo con las condiciones limitadas que se indican allí.
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é. En las respuestas de la API de Places, 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.
Cómo mostrar resultados de la API de Places
Puedes mostrar los resultados de la API de Places en un mapa de Google Maps o sin ningún mapa. Si deseas mostrar los resultados de la API de Places en un mapa, estos deben mostrarse en un mapa de Google Maps. Está prohibido usar los datos de la API de Places en un mapa que no sea de Google Maps.
Requisitos para mostrar el logotipo y las atribuciones de Google
Si tu aplicación muestra datos en un mapa de Google Maps, se incluirá el logotipo de Google y no se podrá alterar. Las aplicaciones que muestran datos de Google en la misma pantalla que contiene un mapa de Google Maps no requieren ninguna atribución adicional relacionada con Google.
En caso de que tu aplicación muestre datos en una página o vista que no incluya un mapa de Google Maps, deberás mostrar un logotipo de Google con esos datos. Por ejemplo, si tu aplicación muestra datos de Google en una pestaña y presenta un mapa de Google Maps con esos datos en otra pestaña, la primera pestaña deberá mostrar el logotipo de Google. Siempre que tu aplicación utilice campos de búsqueda con o sin autocompletado, el logotipo se deberá mostrar intercalado.
El logotipo de Google se debe colocar en la esquina inferior izquierda del mapa, con la información de atribución en la esquina inferior derecha, y ambos elementos se deben presentar como una unidad sobre el mapa, no debajo ni en ningún otro lugar de la aplicación. El siguiente mapa de ejemplo muestra el logotipo de Google en el extremo inferior izquierdo con la atribución a la derecha.
| Para uso sobre un fondo claro | Para uso sobre un fondo oscuro |
|---|---|
|
|
El siguiente archivo ZIP contiene el logotipo de Google en los tamaños correctos que se utilizan en aplicaciones para iOS, Android y computadoras. No debes cambiar el tamaño de estos logotipos ni modificarlos de ninguna manera.
Descarga: google_logo.zip
No modifiques la atribución. No quites, oscurezcas ni recortes la información de atribución. No puedes utilizar los logotipos de Google intercalado en el texto (por ejemplo, "Estos mapas son de [logotipo_de_Google]").
Muestra la atribución en una posición cercana. Si utilizas capturas de pantalla de imágenes de Google fuera de una incorporación directa, incluye la atribución estándar tal como aparece en la imagen. De ser necesario, puedes personalizar el diseño y la posición del texto de atribución, siempre y cuando ese texto quede colocado en una posición cercana al contenido y sea legible para el usuario o lector medio. No puedes mover la atribución a un lugar alejado del contenido (por ejemplo, para que aparezca al final de tu libro, en los créditos de tu programa o tus archivos, o en el pie de página de tu sitio web).
Incluye a los proveedores de datos de terceros. 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. Si utilizas esas imágenes, el texto de tu atribución deberá indicar el nombre "Google" y los proveedores de datos correspondientes; por ejemplo, "Datos del mapa: Google y Maxar Technologies". No se considera una atribución adecuada incluir solo "Google" o el logotipo de Google cuando se citan proveedores de datos de terceros en las imágenes.
Si utilizas Google Maps Platform en un dispositivo en el que no resulta práctico mostrar la atribución, comunícate con el equipo de ventas de Google para informarte sobre las licencias adecuadas para tu caso de uso.
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 tu app muestra información que se obtiene llamando a Place Details con un ID de lugar, también debe mostrar las atribuciones de terceros que correspondan a los detalles del lugar.
Las atribuciones en el objeto Place de una respuesta se representan con un objeto Attribution. Para agregar Attribution a la respuesta, incluye places.attributions (Nearby Search y Text Search) o attributions (Place Details) en la máscara de campo de la solicitud.
Los campos del objeto Attribution son cadenas que contienen la información de provider y providerUri de la atribución, o bien una cadena nula si no hay atribuciones para mostrar.
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 places.photos (Nearby Search y Text Search) o photos (Place Details) en la máscara de campo de la solicitud.
Cada elemento del array photos 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.
Cómo mostrar una opinión
Un objeto Place en una respuesta puede contener hasta cinco opiniones. De manera opcional, puedes mostrar esas opiniones en tu app.
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. En la siguiente imagen, se muestra un ejemplo de una opinión sobre un parque:
Google también recomienda que muestres al usuario final cómo se ordenan las opiniones.
Cada opinión en un objeto Place de una respuesta está representada por un objeto Review. Para agregar el objeto Review a la respuesta, incluye places.reviews (Nearby Search y Text Search) o reviews (Place Details) en la máscara de campo de la solicitud.
Los campos del objeto Review contienen la atribución o están vacíos si no hay una atribución para mostrar.
Atribuciones de los resultados de la búsqueda
En Europa, cuando se utiliza 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 dirigir a un artículo del Centro de ayuda.
Botón 2: Aceptar
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:
- Muestra las atribuciones, los vínculos de informes y los vínculos de referencia requeridos como se define a continuación.
- Los usuarios finales deben poder leer el texto completo del resumen tal como lo proporciona Google Maps.
Cómo mostrar el texto de divulgación de resúmenes potenciados por IA
Cuando muestres un resumen potenciado por IA de cualquier tipo, siempre incluye el texto de divulgación localizado (proporcionado en el campo disclosureText del cuerpo de la respuesta) inmediatamente debajo del resumen. Nunca modifiques ni aumentes el texto de divulgación que proporciona la API.
Requisitos adicionales para el resumen de lugares y áreas
Los lugares y los resúmenes de áreas que se muestran en tu app deben incluir el siguiente texto y los vínculos obligatorios:
| Texto | Requisito |
|---|---|
| Acerca de este resumen | Consulta el siguiente vínculo para obtener información sobre "De dónde obtiene Google la información de las fichas locales y cómo la utiliza": https://support.google.com/local-listings/answer/9851099. |
| Resumen de la denuncia |
Usa el vínculo que se encuentra en el campo Nota: Los resúmenes potenciados por IA que se proporcionan a través de la API de Places (nueva) están sujetos a las políticas de productos y de contenido de Google, sin importar en qué lugar del mundo te encuentres. Debes notificar a tus usuarios finales que, si desean denunciar contenido que se debe quitar de los servicios de Google en virtud de las leyes aplicables, deben hacerlo con la URL de contenido de la marca proporcionada ( |
Requisitos de los resúmenes de opiniones
Los resúmenes de opiniones que se muestran 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:
| Texto | Requisito |
|---|---|
| Acerca de este resumen | Consulta el siguiente vínculo para obtener información sobre "De dónde obtiene Google la información de las fichas locales y cómo la utiliza": https://support.google.com/local-listings/answer/9851099 |
| Resumen de la denuncia |
Usa el vínculo que se incluye en el campo Nota: Los resúmenes potenciados por IA que se proporcionan a través de la API de Places (nueva) están sujetos a las políticas de productos y de contenido de Google, sin importar en qué lugar del mundo te encuentres. Debes notificar a tus usuarios finales que, si desean denunciar contenido que se debe quitar de los servicios de Google en virtud de las leyes aplicables, deben hacerlo con la URL de contenido de la marca proporcionada ( |
| Ver opiniones | Usa el vínculo que se incluye en el campo googleMapsLinks.reviewsUri de la respuesta. |
Orientación sobre la pantalla para casos de uso de la industria automotriz
Para la seguridad del conductor, Google recomienda renderizar resúmenes potenciados por IA en el modo de estacionamiento para experiencias de la industria automotriz. Si se renderizan resúmenes en el modo de 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 o menos
- Tamaño frontal mínimo de 24 dp
En especial en contextos de la industria automotriz, es responsabilidad del desarrollador renderizar resúmenes potenciados por IA de manera segura y que satisfaga todas las leyes y reglamentaciones locales.
Lineamientos de diseño para las atribuciones de Google
A continuación se indican los lineamientos de diseño para las atribuciones de Google en CSS y HTML, por si no puedes usar el logotipo de Google descargable.
Espacio libre
La cantidad de espacio libre alrededor del diseño final debería ser igual o más grande que la altura de la "G" de Google.
El espacio entre el texto de atribución y el logotipo de Google debería equivaler a la mitad del ancho de la "G".
Legibilidad
El rótulo debería aparecer siempre de forma clara y legible, en la combinación de colores adecuada según el fondo específico. Siempre debes asegurarte de proporcionar suficiente contraste para la variante del logotipo que selecciones.
Color
Usa un texto de color gris 700 según Material de Google, sobre un fondo blanco o claro en el que el tono de negro sea de un rango del 0 al 40% como máximo.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
En fondos más oscuros, así como sobre fotografías o diseños no complejos, usa un texto de color blanco para el rótulo y la atribución.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Fuente
Usa la fuente Roboto.
Ejemplo de CSS
Cuando se aplica al texto "Google", el siguiente código CSS renderizará "Google" con la fuente, el color y el espaciado adecuados sobre un fondo blanco o claro.
font-family: Roboto; font-style: normal; font-weight: 500; font-size: 16px; line-height: 16px; padding: 16px; letter-spacing: 0.0575em; /* 0.69px */ color: #5F6368;