Acerca de la API de Places (nuevo)

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

Este documento contiene una descripción general de estas nuevas APIs.

Place Details (nuevo)

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 sitio, puedes solicitar detalles sobre un establecimiento o lugar de interés mediante el inicio de una solicitud de Place Details (nuevo) para cada solicitud. Una solicitud de Place Details (nuevo) devuelve información exhaustiva acerca de el lugar indicado, como su dirección completa, número de teléfono, calificación de los usuarios y las revisiones por pares.

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

Place Photo (nuevo)

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

Todas las solicitudes a la API de Place Photo (nuevo) deben incluir un nombre de recurso de foto. que identifica de forma exclusiva la foto que se mostrará. Puedes obtener el recurso de fotos usando lo siguiente:

Para incluir el nombre del recurso de foto en la respuesta de un Place Details (nuevo), sigue estos pasos: solicitud de 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:

  • Text Search (nueva)

    Te permite especificar una cadena de texto en la que deseas buscar un lugar. Por ejemplo: “Comida vegetariana picante en Sídney, Australia” o "marisquería fina cerca de Palo Alto, CA”.

    Puedes definir mejor la búsqueda especificando detalles como los niveles de precios, el estado de apertura actual, las clasificaciones o los tipos de lugares específicos. También puedes especificar para personalizar 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 realizar la búsqueda junto con una lista de tipos de lugares. Especificar la región como un círculo definido por la latitud y la longitud coordenadas del punto central y el radio en metros.

    Especifica uno o más tipos de lugares que definan las características del en un lugar específico. Por ejemplo, especifica "pizza_restaurant" y "shopping_mall" a Buscar una pizzería ubicada en un centro comercial de la zona especificada región.

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 (nuevo) requiere un en la que buscar.

Autocomplete (nuevo) y tokens de sesión

Autocomplete (nuevo) es un servicio web que devuelve predicciones de lugares y predicciones de consultas en respuesta a una solicitud HTTP. En la solicitud, especifica un texto cadena de búsqueda y límites geográficos que controlan 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 (nuevo) como sesiones. Autocomplete (nuevo) usa tokens de sesión para agrupar la consulta y de una búsqueda de autocompletado del usuario en una sesión discreta para facturación.

Nuevos campos, atributos y opciones de accesibilidad

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

Campos

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

Campo Descripción
regularSecondaryOpeningHours Describe horas particulares para ciertas operaciones. Secundaria el horario de atención es diferente del horario principal de una empresa. Para por ejemplo, un restaurante puede especificar el horario de atención o las entregas a domicilio como su horario secundario.
paymentOptions Opciones de pago que acepta el lugar. Un lugar puede aceptar más de una opción de pago. Si los datos sobre las opciones de pago no están disponibles, el no se establecerá el campo de opción de pago. Entre las opciones, se incluyen las siguientes:
  • Tarjeta de crédito
  • Tarjeta de débito
  • Solo dinero en efectivo
  • pago NFC
parkingOptions Las opciones de estacionamiento que ofrece el lugar. Entre las opciones, se incluyen las siguientes:
  • Estacionamientos gratuitos
  • Estacionamientos pagados
  • Estacionamiento gratuito en la calle
  • Servicio de estacionamiento
  • Estacionamiento gratuito en cochera
  • Estacionamiento pagado en cochera
subDestinations Lugares únicos relacionados con un lugar en particular Para ejemplo, las terminales de aeropuertos se consideran subdestinos de una aeropuerto.
fuelOptions La información más reciente sobre opciones de combustible disponibles en estación de servicio. Esta información se actualiza con regularidad. Se incluyen las siguientes opciones: lo siguiente:
  • 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. Mientras que algunos cargadores de VE tienen varios conectores, y cada cargador solo puede cargar un vehículo a la vez como resultado, este campo refleja cantidad de cargadores de VE disponibles en un momento determinado.
shortFormattedAddress Una dirección corta y legible por humanos de un lugar.
primaryType Es el tipo principal del resultado dado. Por ejemplo, un lugar puede debe clasificarse como cafe o airport. R solo puede tener un tipo principal. Para obtener la lista completa valores posibles, consulta Tipos admitidos.
primaryTypeDisplayName El nombre visible del tipo principal, localizado para la solicitud idioma si corresponde. Para obtener una lista completa de los valores posibles, consulta Tipos admitidos.

Atributos

La API de Places (nueva) incluye varios atributos nuevos:

Atributo Descripción
outdoorSeating El lugar cuenta con asientos al aire libre.
liveMusic El 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 en el que se sirve café.
goodForChildren El lugar es apto para niños.
allowsDogs El lugar admite perros.
restroom El lugar tiene un sanitario.
goodForGroups El lugar tiene capacidad 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 Este 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 accesibles para personas en silla de ruedas.
wheelchairAccessibleSeating Lugar con espacio accesible para personas en silla de ruedas.

Migra a las nuevas APIs de Places

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