Acerca de la API de Places (nuevo)

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

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

Place Details (New)

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 determinado iniciando una solicitud de Place Details (New). Una solicitud de Place Details (New) devuelve información exhaustiva sobre el lugar indicado, como su dirección completa, el número de teléfono, la calificación de usuarios y las opiniones.

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

Place Photo (nueva)

La API de Place Photo (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 Photo (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 Photo (nueva) deben incluir un nombre de recurso de foto, que identifica de forma única la foto que se mostrará. Puedes obtener el nombre del recurso de 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 (nueva) y Nearby Search (nueva)

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

  • Búsqueda de texto (nueva)

    Te permite especificar una cadena de texto en la que buscar un lugar. Por ejemplo: "Comida vegetariana picante en Sydney, Australia" o "Buena comida de mariscos 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 orienten los resultados a 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 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 pizzas ubicado en un centro comercial de 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 realizar la búsqueda.

Autocomplete (nuevo) y tokens de sesión

Autocomplete (nuevo) es un servicio web que muestra predicciones de lugares y predicciones de 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 (nuevas) como sesiones. 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 para realizar la facturación correspondiente.

Nuevos campos, atributos y opciones de accesibilidad

La nueva API de Places incluye campos, atributos y opciones de accesibilidad nuevos 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 específicos para ciertas operaciones. Los horarios de atención secundarios son diferentes de los principales de una empresa. Por ejemplo, un restaurante puede especificar los horarios de atención para el servicio de autoservicio o de entrega a domicilio como sus horarios secundarios.
paymentOptions 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á. Las opciones incluyen las siguientes:
  • Tarjeta de crédito
  • Tarjeta de débito
  • Solo dinero en efectivo
  • Pago con NFC
parkingOptions Opciones de estacionamiento proporcionadas por el lugar Las opciones incluyen las siguientes:
  • Estacionamientos gratuitos
  • Estacionamientos pagados
  • Estacionamiento gratuito en la calle
  • Servicio de estacionamiento
  • Estacionamiento en cochera gratuito
  • Estacionamiento en cochera de pago
subDestinations Son lugares únicos que se relacionan 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 estación de servicio 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 Cantidad de cargadores de vehículos eléctricos (VE) en esta estación. Si bien algunos cargadores de VE tienen varios conectores, cada uno 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 Es una dirección corta y legible por humanos de un lugar.
primaryType Es el tipo principal del resultado determinado. Por ejemplo, un lugar puede clasificarse 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 al 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 tiene asientos al aire libre.
liveMusic El lugar ofrece música en vivo.
menuForChildren El lugar tiene un menú infantil.
servesCocktails El lugar sirve cocteles.
servesDessert El lugar sirve postres.
servesCoffee El lugar sirve café.
goodForChildren El lugar es bueno 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 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.

Cómo migrar a las nuevas APIs de Places

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