Introducción
La API de Places (nueva) incluye las siguientes APIs:
- Place Details (nueva)
- Place Photos (nueva)
- Nearby Search (nueva)
- Text Search (nueva)
- Autocomplete (nueva)
Este documento contiene una descripción general de estas nuevas APIs.
Place Details (nueva)
Un ID de lugar identifica de forma exclusiva un sitio en la base de datos de Google Places y en Google Maps. Con un ID de lugar, puedes solicitar detalles sobre un establecimiento o punto de interés en particular iniciando una solicitud de Place Details (nueva). Una solicitud de Place Details (nueva) muestra información completa sobre el lugar indicado, como su dirección completa, número de teléfono, calificación de los usuarios y opiniones.
Hay muchas formas de obtener un ID de lugar. Puedes usar lo siguiente:
- Text Search (nueva)
- Nearby Search (nueva)
- API de Geocoding
- API de Routes
- API de Address Validation
- Autocomplete (nueva)
Place Photos (nueva)
Place Photos (nueva) te permite agregar contenido fotográfico de alta calidad a tu aplicación, ya que te brinda acceso a los millones de fotos almacenadas en la base de datos de Google Places. Con la API de Place Photos (nueva), puedes acceder a las fotos y cambiar el tamaño de la imagen al más adecuado para tu aplicación.
Todas las solicitudes a la API de Place Photos (nueva) deben incluir un nombre de recurso de foto, que identifica de forma exclusiva la foto que se debe mostrar. Puedes obtener el nombre de recurso de foto con lo siguiente:
Para incluir el nombre de recurso de foto en la respuesta de una solicitud de Place Details (nueva), Text Search (nueva) o Nearby Search (nueva), asegúrate de incluir el campo photos en la máscara de campo de la solicitud.
Text Search (nueva) y Nearby Search (nueva)
La API de Places incluye dos APIs de búsqueda:
-
Te permite especificar una cadena de texto en la que se buscará un lugar. Por ejemplo: "Comida vegetariana picante en Sídney, Australia" o "Restaurantes de mariscos cerca de Palo Alto, CA".
Puedes definir mejor la búsqueda especificando detalles como niveles de precios, estado de apertura actual, calificaciones o tipos de lugares específicos. También puedes especificar que se sesguen los resultados hacia una ubicación específica o restringir la búsqueda a una ubicación específica.
-
Te permite especificar una región para buscar junto con una lista de tipos de lugares. Especifica la región como un círculo definido por las coordenadas de latitud y longitud del punto central y el radio en metros.
Especifica uno o más tipos de lugares que definan las características del lugar. Por ejemplo, especifica "
pizza_restaurant" y "shopping_mall" para buscar un restaurante de pizza ubicado en un centro comercial en la región especificada.
La principal diferencia entre las dos búsquedas es que Text Search (nueva) te permite especificar una cadena de búsqueda arbitraria, mientras que Nearby Search (nueva) requiere un área específica en la que se debe buscar.
Autocomplete (nueva) y tokens de sesión
Autocomplete (nueva) es un servicio web que muestra predicciones de lugares y predicciones de consultas como respuesta a una solicitud HTTP. En la solicitud, especifica una cadena de búsqueda de texto y límites geográficos que controlen el área de búsqueda.
Los tokens de sesión son cadenas generadas por el usuario que hacen un seguimiento de las llamadas a Autocomplete (nueva) como sesiones. Autocomplete (nueva) usa tokens de sesión para agrupar las etapas de consulta y selección de la búsqueda con autocompletado de un usuario en una sesión discreta para realizar la facturación correspondiente.
Nuevos campos, atributos y opciones de accesibilidad
La API de Places (nueva) incluye nuevos campos, atributos y opciones de accesibilidad para proporcionar a los usuarios más información sobre un lugar. Estos aspectos se describen en las siguientes secciones.
Campos
La API de Places (nueva) incluye varios campos nuevos:
| Campo | Descripción |
|---|---|
regularSecondaryOpeningHours |
Describe horarios específicos para ciertas operaciones. Los horarios de apertura secundarios son diferentes de los horarios principales de una empresa. Por ejemplo, un restaurante puede especificar horarios de servicio para llevar o de entrega como sus horarios secundarios. |
paymentOptions |
Opciones de pago que acepta el lugar. Un lugar puede aceptar más de
una opción de pago. Si los datos de la opción de pago no están disponibles, el
campo de la opción de pago no se establecerá. Las opciones incluyen lo siguiente:
|
parkingOptions |
Opciones de estacionamiento que proporciona el lugar. Las opciones incluyen lo siguiente:
|
subDestinations |
Lugares únicos que están relacionados con un lugar en particular. Por ejemplo, las terminales de aeropuertos se consideran destinos secundarios de un aeropuerto. |
fuelOptions |
La información más reciente sobre las opciones de combustible disponibles en una
estación de servicio. Esta información se actualiza con regularidad. Las opciones incluyen
lo siguiente:
|
evChargeOptions |
Cantidad de cargadores de vehículos eléctricos (VE) en esta estación. Si bien algunos cargadores de VE tienen varios conectores, cada cargador solo puede cargar un vehículo a la vez. Como resultado, este campo refleja la cantidad de cargadores de VE disponibles en un momento determinado. |
shortFormattedAddress |
Una dirección corta y legible para un lugar. |
primaryType |
El tipo principal del resultado determinado. Por ejemplo, un lugar puede
clasificarse como un cafe o un airport. Un
lugar solo puede tener un tipo principal. Para obtener la lista completa de
valores posibles, consulta Tipos admitidos. |
primaryTypeDisplayName |
El nombre visible del tipo principal, localizado en el idioma de la solicitud si corresponde. Para obtener la lista completa de valores posibles, consulta Tipos admitidos. |
Atributos
La API de Places (nueva) incluye varios atributos nuevos:
| Atributo | Descripción |
|---|---|
outdoorSeating |
El lugar ofrece asientos al aire libre. |
liveMusic |
El lugar ofrece música en vivo. |
menuForChildren |
El lugar tiene un menú para niños. |
servesCocktails |
El lugar sirve cócteles. |
servesDessert |
El lugar sirve postres. |
servesCoffee |
El lugar sirve café. |
goodForChildren |
El lugar es adecuado para niños. |
allowsDogs |
El lugar permite perros. |
restroom |
El lugar tiene un baño. |
goodForGroups |
El lugar admite grupos. |
goodForWatchingSports |
El lugar es adecuado para ver deportes. |
Opciones de accesibilidad
La API de Places (nueva) incluye los siguientes campos de opciones de accesibilidad:
| Campo | Descripción |
|---|---|
wheelchairAccessibleParking |
El lugar ofrece estacionamiento accesible para personas en silla de ruedas. |
wheelchairAccessibleEntrance |
El lugar tiene una entrada accesible para personas en silla de ruedas. |
wheelchairAccessibleRestroom |
El lugar tiene un baño accesible para personas en silla de ruedas. |
wheelchairAccessibleSeating |
El lugar tiene asientos accesibles para personas en silla de ruedas. |
Resúmenes potenciados por IA
Los resúmenes potenciados por IA de la API de Places (nueva) usan las capacidades del modelo Gemini para mostrar resúmenes sobre lugares y áreas que pueden ayudar a los usuarios a decidir a dónde ir.
Los resúmenes potenciados por IA sintetizan datos de una variedad de entradas para ayudar a los usuarios a tomar decisiones más fundamentadas sobre un lugar. Por ejemplo, si estás pensando en probar un restaurante nuevo, un resumen potenciado por IA puede mostrar los aspectos destacados del menú más comunes, darte una idea del ambiente o reunir temas de las opiniones de los usuarios. Si visitas una ciudad nueva, un resumen potenciado por IA puede proporcionar una descripción general de las atracciones y los servicios cercanos.
Funciones potenciadas por IA agregadas a la API de Places (nueva)
Place Details (nueva) , Text Search (nueva) y Nearby Search (nueva) admiten resúmenes potenciados por IA. Los siguientes resúmenes potenciados por IA están disponibles en las respuestas de la API de Places (nueva):
- Resúmenes de lugares, que son resúmenes breves relacionados con un lugar específico.
- Resúmenes de opiniones, que son resúmenes fáciles de entender de lo que los revisores dijeron sobre un lugar.
- Resúmenes de áreas, que proporcionan descripciones generales de los lugares cercanos y populares en el área circundante Estos incluyen resúmenes de vecindarios y resúmenes de estaciones de carga de VE
Google vuelve a generar estos resúmenes con frecuencia para garantizar que estén actualizados según la información más reciente disponible. Cuando realices una solicitud a la API de Places (nueva), mostrarás los datos más recientes en tu app.
Migra a las nuevas APIs de Places
Si ya eres cliente de la API de Places (nueva) y quieres migrar tu app para usar las nuevas APIs, consulta la siguiente documentación de migración:
- Migra a Place Details (nueva)
- Migra a Nearby Search (nueva)
- Migra a Text Search (nueva)
- Migra a Place Photos (nueva)
- Migra a Autocomplete (nueva)