Acerca de la API de Places (nuevo)

Desarrolladores del Espacio Económico Europeo (EEE)

Introducción

La API de Places (nueva) incluye las siguientes APIs:

En este documento, se incluye una descripción general de estas APIs nuevas.

Place Details (nuevo)

Un ID de lugar identifica de forma exclusiva un lugar 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 (nuevo). Una solicitud de Place Details (nuevo) devuelve información completa sobre el lugar indicado, como su dirección completa, número de teléfono, calificación de los usuarios y opiniones.

Existen muchas formas de obtener un ID de lugar. Puedes usar lo siguiente:

Place Photos (nuevo)

Place Photos (nuevo) 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 inequívoca la foto que se devolverá. Puedes obtener el nombre del recurso de la foto con lo siguiente:

Para incluir el nombre del recurso de foto en la respuesta de una solicitud de Place Details (nuevo), Text Search (nuevo) o Nearby Search (nuevo), asegúrate de incluir el campo photos en la máscara de campo de la solicitud.

Text Search (nuevo) y Nearby Search (nuevo)

La API de Places (nueva) incluye dos APIs de búsqueda:

  • Text Search (nuevo)

    Te permite especificar una cadena de texto en la que se buscará un lugar. Por ejemplo: "Comida vegetariana picante en Sídney, Australia" o "Restaurante de mariscos de lujo cerca de Palo Alto, California".

    Puedes definir mejor la búsqueda especificando detalles como los niveles de precios, el estado de apertura actual, las calificaciones o los tipos de lugares específicos. También puedes especificar que se sesguen los resultados para una ubicación específica o restringir la búsqueda a una ubicación específica.

  • Nearby Search (nuevo)

    Te permite especificar una región para buscar junto con una lista de tipos de lugar. 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 una pizzería ubicada en un centro comercial de la región especificada.

La principal diferencia entre ambas 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 realizar la búsqueda.

Autocomplete (nuevo) y tokens de sesión

Autocomplete (nuevo) es un servicio web que devuelve predicciones de lugares y de búsquedas en respuesta a una solicitud HTTP. En la solicitud, especifica una cadena de búsqueda de texto y los límites geográficos que controlan el área de búsqueda.

Los tokens de sesión son cadenas generadas por el usuario que realizan un seguimiento de las llamadas de Autocomplete (nuevo) como sesiones. Autocomplete (nuevo) 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 momentos particulares para ciertas operaciones. El horario de atención secundario es diferente del horario principal de una empresa. Por ejemplo, un restaurante puede especificar el horario de atención en el auto o el horario de entrega como su horario secundario.
paymentOptions Son las 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á. Estas son algunas de las opciones:
  • Tarjeta de crédito
  • Tarjeta de débito
  • Solo dinero en efectivo
  • pago NFC
parkingOptions Opciones de estacionamiento que ofrece el lugar. Estas son algunas de las opciones:
  • Estacionamientos gratuitos
  • Estacionamientos pagados
  • Estacionamiento gratuito en la calle
  • Servicio de estacionamiento
  • Estac. gratuito en cochera
  • Estac. pagado en cochera
subDestinations Son lugares únicos que se relacionan con un lugar en particular. Por ejemplo, las terminales de un aeropuerto se consideran destinos secundarios de ese aeropuerto.
fuelOptions Es la información más reciente sobre las opciones de combustible disponibles en una gasolinera. Esta información se actualiza con regularidad. Las opciones incluyen las siguientes:
  • Diésel
  • Sin plomo regular
  • Midgrade (89 octanos)
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • GLP
  • E80
  • E85
  • Metano
  • Biocombustible
  • Diésel para camiones
evChargeOptions Es la 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. Por lo tanto, este campo refleja la cantidad de cargadores de VE disponibles en un momento determinado.
shortFormattedAddress Es una dirección corta y legible por humanos para un lugar.
primaryType Es el tipo principal del resultado determinado. Por ejemplo, un lugar se puede clasificar como cafe o airport. Un lugar solo puede tener un tipo principal. Para obtener la lista completa de los valores posibles, consulta Tipos admitidos.
primaryTypeDisplayName Es el nombre visible del tipo principal, localizado en el idioma de la solicitud, si corresponde. Para obtener la lista completa de los valores posibles, consulta Tipos admitidos.
entrances Son las entradas del destino. Una entrada es un par de coordenadas de latitud y longitud que define la ubicación de un punto de entrada y salida de un lugar.
navigationPoints Son los puntos de navegación del destino. Un punto de navegación es una ubicación junto a una ruta en la que puede finalizar la navegación, incluidos los modos de viaje y los usos 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 En el lugar, se sirve café.
goodForChildren El lugar es ideal para niños.
allowsDogs Se permiten perros en el lugar.
restroom El lugar tiene un sanitario.
goodForGroups El lugar es apto para grupos.
goodForWatchingSports El lugar es adecuado para mirar 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 de Gemini para devolver resúmenes sobre lugares y áreas que pueden ayudar a los usuarios a decidir adó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 mostrarte los platos más populares del menú, darte una idea del ambiente o recopilar los temas de las opiniones de los usuarios. Si visitas una ciudad nueva, un resumen potenciado por IA puede proporcionarte una descripción general de las atracciones y comodidades cercanas.

Se agregaron funciones potenciadas por IA a la API de Places (nueva)

Los resúmenes potenciados por IA son compatibles con Place Details (nuevo), Text Search (nuevo) y Nearby Search (nuevo). 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 usuarios dijeron sobre un lugar.
  • Resúmenes de áreas, que proporcionan descripciones generales de los lugares cercanos y populares de los alrededores Esto incluye resúmenes de vecindarios y de estaciones de carga de VE.

Google vuelve a generar estos resúmenes con frecuencia para asegurarse de que estén actualizados en función de la información más reciente disponible. Cuando realices una solicitud a la API de Places (nueva), se mostrarán los datos más recientes en tu app.

Migra a la API de Places (nueva)

Si ya eres cliente de la API de Places (heredada) y quieres migrar tu app para usar la API de Places (nueva), consulta la siguiente documentación de migración: