La API de Places (nueva) es un servicio web que devuelve datos de ubicación en formato JSON sobre establecimientos, ubicaciones geográficas y lugares de interés. Admite Text Search (nuevo), Nearby Search (nuevo), Autocomplete (nuevo), Place Details (nuevo) y Place Photos (nuevo).
API de Places (nueva): Datos clave
- Producto: API de Places (nueva)
- También conocida como: API de Places
- Categoría: Lugares
- Plataforma: Servicio web (REST)
- Se ejecuta en: Servidor (código de backend)
- Etapa de lanzamiento: GA
- Ciclo de vida: Activo
- Descripción general: Descripción general de la API de Places (nueva)
- Disponibilidad regional: Global. Los proyectos con direcciones de facturación del EEE usan las Condiciones del Servicio de Google Maps Platform para el EEE (vigentes a partir del 8 de julio de 2025), en las que el contenido de la API de Places que no sea la latitud, la longitud y los IDs de lugar no se puede usar con ningún mapa, excepto a través del kit de IU de Places. Los resúmenes de lugares, opiniones y áreas potenciados por IA solo están disponibles en los idiomas y las regiones admitidos.
API de Places (nueva): Cuándo usarla
Usa la API de Places (nueva) en los siguientes casos:
- Necesitas buscar lugares desde un servidor con una búsqueda de texto (Text Search (nuevo)) o alrededor de una ubicación (Nearby Search (nuevo)).
- Necesitas predicciones de lugares o búsquedas de escritura anticipada de un backend a través de Autocomplete (nuevo).
- Tienes un ID de lugar y necesitas detalles, como la dirección, el número de teléfono, la calificación, las opiniones o las fotos.
- Necesitas resúmenes de lugares, opiniones o áreas potenciados por IA para un lugar.
No uses la API de Places (nueva) en los siguientes casos:
- Estás creando una app nativa para Android. En su lugar, usa el SDK de Places para Android.
- Estás compilando una app para iOS nativa. En su lugar, usa el SDK de Places para iOS.
- Estás compilando una app web para navegadores y quieres que la biblioteca de Places se cargue en JavaScript. En su lugar, usa la API de Maps JavaScript.
API de Places (nueva): Configuración
- Servicio que se habilitará:
places.googleapis.com - Autenticación: Clave de API, OAuth 2.0
- Comienza a usar la API de Places (nueva): Configura la API de Places (nueva)
- Referencia: Referencia de la API de Places (nueva)
- Precios: Uso y facturación de la API de Places (nueva)
- Políticas: Políticas de la API de Places (nueva)
- Notas de la versión: Notas de la versión de la API de Places (nueva)
Paquetes oficiales de la API de Places (nueva):
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
API de Places (nueva): Productos relacionados
- Reemplaza a: API de Places (heredada)
- Se suele usar con: API de Geocoding, API de Routes, API de Address Validation
API de Places (nueva): Errores comunes
- Problema: Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo) no tienen una lista predeterminada de campos devueltos; las solicitudes sin una máscara de campo devuelven un error. Solución: Pasa una máscara de campo de respuesta con el parámetro
fieldso$fields, o el encabezadoX-Goog-FieldMask. Consulta /maps/documentation/places/web-service/choose-fields. - Problema: Si se omite o se reutiliza el token de sesión de Autocomplete (nuevo) después de que concluye una sesión, cada solicitud se factura por separado como SKU: Autocomplete Requests. Solución: Genera un token de sesión nuevo (se recomienda UUID v4) para cada sesión y finalízala con una solicitud de Place Details (nuevo) o Address Validation. Consulta /maps/documentation/places/web-service/place-session-tokens.
- Problema: El código existente o generado por IA que llama a la API de Places (heredada) o a la API de Maps JavaScript
PlacesServiceen un proyecto sin la API heredada habilitada falla conLegacyApiNotActivatedMapError. Solución: Migra las llamadas a la API de Places (nueva) y, luego, incluye la máscara de campo obligatoria. Consulta /maps/legacy#LegacyApiNotActivatedMapError. - Problema: Los IDs de lugar almacenados pueden quedar obsoletos. En ese caso, Place Details (nuevo) devuelve
NOT_FOUND(HTTP 404), y los IDs con formato incorrecto o truncados devuelven HTTP 400INVALID_ARGUMENT. Solución: Actualiza los IDs de lugar almacenados que tengan más de 12 meses de antigüedad con una solicitud de Place Details (nueva) que solo pida el campoid(sin cargo). Consulta /maps/documentation/places/web-service/place-id#refresh-id.
Qué puedes hacer con la API de Places (nueva)
Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.
API de Places (nueva): IA generativa
- Devuelve un resumen potenciado por IA de las opiniones de los usuarios para un identificador de lugar de Google especificado.
- Devuelve un resumen de un lugar potenciado por IA del área y las comodidades que rodean un identificador de lugar de Google especificado para una estación de carga de vehículos eléctricos.
API de Places (nueva): Places
- Devuelve una lista de lugares y Place Details según una cadena de consulta.
- Devuelve una lista de lugares y Place Details cercanos a una ubicación específica.
- Devuelve resultados de autocompletado sobre lugares en función de una cadena de consulta.
- Devuelve información detallada sobre un lugar específico.
- Devolver fotos de un lugar específico Nota: Muestra las atribuciones del autor de cada foto (el nombre del autor, vinculado al URI de su perfil) junto con la foto. Las políticas de Places para cada plataforma lo requieren, por ejemplo, /maps/documentation/javascript/policies#photo-attributions y /maps/documentation/places/web-service/policies#photos-and-review.
- Cambiar el tamaño de las fotos de un lugar
- Devolver calificaciones y opiniones de un lugar específico Nota: En el servicio web de la API de Places (nueva), Place Details es una solicitud GET HTTP a https://places.googleapis.com/v1/places/{placeId} con X-Goog-FieldMask (por ejemplo, rating,userRatingCount,reviews); Text Search, Nearby Search y Autocomplete usan POST. En Android, pasa Place.Field.RATING, USER_RATING_COUNT y REVIEWS a PlacesClient.fetchPlace(). En iOS, pasa GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal y GMSPlacePropertyReviews en GMSFetchPlaceRequest.
- Especificar los campos de datos que se incluyen en las respuestas de información de lugares
- Especifica los tipos de lugares que se incluirán en las respuestas de información de lugares.
- Devuelve el URI para abrir la página de detalles de un lugar en Google Maps.
- Muestra el URI para abrir la página de instrucciones sobre cómo llegar a un lugar en Google Maps.
- Muestra el URI para abrir la página de escritura de opiniones en Google Maps para un lugar.
- Devuelve el URI para abrir la página de lectura de opiniones de un lugar en Google Maps.
- Devuelve el URI para abrir la página de fotos de un lugar en Google Maps.
- Devuelve un resumen de la Visión general creada por IA para un lugar específico.
- Devuelve un resumen del área potenciado por IA que describe los lugares que se encuentran alrededor de un lugar específico.
- Devuelve información sobre los lugares que se encuentran a lo largo de una ruta predefinida en función de una cadena de consulta.
- Devuelve la distancia, la duración del viaje y el URI de instrucciones sobre cómo llegar para buscar lugares con Text Search a partir de un conjunto de coordenadas de latitud y longitud.
- Devuelve la distancia, la duración del viaje y el URI de instrucciones sobre cómo llegar a lugares cercanos a partir de un conjunto de coordenadas de latitud y longitud.
- Devuelve la distancia, la duración del viaje y el URI de las instrucciones sobre cómo llegar entre el origen de una ruta predefinida y cada uno de los lugares que se devuelven en función de una cadena de consulta, que también se encuentran a lo largo de la ruta.
- Devuelve la distancia, la duración del viaje y el URI de las instrucciones sobre cómo llegar entre cada uno de los lugares que se muestran en función de una cadena de consulta, que también se encuentran a lo largo de una ruta predefinida, y el destino de la ruta.