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 más información general para los desarrolladores de Google Maps en las Condiciones del Servicio de Google Maps Platform.
Suministro de condiciones de uso y políticas de privacidad
Si desarrollas una aplicación de la API de Places, debes incluir en ella las Condiciones de Uso y una Política de Privacidad que cumpla con los lineamientos descritos en tu Acuerdo con Google:
- Las Condiciones de Uso y la Política de Privacidad deben ser de acceso público.
- En las Condiciones de Uso de la aplicación, debes indicar explícitamente que, cuando usas la aplicación, los usuarios están sujetos a las Condiciones del Servicio de Google.
- En tu Política de Privacidad, debes notificar a los usuarios que usas las APIs de Google Maps e incorporar como referencia la Política de Privacidad de Google.
El lugar recomendado para poner a disposición las Condiciones de Uso y la Política de Privacidad depende de la plataforma de tu aplicación.
Aplicación para dispositivos móviles
Si estás desarrollando una app para dispositivos móviles, se recomienda que proporciones un vínculo a las Condiciones de Uso y la Política de Privacidad en la página de descarga de tu app en la tienda de aplicaciones correspondiente y en el menú de configuración de la app.
Aplicaciones web
Si estás desarrollando una aplicación web, se recomienda que proporciones un vínculo a las Condiciones de Uso y la Política de Privacidad en el pie de página del sitio web.
Carga previa, almacenamiento en caché o almacenamiento de contenido
Las aplicaciones que usen la API de Places están sujetas a las condiciones de tu Acuerdo con Google. Sujeto a las condiciones de su Acuerdo, no debe recuperar previamente, indexar, almacenar ni almacenar en caché ningún Contenido, excepto bajo las condiciones limitadas que se indican en las condiciones.
Ten en cuenta que el ID de lugar, que se usa para identificar un lugar de forma única, está exento de las restricciones de almacenamiento en caché. El ID de lugar se muestra en el campo "place_id" de las respuestas de la API de Places. Obtén información para guardar, actualizar y administrar los IDs de lugar en la guía sobre IDs de lugar.
Cómo mostrar los resultados de la API de Places
Puedes mostrar los resultados de la API de Places en un mapa de Google Maps o sin un mapa. Si deseas mostrar los resultados de la API de Places en un mapa, estos deben aparecer en un mapa de Google Maps. Se prohíbe el uso de datos de la API de Places en un mapa que no sea de Google.
Muestra el logotipo de Google y las atribuciones
Si tu aplicación muestra datos en un mapa de Google Maps, el logotipo de Google se incluirá y es posible que no se modifique. Las aplicaciones que muestran datos de Google en la misma pantalla que un mapa de Google no necesitan proporcionar atribuciones adicionales a Google.
Si tu aplicación muestra datos en una página o una vista que no muestra también un mapa de Google, debes mostrar un logotipo de Google con esos datos. Por ejemplo, si tu aplicación muestra datos de Google en una pestaña y un mapa de Google con esos datos en otra, la primera pestaña debe mostrar el logotipo de Google. Si tu aplicación usa campos de búsqueda con o sin autocompletado, el logotipo debe mostrarse intercalado.
El logotipo de Google debe colocarse en la esquina inferior izquierda del mapa, con la información de atribución en la esquina inferior derecha. Ambos deben aparecer en el mapa como un conjunto y no debajo del mapa o de otro lugar de la aplicación. En el siguiente ejemplo de mapa, se muestra el logotipo de Google en la esquina inferior izquierda y la atribución en la esquina inferior derecha.
Para usar sobre un fondo claro | Para usar sobre un fondo oscuro |
---|---|
El siguiente archivo ZIP contiene el logotipo de Google en los tamaños correctos para aplicaciones de escritorio, de iOS y Android. No puedes cambiar el tamaño de estos logotipos ni modificarlos de ninguna manera.
Descargar: google_logo.zip
No modifiques la atribución. No quites, ocultes ni recortes la información de atribución. No puedes usar logotipos de Google intercalados (por ejemplo, "Estos mapas son de [Google_logo]").
La atribución se mantiene cerca. Si usas capturas de pantalla de imágenes de Google fuera de las incorporaciones directas, incluye la atribución estándar tal como aparece en la imagen. Si es necesario, puedes personalizar el estilo y la posición del texto de atribución, siempre que el texto se encuentre cerca del contenido y sea legible para el usuario o el lector promedio. No puedes alejar la atribución del contenido, por ejemplo, al final de tu libro, los créditos de tus archivos o programas, o el pie de página de tu sitio web.
Incluir proveedores de datos externos Algunos de los datos y las imágenes de nuestros productos de creación de mapas provienen de proveedores distintos de Google. Si usas esas imágenes, el texto de tu atribución debe decir "Google" y de los proveedores de datos relevantes, como "Datos del mapa: Google, Maxar Technologies". Cuando hay proveedores de datos externos citados con las imágenes, no se considera una atribución adecuada solo incluir "Google" o el logotipo de Google.
Si usas Google Maps Platform en un dispositivo en el que la visualización de atribución no es práctica, comunícate con el equipo de Ventas de Google para analizar las licencias adecuadas para tu caso de uso.
Otros requisitos de atribución
Sigue estas instrucciones para recuperar atribuciones de terceros y mostrarlas en tu app.
Recupera atribuciones de un lugar
Si tu app muestra información obtenida al llamar a Place Details con un ID de lugar, también debe mostrar atribuciones de terceros para los detalles del lugar que se obtuvieron.
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 el provider
y el providerUri
de la atribución, o una cadena vacía si no hay atribuciones para mostrar.
Cómo mostrar atribuciones de una foto
Si tu app muestra fotos, debes mostrar las atribuciones del autor para cada foto que las tenga.
Los detalles sobre la foto en un objeto Place
de una respuesta se encuentran 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 el displayName
, uri
y photoUri
de la atribución, o una cadena vacía si no hay atribuciones para mostrar.
Muestra una opinión
Un objeto Place
en una respuesta puede contener hasta cinco opiniones. De manera opcional, puedes mostrar estas opiniones en tu app.
Cuando muestres las opiniones aportadas por los usuarios de Google, debes colocar el nombre del autor cerca. Cuando esté disponible en el campo de atribución del autor del objeto Review
, te recomendamos que también incluyas la foto del autor y un vínculo a su perfil. 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 se representa con 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 ninguna atribución para mostrar.
Lineamientos de estilo para la atribución de Google
A continuación, se incluyen lineamientos de estilo para las atribuciones de Google en CSS y HTML si no puedes usar el logotipo descargable de Google.
espacio en blanco
La cantidad de espacio libre alrededor del diseño final debe ser igual o mayor que la altura de la "G" en Google.
El espacio entre la copia de atribución y el logotipo de Google debe ser la mitad del ancho de la "G".
Legibilidad
El pie de autor siempre debe ser claro, legible y aparecer con la variación de color correcta para un fondo determinado. Asegúrate siempre de proporcionar suficiente contraste para la variación del logotipo que selecciones.
Color
Usa el texto gris material de Google 700 sobre un fondo blanco o claro con un rango máximo de tono de negro de 0% a 40%.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
En fondos más oscuros y sobre fotografías o patrones no ocupados, usa texto blanco para la firma 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
El siguiente CSS, cuando se aplique al texto "Google", renderizaría "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;