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 tienen para cada API. Consulta los siguientes vínculos:
- Cambios en la respuesta de Text Search
- Cambios en las respuestas de Nearby Search
- Cambios en la respuesta 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 |
|
Coloca la dirección de microformato | adr_address |
adrFormatAddress |
|
Estado de la empresa | business_status |
businessStatus |
|
Horario de apertura 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 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 lugar para
más información. |
|
Color de fondo del ícono | icon_background_color |
iconBackgroundColor |
|
URL de 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 del lugar del 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
Cambia 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 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 para sillas de ruedas | wheelchair_accessible_entrance |
accessibilityOptions |
El valor de 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 lo siguiente:
el nombre del lugar como una cadena de texto. En la nueva API, esa información se encuentra
displayName |
|
Tipo principal de lugar | primaryTypeName |
Nuevo | |
Coloca el tipo principal como una cadena de texto | primaryTypeDisplayName |
Nuevo | |
Horario de atención secundario semanal normal, con excepciones y todas las 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 Places | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nuevo |
Cambios en la respuesta de Text Search
La siguiente tabla muestra los cambios realizados en los campos de nivel superior de la
objeto de respuesta
para la búsqueda de texto existente y para
objeto de respuesta
para Text Search (nuevo). 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 movieron al nuevo objeto Place para cada lugar como place.attributions |
|
Variedad de lugares | Array results del objeto Place existente |
Array places del objeto Place nuevo |
|
Estado de la solicitud | status |
Se trasladaron a la respuesta HTTP estándar (código y mensaje de respuesta HTTP) | |
Cualquier mensaje de error | error_message |
Se trasladaron a la respuesta HTTP estándar (código y mensaje 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 de la respuesta
objeto
para la búsqueda de Nearby Search existente y la respuesta
objeto
para Nearby Search (nuevo). Para la nueva API, el único campo de nivel superior en la
es el array places
.
Campo | Nearby Search (existente) | Nearby Search (nuevo) | Notas |
---|---|---|---|
Atribuciones de lugares | html_attributions |
Se trasladó al nuevo Place.
objeto de 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 trasladaron a la respuesta HTTP estándar (código y mensaje de respuesta HTTP) | |
Cualquier mensaje de error | error_message |
Se trasladaron a la respuesta HTTP estándar (código y mensaje 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 de la respuesta
objeto
para los detalles de Place Details existentes y la respuesta
objeto
para Place Details (nuevo). Para la nueva API, el único campo de nivel superior en la
es el array places
.
Campo | Place Details (existente) | Place Details (nuevo) | 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) |