Referencia
Datos y privacidad
De dónde vienen los lugares, qué guardamos y por cuánto tiempo, y cómo cualquier persona puede pedir que se elimine algo.
De dónde vienen los lugares
Cada lugar es una ficha de negocio que cualquiera puede ver en Google Maps. Recopilamos fichas cuando alguien pide una zona que no hemos buscado hace poco, y las guardamos, para que la siguiente búsqueda ahí responda al instante. Solo leemos lo que una ficha muestra a cualquiera, y nunca iniciamos sesión en Google.
gmaps.dev no está afiliado a Google ni a Alphabet. Esta no es la API de Google.
Qué guardamos
De cada lugar, lo que muestra su ficha:
- Su nombre, categoría, descripción y estado, como “Cerrado permanentemente”.
- Su dirección, coordenadas, plus code y zona horaria.
- Sus teléfonos y su sitio web.
- Su calificación, cuántas reseñas tiene y cuántas dieron cada estrella, su horario de atención y cuándo suele haber más gente.
- Su rango de precios, las tarjetas que acepta, las características que enumera (como acceso para sillas de ruedas) y sus enlaces de menú, pedidos y reservas.
- Sus ids de Google, el enlace a su ficha en Google Maps, y cuándo lo vimos por primera vez y cuándo lo recopilamos por última vez.
En los planes de pago, también correos electrónicos. Los buscamos en el sitio web del propio negocio, solo cuando un cliente lo pide, y los mostramos únicamente a cuentas de pago que aceptaron la política de uso aceptable.
Nunca guardamos el texto de las reseñas, los nombres de quienes reseñan, fotos, imágenes de Street View ni el perfil del propietario. Se descartan antes de guardar nada.
Lugares describe cada campo.
Por qué una búsqueda se detiene en 120 lugares
Google Maps muestra unos 120 lugares por búsqueda, sin importar el tamaño de la zona. Por eso una búsqueda (POST /v1/places/search) devuelve 120 lugares como máximo y nunca recopila más que eso.
Para obtener más, usa una recopilación. Divide la zona en cuadros pequeños y busca en cada uno, por cada término, así que una ciudad entera son muchas búsquedas pequeñas en lugar de una grande. Define cuántos lugares quieres con maxPlaces, hasta el máximo de lugares por recopilación de tu plan, en Límites. Recopilaciones muestra cómo.
Vacío no significa que no haya nadie
Una respuesta vacía significa que todavía no encontramos lugares ahí, no que no existan. Quizá nadie buscó esa zona con esa palabra, o los negocios de ahí se describen con otras palabras.
Cuando buscamos en una zona y no encontramos nada, cuenta como buscada por solo 7 días. Después, la siguiente recopilación ahí vuelve a buscar. Una zona donde encontramos lugares cuenta como buscada por 180 días. Una recopilación que no encuentra nada no cuesta nada.
Para encontrar más, prueba otras palabras para lo mismo o una zona más grande.
Cuánto tiempo lo guardamos
| Qué | Cuánto tiempo |
|---|---|
| Lugares | Hasta que aceptamos una solicitud para eliminarlos. Cuando nuestra copia de una zona tiene más de 180 días, la siguiente recopilación ahí la actualiza. |
| Una zona donde una búsqueda no encontró nada | 7 días. Después, la siguiente recopilación ahí vuelve a buscar. |
| Los lugares de una recopilación y su registro de progreso | 30 días desde que la empiezas. Los conteos y los cobros de la recopilación se quedan. |
| Un enlace de exportación | 24 horas. El archivo se arma cuando abres el enlace, y nunca lo guardamos. |
| Registro de entregas de webhooks | 7 días. |
| Tu cuenta, después de eliminarla | 14 días, por si cambias de opinión. Después la borramos, junto con todo lo que le pertenece. Los registros de pago que la ley nos obliga a guardar se quedan, sin la cuenta. |
Las solicitudes de eliminación no vencen, así que lo eliminado sigue fuera. La política de privacidad explica las copias de seguridad y el resto.
Solicitudes de eliminación
Cualquier persona puede pedirnos que eliminemos un lugar, un teléfono, un correo electrónico o un sitio web con el formulario de eliminación. No necesita cuenta y no cuesta nada. La persona confirma por correo y alguien de nuestro equipo revisa la solicitud.
- Un lugar: se elimina el lugar completo.
- Un teléfono o un correo electrónico: lo quitamos de todos los lugares que lo muestran. Los lugares se quedan.
- Un sitio web: quitamos el sitio web, y todos los correos electrónicos de ese dominio, de todos los lugares que los muestran.
Cuando aceptamos una solicitud, lo que nombra sale al instante de las búsquedas, las consultas de lugares, los lugares de las recopilaciones, el progreso en vivo y las exportaciones. Borramos nuestra copia guardada en menos de una hora y nunca la volvemos a guardar.
Los archivos exportados antes todavía lo tienen. Busca de nuevo en lugar de reutilizar un archivo antiguo.
Proyectos en los que nos basamos
GET /v1/attributions lista los proyectos de código abierto y los datos que usamos, con sus licencias y avisos. No necesita clave y no cuesta nada:
curl https://api.gmaps.dev/v1/attributionsTu parte
- Un lugar es una ficha de negocio, no un permiso para contactar a nadie. Antes de llamar, escribir o enviar un correo, revisa la ley de donde estás tú y de donde está el negocio.
- No contactes a quien pidió ser eliminado, ni siquiera desde un archivo que guardaste.
- Los correos electrónicos necesitan un plan de pago y que aceptes la política de uso aceptable.
- No uses nuestros resultados por sí solos para tomar una decisión con efectos legales o igual de graves sobre una persona, como negarle un préstamo o un trabajo.
La política de uso aceptable enumera lo que puedes y no puedes hacer. Los términos de servicio son el contrato, y la política de privacidad explica lo que hacemos con los datos sobre ti y sobre las personas en nuestros resultados.