En este documento, se enumeran los requisitos específicos de todas las aplicaciones desarrolladas con la API de Places (nuevo), incluido el servicio Autocomplete (nuevo) 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.
Políticas
En esta sección, se describen las políticas pertinentes para la API de Places. Las políticas proporcionan lineamientos y requisitos de implementación prácticos para ayudarte a usar el Servicio correctamente 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 en
Consulta la guía sobre los IDs de lugar para saber cómo guardarlos, actualizarlos y administrarlos en la guía sobre los IDs de lugar.
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 funcionalidades. Antes de compilar con Google Maps Platform, revisa los siguientes términos e información específicos 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 aplican 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 a través de tus aplicaciones.
Cómo mostrar la atribución de Google Maps
Debes seguir los requisitos de atribución de Google Maps cuando muestres Contenido de Google Maps Platform APIs en tu app o sitio web. No es necesario agregar una atribución adicional si el Contenido se muestra en un mapa de Google en el que la atribución ya es visible.
Atribución de Google Maps incluida
Para la atribución de Google Maps que Google Maps Platform ya proporciona en la interfaz de usuario, como en el kit de IU de Places, haz lo siguiente:
- No quites la atribución incluida, sin importar dónde se muestre. No alteres, ocultes ni oscurezcas la atribución, y asegúrate de que sea claramente visible en el fondo.
- Siempre distingue visualmente el Contenido de Google Maps Platform de otro contenido usando indicadores de 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.
Atribución de texto y logotipo de Google Maps
La atribución debe tomar la forma del logotipo de Google Maps siempre que sea posible. En los casos en que el espacio sea limitado, el texto Google Maps es aceptable. Siempre debe quedar claro para los usuarios finales qué contenido proporciona Google Maps.
Atribución del logotipo
Sigue estos requisitos para usar el logotipo de Google Maps en tu app o sitio web.
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.
Descarga los recursos de atribución de Google MapsCuando 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 la distorsión.
- Usa el logotipo con contorno en un fondo cargado, como un mapa o una imagen.
- Usa el logotipo sin contorno en un fondo simple, como un color sólido o un degradado sutil.
Especificación del tamaño del logotipo
Sigue estas especificaciones de tamaño para el logotipo de Google Maps:- Altura mínima del logotipo: 16 dp
- Altura máxima del logotipo: 19 dp
- Espacio libre mínimo del logotipo: 10 dp a la izquierda, a la derecha y en la parte superior, y 5 dp en la parte inferior
Para obtener información sobre dp, consulta Densidad de píxeles en el sitio web de Material Design.
Accesibilidad del logotipo
Sigue estos requisitos de accesibilidad para el logotipo de Google Maps:- 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. Sigue estos lineamientos:
- No modifiques el texto Google Maps de ninguna manera:
- No cambies el uso de mayúsculas y minúsculas de Google Maps.
- No ajustes Google Maps en varias líneas.
- No localices Google Maps en otro idioma.
- Evita que los navegadores traduzcan Google Maps usando el atributo HTML
translate="no".
Aplica el estilo al texto de Google Maps como se describe en la siguiente tabla:
Requisitos de estilo de texto de Google Maps Propiedad Estilo Familia de fuentes Roboto. Cargar la fuente es opcional. Familia de fuentes de resguardo Cualquier fuente de cuerpo Sans Serif 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 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
Sigue estos requisitos para el tratamiento visual de la atribución de Google Maps.Posiciona 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 posicionar a la derecha o a la izquierda.
Distingue visualmente el Contenido de Google Maps Platform de otro contenido usando indicadores de IU, como un borde, un color de fondo, una sombra o un espacio en blanco suficiente.
- No tergiverses Google Maps atribuyéndolo con 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 imágenes, 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 debe incluir el nombre "Google Maps" y los proveedores de datos pertinentes, como "Datos del mapa: Google, Maxar Technologies." No se considera una atribución adecuada incluir solo "Google Maps" o el logotipo de Google cuando Google proporciona la atribución de terceros.
Otros requisitos de atribución
Los siguientes requisitos de atribución son específicos de la API de Places.
Autocompletado para direcciones de usuarios finales
Cuando un usuario final usa la funcionalidad de Autocomplete en tu Aplicación del Cliente para escribir una dirección y esa dirección hubiera sido proporcionada de forma completa y precisa por ese usuario final sin Autocomplete, 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 solo se aplica 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 funcionalidad de Autocomplete ni a otro Contenido de Google Maps. Esta excepción no se aplica a ninguna funcionalidad de búsqueda de PDI o direcciones que ofrecen otros Servicios de Google Maps Platform.
En la imagen anterior, la lista de direcciones de la izquierda aún está 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.
Atribuciones de terceros
Sigue estas instrucciones para recuperar y mostrar atribuciones de terceros en tu aplicación.
Cómo recuperar las atribuciones de un lugar
Si tu aplicación muestra información que se obtiene llamando a Place Details con un ID de lugar, la aplicación también deberá mostrar las atribuciones de terceros que correspondan a los detalles del lugar.
Las atribuciones en el
Place
objeto de una respuesta se representan con un
Attribution
objeto. Para agregar el 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.
Los detalles sobre la foto en un
Place
objeto de una respuesta se encuentran en el photos array. Para agregar el photos
array 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 photos array es una instancia de
Photo,
que contiene el authorAttributions array, de 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 Place
objeto en una respuesta puede contener hasta cinco opiniones. De manera opcional, puedes mostrar estas 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:
Google también recomienda que muestres cómo se ordenan las opiniones al usuario final.
Cada opinión en un
Place
objeto de una respuesta se representa con un
Review
objeto. Para agregar el Review objeto 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 atribuciones para mostrar.
Atribuciones de resultados de la búsqueda
En Europa, cuando se usa la clasificación no adulterada 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 encontrar los mejores resultados para tu búsqueda.
Botón 1: Más información
"El texto "Más información" debe vincularse 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:
- Mostrar 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.
Mostrar el texto de divulgación de los resúmenes potenciados por IA
Cuando muestres un resumen potenciado por IA de cualquier tipo, siempre incluye el texto de divulgación localizado (que se proporciona 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 los resúmenes de lugares y áreas
Los resúmenes delugares y áreas que se muestran en tu app deben estar acompañados del siguiente texto y los vínculos requeridos:
| Texto | Requisito |
|---|---|
| Acerca de este resumen | Usa el siguiente vínculo a "Cómo Google obtiene y usa la información en las fichas locales": 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 (nuevo) 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 denunciarlo con la URL de contenido denunciado proporcionada ( |
Requisitos de los resúmenes de opiniones
Los resúmenes de opiniones que se muestran en tu app deben estar acompañados de un encabezado con el texto "Resumen de opiniones". Además, debes usar el siguiente texto y los vínculos requeridos:
| Texto | Requisito |
|---|---|
| Acerca de este resumen | Usa el siguiente vínculo a "Cómo Google obtiene y usa la información en las fichas locales": 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 (nuevo) 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 denunciarlo con la URL de contenido denunciado proporcionada ( |
| Ver opiniones | Usa el vínculo que se incluye en el campo reviewSummary.reviewsUri de la respuesta. |
Orientación para mostrar casos de uso automotriz
Para la seguridad del conductor, Google recomienda renderizar resúmenes potenciados por IA en el modo estacionado para experiencias automotrices. Si renderizas 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 de fuente mínimo de 24 dp
En especial en contextos automotrices, es responsabilidad del desarrollador renderizar resúmenes potenciados por IA de maneras seguras y que cumplan con todas las leyes y reglamentaciones locales.