Acerca de las nuevas APIs de Places

La nueva API de Places incluye las siguientes API:

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

API de Place Details

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 lugar de interés en particular si inicias una solicitud de Place Details (nuevo). Una solicitud de Place Details (nuevo) 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.

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

API de Place Photo

La API de Place Photo (New) te permite agregar contenido fotográfico de alta calidad a tu aplicación, ya que te brinda acceso a las millones de fotos almacenadas en la base de datos de Google Places. Con la API de Place Photos (nuevo), puedes acceder a las fotos y cambiar el tamaño de la imagen al tamaño óptimo para tu aplicación.

Todas las solicitudes a la API de Place Photos (nuevo) deben incluir un nombre de recurso de foto, que identifique de manera única la foto que se mostrará. Puedes obtener el nombre del recurso de fotos utilizando:

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

Text Search y Nearby Search

La API de Places incluye dos API de búsqueda:

  • Text Search (nuevo)

    Te permite especificar una cadena de texto en la que buscar un lugar. Por ejemplo: “Comida vegetariana picante en Sídney, Australia” o “Cena de mariscos cerca de Palo Alto, California”.

    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 personalicen los resultados según una ubicación específica o que se restrinja la búsqueda a una ubicación específica.

  • Nearby Search (nuevo)

    Te permite especificar una región para realizar la búsqueda 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 definen las características del lugar. Por ejemplo, especifica "pizza_restaurant" y "shopping_mall" para buscar una pizzería ubicada en un centro comercial en la región especificada.

La principal diferencia entre las dos búsquedas es que Text Search (nuevo) te permite especificar una cadena de búsqueda arbitraria, mientras que Nearby Search (nueva) requiere un área específica para la búsqueda.

API de Autocomplete y tokens de sesión

La API de Autocomplete (nuevo) es un servicio web que muestra predicciones de lugares y consultas en 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 de Autocomplete (nuevo) como sesiones. La función Autocomplete (nuevo) usa tokens de sesión para agrupar las fases de consulta y selección de la búsqueda con autocompletado de un usuario en una sesión discreta con fines de facturación.

Nuevos campos, atributos y opciones de accesibilidad

La API de Places (versión nueva) incluye campos, atributos y opciones de accesibilidad nuevos para brindar a los usuarios más información sobre un lugar. Estos aspectos se describen en las siguientes secciones.

Campos

La API de Places (versión nueva) incluye varios campos nuevos:

Campo Descripción
regularSecondaryOpeningHours Describe horarios particulares para ciertas operaciones. El horario de atención secundario es diferente del horario de atención principal de una empresa. Por ejemplo, un restaurante puede especificar el horario de atención desde el automóvil o los horarios de entrega a domicilio 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, no se establecerá el campo de opción de pago. Se incluyen las siguientes opciones:
  • Tarjeta de crédito
  • Tarjeta de débito
  • Solo dinero en efectivo
  • pago NFC
parkingOptions Las opciones de estacionamiento que ofrece el lugar. Se incluyen las siguientes opciones:
  • Estacionamientos gratuitos
  • Estacionamientos pagados
  • Estacionamiento gratuito en la calle
  • Servicio de estacionamiento
  • Estacionamiento gratuito en cochera
  • Estacionamiento en cochera pagado
subDestinations Son lugares únicos relacionados con un lugar en particular. Por ejemplo, las terminales de aeropuertos se consideran subdestinos de un aeropuerto.
fuelOptions La información más reciente sobre las opciones de combustible disponibles en una gasolinera. Esta información se actualiza con regularidad. Se incluyen las siguientes opciones:
  • Diésel
  • Normal sin plomo
  • Midgrade (89 octanos)
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • GLP
  • E80
  • E85
  • Metano
  • Biocombustible
  • Camión diésel
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 puede cargar solo un vehículo a la vez. Como resultado, este campo refleja la cantidad de cargadores de VE disponibles en un momento determinado.
shortFormattedAddress Es la dirección de un lugar breve y legible por humanos.
primaryType Es el tipo principal del resultado proporcionado. Por ejemplo, un lugar puede clasificarse como cafe o airport. Un lugar solo puede tener un único tipo principal. Para obtener la lista completa de los 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 (versión nueva) incluye varios atributos nuevos:

Atributo Descripción
outdoorSeating Lugar con asientos al aire libre.
liveMusic Lugar ofrece música en vivo.
menuForChildren El lugar tiene un menú para niños.
servesCocktails Lugar donde se sirven cocteles.
servesDessert Lugar donde se sirven postres.
servesCoffee Lugar donde se sirve café.
goodForChildren Este lugar es apto para niños.
allowsDogs El lugar admite perros.
restroom El lugar tiene sanitario.
goodForGroups El lugar tiene capacidad para grupos.
goodForWatchingSports El lugar es apto para mirar deportes.

Opciones de accesibilidad

La API de Places (versión 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 sanitarios con acceso para personas en silla de ruedas.
wheelchairAccessibleSeating El lugar tiene asientos accesibles para personas en silla de ruedas.

Cómo migrar a las nuevas APIs de Places

Si ya eres cliente de la API de Places y quieres migrar tu app para usar las nuevas APIs, consulta la siguiente documentación de migración: