Introducción
El formato de respuesta de las APIs de Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo) cambió con respecto al formato de las APIs heredadas. La principal diferencia radica en el formato del objeto Place que devuelve cada método, como se describe en Cambios en el objeto Place de la respuesta.
Además, los campos de nivel superior del objeto de respuesta también cambiaron para cada API. Consulta los siguientes vínculos:
- Cambios en la respuesta de la Búsqueda de texto
- Cambios en la respuesta de Nearby Search
- Cambios en la respuesta de Place Details
Cambios en el objeto Place de la respuesta
En esta tabla, se muestran los cambios en el nuevo objeto Place en la respuesta de Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo) en comparación con el objeto Place heredado.
El nuevo objeto de respuesta usa la notación camel para los nombres de los campos, contiene campos nuevos y cambia el nombre de algunos de los campos heredados.
| Campo | Objeto de la API de Places (heredada) | Objeto de la API de Places (nueva) | Notas |
|---|---|---|---|
| Componente de dirección | address_components |
addressComponents |
|
| Dirección con microformato de Place | adr_address |
adrFormatAddress |
|
| Estado de la empresa | business_status |
businessStatus |
|
| Horario de atención de la próxima semana | current_opening_hours |
currentOpeningHours |
|
| Resumen editorial | editorial_summary |
editorialSummary |
|
| Dirección con formato | formatted_address |
formattedAddress |
|
| Número de teléfono nacional | formatted_phone_number |
nationalPhoneNumber |
|
| Ubicación | geometry.location |
location |
|
| Viewport | geometry.viewport |
viewport |
|
| Atribuciones de lugares | html_attributions |
attributions |
Campo de nivel superior de la respuesta en las APIs heredadas |
| URL de ícono | icon |
Se quitó el elemento. Usa iconMaskBaseUri y iconBackgroundColor. Consulta Íconos de lugares para obtener más información. |
|
| Color de fondo del ícono | icon_background_color |
iconBackgroundColor |
|
| URL de la máscara del ícono | icon_mask_base_uri |
iconMaskBaseUri |
|
| Número de teléfono internacional | international_phone_number |
internationalPhoneNumber |
|
| Nombre del lugar del texto | name |
displayName |
Ahora se puede acceder al nombre de lugar de texto como displayName.text y a language como displayName.languageCode |
| Horario de apertura | opening_hours |
regularOpeningHours |
|
| Fotos | photos |
photos |
El formato de photos cambió en el nuevo objeto Place. Para obtener más información, consulta Cambios en las referencias de fotos. |
| ID de lugar | place_id |
id |
|
| Plus Code | plus_code |
plusCode |
|
| Nivel de precio | price_level |
priceLevel |
|
| Calificación | rating |
rating |
|
| Opiniones | reviews |
reviews |
|
| Horario de apertura secundario para la próxima semana a partir de hoy, con excepciones y todos los demás datos | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Tipos de lugares | types |
types |
|
| URL de Google Maps del lugar | url |
googleMapsUri |
|
| Cantidad de calificaciones de los usuarios | user_ratings_total |
userRatingCount |
|
| Compensación de UTC | utc_offset |
utcOffsetMinutes |
|
| Forma abreviada de la dirección, que incluye el nombre de la calle y la ciudad | vicinity |
shortFormattedAddress |
|
| Sitio web del lugar | website |
websiteUri |
|
| Información sobre accesibilidad para personas en silla de ruedas | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance ahora está en
accessibilityOptions.wheelchairAccessibleEntrance |
| Atributos de lugares | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Nombre del recurso | Campo name con el formato places/PLACE_ID |
En la API heredada, el campo name contenía el nombre del lugar como una cadena de texto. En la nueva API, esa información se encuentra en displayName. |
|
| Tipo principal de lugar | primaryTypeName |
Nuevo | |
| Coloca el tipo principal como una cadena de texto | primaryTypeDisplayName |
Nuevo | |
| Horario de apertura secundario semanal habitual, con excepciones y todos los demás datos | regularSecondaryOpeningHours |
Nuevo | |
| Opciones de pago que acepta el lugar | paymentOptions |
Nuevo | |
| Opciones de estacionamiento en lugares | parkingOptions |
Nuevo | |
| Lista de subdestinos relacionados con el lugar | subDestinations |
Nuevo | |
| La información más reciente sobre las opciones de combustible en una estación de servicio | fuelOptions |
Nuevo | |
| Información sobre la carga de VE para un lugar | evChargeOptions |
Nuevo | |
| Atributos de lugares | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nuevo |
Cambios en la respuesta de Text Search
En la siguiente tabla, se muestran los cambios en los campos de nivel superior del objeto de respuesta de Text Search (Legacy) y el objeto de respuesta de Text Search (nuevo). En la nueva API, el único campo de nivel superior en la respuesta es el array places.
| Campo | Text Search (heredada) | Text Search (nueva) | Notas |
|---|---|---|---|
| Atribuciones de lugares | html_attributions |
Se trasladó al nuevo objeto Place para cada lugar como place.attributions |
|
| Es un array de lugares. | Array results del objeto Place heredado |
Es un array places del nuevo objeto Place. |
|
| Estado de la solicitud | status |
Se trasladó a la respuesta HTTP estándar (código y mensaje de respuesta HTTP). | |
| Cualquier mensaje de error | error_message |
Se trasladó a la respuesta HTTP estándar (código y mensaje de respuesta HTTP). | |
| Cualquier mensaje informativo | info_messages |
Quitada | |
| Token de página | next_page_token |
Quitada |
Cambios en la respuesta de Nearby Search
En la siguiente tabla, se muestran los cambios en los campos de nivel superior del objeto de respuesta de Nearby Search (heredado) y el objeto de respuesta de Nearby Search (nuevo). En la nueva API, el único campo de nivel superior en la respuesta es el array places.
| Campo | Nearby Search (heredado) | Nearby Search (nuevo) | Notas |
|---|---|---|---|
| Atribuciones de lugares | html_attributions |
Se trasladó al nuevo objeto Place para cada lugar como place.attributions |
|
| Es un array de lugares. | Array results del objeto Place heredado |
Array places del nuevo objeto Place |
|
| Estado de la solicitud | status |
Se trasladó a la respuesta HTTP estándar (código y mensaje de respuesta HTTP). | |
| Cualquier mensaje de error | error_message |
Se trasladó a la respuesta HTTP estándar (código y mensaje de respuesta HTTP). | |
| Cualquier mensaje informativo | info_messages |
Quitada | |
| Token de página | next_page_token |
Quitada |
Cambios en la respuesta de Place Details (nuevo)
En la siguiente tabla, se muestran los cambios en los campos de nivel superior del objeto de respuesta de Place Details (legado) y el objeto de respuesta de Place Details (nuevo). En la nueva API, el único campo de nivel superior en la respuesta es el array places.
| Campo | Place Details (Legacy) | Place Details (nuevo) | Notas |
|---|---|---|---|
| Atribuciones de lugares | html_attributions |
Se trasladó al nuevo objeto Place como attributions |
|
| Place Details (nuevo) | result que contiene el objeto Place heredado |
El nuevo objeto Place | |
| Estado de la solicitud | status |
Se trasladó a la respuesta HTTP estándar (código y mensaje de respuesta HTTP). | |
| Cualquier mensaje informativo | info_messages |
Se trasladó a la respuesta HTTP estándar (código y mensaje de respuesta HTTP). |