Cómo migrar la respuesta de la API de Places

El formato de respuesta para las nuevas APIs de Place Details, Nearby Search y Text Search cambió del formato de las APIs existentes. La diferencia principal 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 se cambiaron para cada API. Consulta los siguientes vínculos:

Cambios en el objeto Place de respuesta

En esta tabla, se muestran los cambios del objeto Place nuevo en las respuestas 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 mediales para los nombres de campos, contiene campos nuevos y cambia el nombre de algunos de los 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. Para obtener más información, consulta Íconos de lugar.
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 el nuevo objeto Place. Para obtener más información, consulta Cambia a 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 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 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 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
Coloca el tipo principal como una cadena de texto primaryTypeDisplayName Nuevo
Horario de atención secundario semanal normal, 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 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 realizados en los campos de nivel superior del objeto de respuesta de Text Search existente y el objeto de respuesta de Text Search (nuevo). Para la API nueva, 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 del objeto de respuesta de Nearby Search existente y el objeto de respuesta para Nearby Search (nuevo). Para la API nueva, el único campo de nivel superior en la respuesta es el array places.

Campo Nearby Search (existente) Nearby Search (nuevo) Notas
Atribuciones de lugares html_attributions Se movió 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 Place Details

En la siguiente tabla, se muestran los cambios realizados en los campos de nivel superior del objeto de respuesta de Place Details existentes y el objeto de respuesta para Place Details (nuevo). Para la API nueva, el único campo de nivel superior en la respuesta es el array places.

Campo Place Details (existente) Place Details (nuevo) Notas
Atribuciones de lugares 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 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)