Introducción
El formato de respuesta de las APIs de
Place Details (nueva),
Nearby Search (nueva),
y
Text Search (nueva)
cambió con respecto al formato de las APIs heredadas. La principal diferencia radica en
el formato del Place objeto que muestra 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. Verás lo siguiente:
- Cambios en la respuesta de Text Search
- 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 objeto nuevo
Place de la respuesta de Place Details (nueva), Nearby Search (nueva) y
Text Search (nueva) en comparación con el objeto heredado
Place.
El nuevo objeto de respuesta usa camelCase 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 de microformato del lugar | adr_address |
adrFormatAddress |
|
| Estado del negocio | 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 del lugar | 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 de ícono | icon_mask_base_uri |
iconMaskBaseUri |
|
| Número de teléfono internacional | international_phone_number |
internationalPhoneNumber |
|
| Nombre del lugar en texto | name |
displayName |
Ahora se puede acceder al nombre del lugar en texto como displayName.text y
language como displayName.languageCode. |
| Horario de atención | opening_hours |
regularOpeningHours |
|
| Fotos | photos |
photos |
El formato de photos cambió en el nuevo
Place objeto. Para obtener más información, consulta
Cambio 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 atención secundario de 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 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 la ciudad | vicinity |
shortFormattedAddress |
|
| Sitio web del lugar | website |
websiteUri |
|
| Información sobre accesibilidad para sillas de ruedas | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance ahora se encuentra 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 del lugar | primaryTypeName |
Nuevo | |
| Tipo principal del lugar 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 del lugar | parkingOptions |
Nuevo | |
| Lista de subdestinos relacionados con el lugar | subDestinations |
Nuevo | |
| 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 de 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 (heredada) y el
objeto de respuesta
de Text Search (nueva). En el caso de 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 del lugar | html_attributions |
Se trasladó al nuevo objeto Place para cada lugar como place.attributions. |
|
| Array de lugares | Array results del objeto Place heredado |
Array places del objeto Place nuevo |
|
| 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 de información | info_messages |
Se quitó el elemento. | |
| Token de la página | next_page_token |
Se quitó el elemento. |
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 (heredada) y el objeto de
respuesta de Nearby Search (nueva). En el caso de la nueva API, el único campo de nivel superior en la respuesta es el array places.
| Campo | Nearby Search (heredada) | Nearby Search (nueva) | Notas |
|---|---|---|---|
| Atribuciones del lugar | html_attributions |
Se trasladó al nuevo Place
objeto para cada lugar como place.attributions |
|
| Array de lugares | Array results del objeto Place heredado |
Array places del objeto Place nuevo
|
|
| 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 de información | info_messages |
Se quitó el elemento. | |
| Token de la página | next_page_token |
Se quitó el elemento. |
Cambios en la respuesta de Place Details (nueva)
En la siguiente tabla, se muestran los cambios en los campos de nivel superior del objeto
de respuesta
de Place Details (heredada) y el objeto
de respuesta
de Place Details (nueva). En el caso de la nueva API, el único campo de nivel superior en la respuesta es el array places.
| Campo | Place Details (heredada) | Place Details (nueva) | Notas |
|---|---|---|---|
| Atribuciones del lugar | html_attributions |
Se trasladó al nuevo Place
objeto como attributions. |
|
| Place Details (nueva) | 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 de información | info_messages |
Se trasladó a la respuesta HTTP estándar (código y mensaje de respuesta HTTP). |