El formato de la respuesta del nuevo
Place Details,
Nearby Search,
y
Text Search
Las APIs cambiaron el formato de las APIs existentes. La principal diferencia está en
el formato del objeto Place que muestra cada método, como se describe en
Cambios en el objeto Place de 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 Text Search
- Cambios en las respuestas de Nearby Search
- Cambios en las respuestas de Place Details
Cambios en el objeto Place de respuesta
En esta tabla, se muestran los cambios realizados en la nueva
Objeto Place
en la respuesta a Place Details (nuevo),
Nearby Search (nueva)
Text Search (nueva), en comparación con la versión existente
objeto Place.
El nuevo objeto de respuesta usa mayúsculas mediales para los nombres de campo, contiene campos nuevos y cambia el nombre de algunos campos existentes.
| Campo | Objeto Place existente | Nuevo objeto Place | Notas |
|---|---|---|---|
| Componente de dirección | address_components |
addressComponents |
|
| Dirección en formato microformato del lugar | 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 existentes |
| 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 language como displayName.languageCode. |
| Horario de apertura | opening_hours |
regularOpeningHours |
|
| Fotos | photos |
photos |
El formato de photos cambió en la nueva
Place. Para obtener más información, consulta Cómo cambiar a referencias de fotos. |
| ID de lugar | place_id |
id |
|
| Plus Code | plus_code |
plusCode |
|
| Nivel de precio | price_level |
priceLevel |
|
| Rating | rating |
rating |
|
| Opiniones | reviews |
reviews |
|
| Horario de atención secundario durante 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, incluido el nombre de la calle y el pueblo | vicinity |
shortFormattedAddress |
|
| Sitio web del lugar | website |
websiteUri |
|
| Información sobre la accesibilidad 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 existente, 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 atención secundario semanal habitual, con excepciones y todos los demás datos | regularSecondaryOpeningHours |
Nuevo | |
| Opciones de pago aceptadas por el lugar | paymentOptions |
Nuevo | |
| Opciones de estacionamiento | parkingOptions |
Nuevo | |
| Lista de subdestinos relacionados con el lugar | subDestinations |
Nuevo | |
| Información más reciente sobre las opciones de combustible en una gasolinera | fuelOptions |
Nuevo | |
| Información sobre la carga de VE de un lugar | evChargeOptions |
Nuevo | |
| Atributos de lugares | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nuevo |
Cambios en las respuestas de Text Search
En la siguiente tabla, se muestran los cambios en los campos de nivel superior del objeto de respuesta de la Búsqueda de texto existente y del objeto de respuesta de la Búsqueda de texto (nueva). Para la nueva API, el único campo de nivel superior en la respuesta
es el array places.
| Campo | Text Search (existente) | Text Search (nueva) | Notas |
|---|---|---|---|
| Atribuciones de lugares | html_attributions |
Se trasladó al nuevo objeto Place para cada lugar como place.attributions |
|
| Variedad de lugares | Array results del objeto Place existente |
Array places del nuevo objeto Place |
|
| Estado de la solicitud | status |
Se cambió 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 de información | 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 realizados en los campos de nivel superior de la respuesta
objeto
para la búsqueda de Nearby Search existente y la respuesta
objeto
para Nearby Search (nuevo). En el caso de la API nueva, el único campo de nivel superior en la respuesta es el array places.
| Campo | Búsqueda de lugares cercanos (existente) | Nearby Search (nuevo) | Notas |
|---|---|---|---|
| Atribuciones de lugares | html_attributions |
Se trasladó al nuevo objeto Place para cada lugar como place.attributions |
|
| Variedad de lugares | Array results del objeto Place existente |
Array places del nuevo objeto Place |
|
| Estado de la solicitud | status |
Se cambió 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 de información | info_messages |
Quitada | |
| Token de página | next_page_token |
Quitada |
Cambios en la respuesta de Place Details
En la siguiente tabla se muestran los cambios realizados en los campos de nivel superior de la respuesta
objeto
para los detalles de Place Details existentes y la respuesta
objeto
para Place Details (nuevo). En el caso de la API nueva, el único campo de nivel superior en la respuesta es el array places.
| Campo | Place Details (existente) | Place Details (New) | Notas |
|---|---|---|---|
| Atribuciones de lugares | html_attributions |
Se trasladó al nuevo Place.
objeto como attributions |
|
| Detalles del lugar | result, que contiene el objeto Place existente |
El nuevo objeto Place | |
| Estado de la solicitud | status |
Se trasladaron a la respuesta HTTP estándar (código y mensaje de respuesta HTTP) | |
| Cualquier mensaje de información | info_messages |
Se trasladaron a la respuesta HTTP estándar (código y mensaje de respuesta HTTP) |