La API de Places (nueva) incluye las siguientes APIs:
- Place Details (nuevo)
- Place Photo (nuevo)
- Nearby Search (nuevo)
- Text Search (nueva)
- Autocompletar (nuevo)
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.
Existen muchas maneras de obtener un ID de lugar. Puedes usar:
- Text Search (nueva)
- Nearby Search (nuevo)
- API de Geocoding
- API de Routes
- API de Address Validation
- Place Autocomplete
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 (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 (nuevo) deben incluir un nombre de recurso de foto. que identifica de forma exclusiva 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:
-
Te permite especificar una cadena de texto en la que 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 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.
-
Te permite especificar una región para buscar 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 lugar. 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 una etiqueta 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 una cadena de búsqueda textual 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. 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 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 se describen 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 desde el automóvil o la entrega como su horario secundario. |
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á. Entre las opciones, se incluyen las siguientes:
|
parkingOptions |
Opciones de estacionamiento proporcionadas por el lugar Las opciones incluyen las siguientes:
|
subDestinations |
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
estación de servicio. Esta información se actualiza con regularidad. Las opciones incluyen las siguientes:
|
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 dado. Por ejemplo, un lugar puede
debe clasificarse como cafe o airport. Un lugar 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 |
El lugar sirve cocteles. |
servesDessert |
Lugar donde se sirven postres. |
servesCoffee |
El lugar 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 |
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 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: