El formato de respuesta de las nuevas APIs de Place Details, Nearby Search y Text Search cambió del formato de las APIs existentes. La diferencia principal se encuentra 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 la respuesta de la Búsqueda de Nearby
- Cambios en la respuesta de Place Details
Cambios en el objeto Place de 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 existente.
El nuevo objeto de respuesta usa mayúsculas y minúsculas para los nombres de campos, contiene campos nuevos y cambia el nombre de algunos de los campos existentes.
| Técnica | Objeto Place existente | Nuevo objeto Place | Notas |
|---|---|---|---|
| Componente de dirección | address_components |
addressComponents |
|
| Colocar dirección de microformato | adr_address |
adrFormatAddress |
|
| Estado de la empresa | business_status |
businessStatus |
|
| Horario de atención para 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 lugar | 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 lugar para obtener más información. |
|
| Color de fondo del ícono | icon_background_color |
iconBackgroundColor |
|
| URL de máscara de ícono | icon_mask_base_uri |
iconMaskBaseUri |
|
| Número de teléfono internacional | international_phone_number |
internationalPhoneNumber |
|
| Texto del nombre del lugar | name |
displayName |
Ahora se puede acceder al nombre del 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 el nuevo objeto Place. Para obtener más información, consulta Cómo cambiar las referencias de las 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 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 del lugar de Google Maps | 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, incluidos el nombre de la calle y el pueblo | vicinity |
shortFormattedAddress |
|
| Colocar sitio web | website |
websiteUri |
|
| Información sobre accesibilidad en silla de ruedas | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance ahora está en
accessibilityOptions.wheelchairAccessibleEntrance |
| Atributos de Places | 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 API nueva, esa información se encuentra en displayName. |
|
| Tipo principal de lugar | primaryTypeName |
Nuevo | |
| Colocar 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 que acepta 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 de una gasolinera | fuelOptions |
Nuevo | |
| Información sobre la carga de un VE de un lugar | evChargeOptions |
Nuevo | |
| Atributos de Places | 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 response para Text Search existente y el objeto response para Text Search (nuevo). Para la nueva API, el único campo de nivel superior de la respuesta es el array places.
| Técnica | Text Search (existente) | Text Search (nueva) | Notas |
|---|---|---|---|
| Atribuciones de lugar | html_attributions |
Se movió al nuevo objeto Place para cada lugar como place.attributions. |
|
| Rango de lugares | Array results del objeto Place existente |
Array places del nuevo objeto Place |
|
| Estado de la solicitud | status |
Se trasladó a la respuesta HTTP estándar (mensaje y código de respuesta HTTP). | |
| Cualquier mensaje de error | error_message |
Se trasladó a la respuesta HTTP estándar (mensaje y código de respuesta HTTP). | |
| Cualquier mensaje de información | info_messages |
Quitada | |
| Token de la 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 del objeto Response de Nearby Search y en el objeto response de Nearby Search (nuevo). Para la API nueva, el único campo de nivel superior en la respuesta es el array places.
| Técnica | Nearby Search (existente) | Nearby Search (nuevo) | Notas |
|---|---|---|---|
| Atribuciones de lugar | html_attributions |
Se movió al nuevo objeto Place para cada lugar como place.attributions. |
|
| Rango de lugares | Array results del objeto Place existente |
Array places del nuevo objeto Place |
|
| Estado de la solicitud | status |
Se trasladó a la respuesta HTTP estándar (mensaje y código de respuesta HTTP). | |
| Cualquier mensaje de error | error_message |
Se trasladó a la respuesta HTTP estándar (mensaje y código de respuesta HTTP). | |
| Cualquier mensaje de información | info_messages |
Quitada | |
| Token de la 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 del objeto de respuesta de los Place Details existentes y el objeto de respuesta de Place Details (nuevo). Para la API nueva, el único campo de nivel superior en la respuesta es el array places.
| Técnica | Place Details (existente) | Place Details (nuevo) | Notas |
|---|---|---|---|
| Atribuciones de lugar | html_attributions |
Se movió al nuevo objeto Place como attributions. |
|
| Detalles del lugar | result que contiene el objeto Place existente |
El nuevo objeto Place | |
| Estado de la solicitud | status |
Se trasladó a la respuesta HTTP estándar (mensaje y código de respuesta HTTP). | |
| Cualquier mensaje de información | info_messages |
Se trasladó a la respuesta HTTP estándar (mensaje y código de respuesta HTTP). |