REST Resource: places

Recurso: Lugar

Es toda la información que representa un lugar.

Representación JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
Campos
name

string

Nombre del recurso de este lugar, en formato places/{placeId}. Se puede usar para buscar el lugar.
id

string

Es el identificador único de un lugar.
displayName

object (LocalizedText)

Es el nombre localizado del lugar, adecuado como una descripción corta y legible. Por ejemplo, "Google Sydney", "Starbucks", "Pyrmont", etcétera.
types[]

string

Es un conjunto de etiquetas de tipo para este resultado. Por ejemplo, “político” y “localidad”. Para obtener la lista completa de los valores posibles, consulta las tablas A y B en https://developers.google.com/maps/documentation/places/web-service/place-types
primaryType

string

Es el tipo principal del resultado determinado. Este tipo debe ser uno de los tipos admitidos por la API de Places. Por ejemplo, "restaurante", "cafetería", "aeropuerto", etcétera. Un lugar solo puede tener un tipo principal. Para obtener la lista completa de valores posibles, consulta la Tabla A y la Tabla B en https://developers.google.com/maps/documentation/places/web-service/place-types. Es posible que falte el tipo principal si no es un tipo admitido. Cuando hay un tipo principal, siempre es uno de los tipos del campo types.
primaryTypeDisplayName

object (LocalizedText)

Es el nombre visible del tipo principal, localizado al idioma de la solicitud si corresponde. Para obtener la lista completa de valores posibles, consulta la Tabla A y la Tabla B en https://developers.google.com/maps/documentation/places/web-service/place-types. Es posible que falte el tipo principal si no es un tipo admitido.
nationalPhoneNumber

string

Número de teléfono legible del lugar, en formato nacional.
internationalPhoneNumber

string

Es un número de teléfono legible del lugar, en formato internacional.
formattedAddress

string

Es la dirección completa y legible de este lugar.
shortFormattedAddress

string

Es una dirección corta y legible para este lugar.
postalAddress

object (PostalAddress)

Es la dirección en formato de dirección postal.
addressComponents[]

object (AddressComponent)

Son componentes repetidos para cada nivel de localidad. Ten en cuenta lo siguiente acerca del array addressComponents[]: - El array de componentes de dirección puede incluir más componentes que formattedAddress. - El array no necesariamente incluye todas las entidades políticas que contienen una dirección, además de las incluidas en formattedAddress. Para recuperar todas las entidades políticas que contienen una dirección específica, debes usar la geocodificación inversa y pasar la latitud y la longitud de la dirección como parámetro a la solicitud. - No se garantiza que el formato de la respuesta permanezca igual entre las distintas solicitudes. En particular, la cantidad de addressComponents varía según la dirección solicitada y puede cambiar con el tiempo para la misma dirección. Un componente puede cambiar de posición en el array. El tipo de componente puede cambiar. Es posible que falte un componente en particular en una respuesta posterior.
plusCode

object (PlusCode)

Plus Code de la ubicación (latitud y longitud) del lugar.
location

object (LatLng)

Es la posición de este lugar.
viewport

object (Viewport)

Es un viewport adecuado para mostrar el lugar en un mapa de tamaño promedio. Este viewport no se debe usar como el límite físico ni el área de servicio de la empresa.
rating

number

Es una calificación entre 1.0 y 5.0, basada en las opiniones de los usuarios sobre este lugar.
googleMapsUri

string

Es una URL que proporciona más información sobre este lugar.
websiteUri

string

Es el sitio web autorizado para este lugar, p.ej., la página principal de una empresa. Ten en cuenta que, en el caso de los lugares que forman parte de una cadena (p.ej., una tienda de IKEA), por lo general, se trata del sitio web de la tienda individual, no de la cadena en general.
reviews[]

object (Review)

Es la lista de opiniones sobre este lugar, ordenada por relevancia. Se puede devolver un máximo de 5 opiniones.
regularOpeningHours

object (OpeningHours)

El horario de atención habitual. Ten en cuenta que, si un lugar está siempre abierto (24 horas), no se establecerá el campo close. Los clientes pueden confiar en que la indicación de siempre abierto (24 horas) se represente como un período open que contiene day con el valor 0, hour con el valor 0 y minute con el valor 0.
timeZone

object (TimeZone)

Zona horaria de la base de datos de zonas horarias de IANA. Por ejemplo, "America/New_York".
photos[]

object (Photo)

Es la información (incluidas las referencias) sobre las fotos de este lugar. Se puede mostrar un máximo de 10 fotos.
adrFormatAddress

string

Es la dirección del lugar en el microformato adr: http://microformats.org/wiki/adr.
businessStatus

enum (BusinessStatus)

Es el estado de la empresa para el lugar.
priceLevel

enum (PriceLevel)

Es el nivel de precios del lugar.
attributions[]

object (Attribution)

Es un conjunto de proveedores de datos que se deben mostrar con este resultado.
iconMaskBaseUri

string

Es una URL truncada a una máscara de ícono. El usuario puede acceder a diferentes tipos de íconos agregando el sufijo de tipo al final (p. ej., ".svg" o ".png").
iconBackgroundColor

string

Color de fondo para icon_mask en formato hexadecimal, p.ej., #909CE1.
currentOpeningHours

object (OpeningHours)

Horario de atención de los próximos siete días (incluido el día de hoy) El período comienza a la medianoche de la fecha de la solicitud y finaliza a las 11:59 p.m. seis días después. Este campo incluye el subcampo specialDays de todos los horarios, configurado para las fechas que tienen horarios excepcionales.
currentSecondaryOpeningHours[]

object (OpeningHours)

Contiene un array de entradas para los próximos siete días, que incluye información sobre el horario secundario de una empresa. El horario secundario es diferente del horario principal de una empresa. Por ejemplo, un restaurante puede especificar los horarios de atención en el automóvil o los horarios de entrega como horarios secundarios. Este campo completa el subcampo de tipo, que se extrae de una lista predefinida de tipos de horarios de apertura (como DRIVE_THROUGH, PICKUP o TAKEOUT) según los tipos de lugar. Este campo incluye el subcampo specialDays de todos los horarios, configurado para las fechas que tienen horarios excepcionales.
regularSecondaryOpeningHours[]

object (OpeningHours)

Contiene un array de entradas con información sobre el horario secundario habitual de una empresa. El horario secundario es diferente del horario principal de una empresa. Por ejemplo, un restaurante puede especificar los horarios de atención en el automóvil o los horarios de entrega como horarios secundarios. Este campo completa el subcampo de tipo, que se extrae de una lista predefinida de tipos de horarios de apertura (como DRIVE_THROUGH, PICKUP o TAKEOUT) según los tipos de lugar.
editorialSummary

object (LocalizedText)

Contiene un resumen del lugar. Un resumen se compone de una descripción general textual y también incluye el código de idioma de estos si corresponde. El texto de resumen debe presentarse tal como está y no se puede modificar ni alterar.
paymentOptions

object (PaymentOptions)

Son las opciones de pago que acepta el lugar. Si no hay datos de una opción de pago disponibles, el campo de opción de pago no se establecerá.
parkingOptions

object (ParkingOptions)

Opciones de estacionamiento que ofrece el lugar.
subDestinations[]

object (SubDestination)

Es una lista de subdestinos relacionados con el lugar.
fuelOptions

object (FuelOptions)

Es la información más reciente sobre las opciones de combustible en una estación de servicio. Esta información se actualiza con regularidad.
evChargeOptions

object (EVChargeOptions)

Información sobre las opciones de carga de VE
generativeSummary

object (GenerativeSummary)

Es un resumen del lugar generado por IA.
containingPlaces[]

object (ContainingPlace)

Es la lista de lugares en los que se encuentra el lugar actual.
addressDescriptor

object (AddressDescriptor)

Es el descriptor de dirección del lugar. Los descriptores de direcciones incluyen información adicional que ayuda a describir una ubicación con puntos de referencia y áreas. Consulta la cobertura regional del descriptor de dirección en https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
priceRange

object (PriceRange)

Es el rango de precios asociado con un lugar.
reviewSummary

object (ReviewSummary)

Es un resumen del lugar generado por IA a partir de las opiniones de los usuarios.
evChargeAmenitySummary

object (EvChargeAmenitySummary)

Es el resumen de las comodidades cercanas a la estación de carga de VE.
neighborhoodSummary

object (NeighborhoodSummary)

Es un resumen de los puntos de interés cercanos al lugar.
utcOffsetMinutes

integer

Cantidad de minutos de diferencia de la zona horaria actual del lugar con respecto a la zona UTC. Esto se expresa en minutos para admitir zonas horarias que se compensan en fracciones de hora, p.ej., X horas y 15 minutos.
userRatingCount

integer

Es la cantidad total de opiniones (con o sin texto) sobre este lugar.
takeout

boolean

Especifica si el comercio admite pedidos para llevar.
delivery

boolean

Especifica si la empresa admite la entrega a domicilio.
dineIn

boolean

Especifica si la empresa admite opciones de asientos en el interior o al aire libre.
curbsidePickup

boolean

Especifica si la empresa admite el retiro en la puerta.
reservable

boolean

Especifica si el lugar admite reservas.
servesBreakfast

boolean

Especifica si el lugar ofrece desayuno.
servesLunch

boolean

Especifica si el lugar sirve almuerzo.
servesDinner

boolean

Especifica si el lugar sirve cena.
servesBeer

boolean

Especifica si el lugar vende cerveza.
servesWine

boolean

Especifica si el lugar sirve vino.
servesBrunch

boolean

Especifica si el lugar ofrece desayuno-almuerzo.
servesVegetarianFood

boolean

Especifica si el lugar ofrece comida vegetariana.
outdoorSeating

boolean

El lugar ofrece asientos al aire libre.
liveMusic

boolean

El lugar ofrece música en vivo.
menuForChildren

boolean

El lugar tiene menú infantil.
servesCocktails

boolean

El lugar sirve cócteles.
servesDessert

boolean

El lugar ofrece postres.
servesCoffee

boolean

El lugar sirve café.
goodForChildren

boolean

El lugar es bueno para los niños.
allowsDogs

boolean

Se permiten perros.
restroom

boolean

El lugar tiene sanitario.
goodForGroups

boolean

El lugar admite grupos.
goodForWatchingSports

boolean

El lugar es adecuado para mirar deportes.
accessibilityOptions

object (AccessibilityOptions)

Es información sobre las opciones de accesibilidad que ofrece un lugar.
pureServiceAreaBusiness

boolean

Indica si el lugar es una empresa de servicio en el área pura. Una empresa exclusivamente de servicio en el área es una empresa que visita a los clientes o les entrega sus productos directamente, pero que no los atiende en su dirección comercial. Por ejemplo, empresas de servicios de limpieza o plomería. Es posible que esos negocios no tengan una dirección o ubicación física en Google Maps.

LocalizedText

Es la variante localizada de un texto en un idioma específico.

Representación JSON 
{
  "text": string,
  "languageCode": string
}
Campos
text

string

Cadena localizada en el idioma correspondiente a languageCode a continuación.
languageCode

string

Es el código de idioma BCP-47 del texto, como "en-US" o "sr-Latn".

Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

PostalAddress

Representa una dirección postal, como la dirección de entrega o de pagos. Con una dirección postal, un servicio de correos puede entregar artículos en un local, un apartado postal o lugares similares. Una dirección postal no está diseñada para modelar ubicaciones geográficas, como rutas, ciudades o montañas.

En el uso típico, se crearía una dirección a partir de la entrada del usuario o de la importación de datos existentes, según el tipo de proceso.

Asesoramiento para ingresar o editar direcciones:

  • Usa un widget de dirección listo para la internacionalización, como https://github.com/google/libaddressinput.
  • No se deben mostrar a los usuarios elementos de la IU para ingresar o editar campos fuera de los países en los que se usa ese campo.

Para obtener más orientación sobre cómo usar este esquema, consulta https://support.google.com/business/answer/6397478.

Representación JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Campos
revision

integer

Es la revisión del esquema de PostalAddress. Se debe configurar como 0, que es la última versión.

Todas las revisiones nuevas deben ser compatibles con las revisiones anteriores.
regionCode

string

Obligatorio Código de región de CLDR para el país o la región de la dirección. Nunca se infiere y depende del usuario garantizar que el valor sea correcto. Consulta https://cldr.unicode.org/ y https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html para obtener más detalles. Ejemplo: "CH" para Suiza.
languageCode

string

Opcional: Código de idioma BCP-47 de los contenidos de esta dirección (si se conoce). Suele ser el idioma de la IU del formulario de entrada o se espera que coincida con uno de los idiomas usados en la región o el país de la dirección, o sus transliteraciones equivalentes. Esto puede afectar el formato en ciertos países, pero no es fundamental para la precisión de los datos y nunca afectará una validación o alguna otra operación no relacionada con el formato.

Si este valor es desconocido, se debe omitir (en lugar de especificar una configuración predeterminada posiblemente incorrecta).

Ejemplos: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Opcional: Código postal de la dirección. No todos los países usan o requieren códigos postales, pero, en los que se usan, pueden activar validaciones adicionales con otras partes de la dirección (por ejemplo, la validación del estado o el código postal en Estados Unidos).
sortingCode

string

Opcional. Código de ordenamiento adicional específico para cada país. No se usa en la mayoría de las regiones. Cuando se usa, el valor es una cadena como "CEDEX", seguida opcionalmente por un número (por ejemplo, "CEDEX 7"), o solo un número, que representa el "código de sector" (Jamaica), el "indicador de área de entrega" (Malawi) o el "indicador de oficina de correos" (Costa de Marfil).
administrativeArea

string

Opcional. División administrativa más alta que se usa para las direcciones postales de un país o una región. Por ejemplo, puede ser un estado, una provincia, una óblast o una prefectura. En el caso de España, se refiere a la provincia y no a la comunidad autónoma (por ejemplo, "Barcelona" y no "Cataluña"). Muchos países no usan un área administrativa en las direcciones postales. Por ejemplo, en Suiza, este campo debe quedar vacío.
locality

string

Opcional. Por lo general, se refiere a la parte de la dirección que indica la ciudad. Ejemplos: ciudad de EE.UU., comuna de Italia o ciudad postal en el Reino Unido. En las regiones del mundo en las que las localidades no están bien definidas o no se ajustan bien a esta estructura, deja locality vacío y usa addressLines.
sublocality

string

Opcional. Sublocalidad de la dirección. Por ejemplo, puede ser un barrio, un distrito o una zona.
addressLines[]

string

Líneas de dirección no estructuradas que describen los niveles más bajos de una dirección.

Dado que los valores en addressLines no tienen información de tipo y, a veces, pueden contener varios valores en un solo campo (por ejemplo, "Austin, TX"), es importante que el orden de las líneas sea claro. El orden de las líneas de dirección debe ser el "orden de sobre" para el país o la región de la dirección. En los lugares donde esto puede variar (por ejemplo, Japón), se usa address_language para que sea explícito (por ejemplo, “ja” para el orden de grande a pequeño y “ja-Latn” o “en” para el orden de pequeño a grande). De esta manera, se puede seleccionar la línea más específica de una dirección según el idioma.

La representación estructural mínima permitida de una dirección consta de un regionCode con toda la información restante colocada en el addressLines. Sería posible dar un formato a una dirección así de manera muy aproximada sin codificación geográfica, pero no podría realizarse un análisis semántico de ningún componente de la dirección hasta que se resuelva, al menos, de manera parcial.

La forma recomendada de controlar las direcciones completamente no estructuradas (en lugar de adivinar qué partes de la dirección deben ser localidades o áreas administrativas) es crear una dirección que solo contenga regionCode y addressLines, y luego realizar la geocodificación.
recipients[]

string

Opcional. El destinatario en la dirección. Es posible que este campo contenga varias líneas de información en ciertas circunstancias. Por ejemplo, puede contener información sobre la entrega "por medio de".
organization

string

Opcional: El nombre de la organización de la dirección.

AddressComponent

Son los componentes estructurados que forman la dirección con formato, si esta información está disponible.

Representación JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Campos
longText

string

Es la descripción textual completa o el nombre del componente de la dirección. Por ejemplo, un componente de dirección para el país Australia puede tener un long_name de "Australia".
shortText

string

Es un nombre textual abreviado para el componente de la dirección, si está disponible. Por ejemplo, un componente de dirección para el país de Australia puede tener un short_name de "AU".
types[]

string

Es un array que indica los tipos de componente de dirección.
languageCode

string

Es el idioma que se usa para dar formato a estos componentes, en notación de CLDR.

PlusCode

El Plus Code (http://plus.codes) es una referencia de ubicación con dos formatos: código global que define un rectángulo de 14 m x 14 m (1/8,000 de un grado) o más pequeño, y código compuesto, que reemplaza el prefijo por una ubicación de referencia.

Representación JSON 
{
  "globalCode": string,
  "compoundCode": string
}
Campos
globalCode

string

Es el código global (completo) del lugar, como "9FWM33GV+HQ", que representa un área de 1/8,000 por 1/8,000 de grado (aproximadamente 14 por 14 metros).
compoundCode

string

Es el código compuesto del lugar, como "33GV+HQ, Ramberg, Norway", que contiene el sufijo del código global y reemplaza el prefijo por el nombre con formato de una entidad de referencia.

LatLng

Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de números de punto flotante de doble precisión que representan los grados de latitud y longitud. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

Viewport

Es un viewport de latitud y longitud, representado como dos puntos low y high opuestos diagonalmente. Un viewport se considera una región cerrada, es decir, incluye su límite. Los límites de latitud deben estar entre -90 y 90 grados inclusive, y los límites de longitud deben estar entre -180 y 180 grados inclusive. Entre los diversos casos, se incluyen los siguientes:

  • Si low = high, el viewport consta de ese único punto.

  • Si low.longitude > high.longitude, el rango de longitud se invierte (el viewport cruza la línea de longitud de 180 grados).

  • Si low.longitude = -180 grados y high.longitude = 180 grados, la ventana gráfica incluye todas las longitudes.

  • Si low.longitude = 180 grados y high.longitude = -180 grados, el rango de longitud está vacío.

  • Si low.latitude > high.latitude, el rango de latitud está vacío.

Se deben completar low y high, y el cuadro representado no puede estar vacío (como se especifica en las definiciones anteriores). Un viewport vacío generará un error.

Por ejemplo, este viewport encierra completamente la ciudad de Nueva York:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Representación JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campos
low

object (LatLng)

Es obligatorio. Es el punto más bajo de la ventana gráfica.
high

object (LatLng)

Es obligatorio. Es el punto más alto de la ventana gráfica.

Revisar

Es la información sobre la opinión de un lugar.

Representación JSON 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
Campos
name

string

Es una referencia que representa esta opinión sobre el lugar y que se puede usar para volver a buscarla (también se denomina nombre del "recurso" de la API: places/{placeId}/reviews/{review}).
relativePublishTimeDescription

string

Es una cadena de tiempo reciente con formato que expresa la hora de la opinión en relación con la hora actual de una forma adecuada para el idioma y el país.
text

object (LocalizedText)

Es el texto localizado de la opinión.
originalText

object (LocalizedText)

Es el texto de la opinión en su idioma original.
rating

number

Es un número entre 1.0 y 5.0, también llamado cantidad de estrellas.
authorAttribution

object (AuthorAttribution)

Es el autor de la opinión.
publishTime

string (Timestamp format)

Es la marca de tiempo de la opinión.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
flagContentUri

string

Un vínculo en el que los usuarios pueden marcar un problema con la opinión.
googleMapsUri

string

Es un vínculo para mostrar la opinión en Google Maps.

AuthorAttribution

Es información sobre el autor de los datos de CGU. Se usa en Photo y Review.

Representación JSON 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Campos
displayName

string

Nombre del autor del Photo o Review.
uri

string

Es el URI del autor de Photo o Review.
photoUri

string

Es el URI de la foto de perfil del autor del Photo o Review.

OpeningHours

Es información sobre el horario de atención del lugar.

Representación JSON 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Campos
periods[]

object (Period)

Son los períodos en los que este lugar está abierto durante la semana. Los períodos se muestran en orden cronológico y en la zona horaria local del lugar. Un valor vacío (pero no ausente) indica un lugar que nunca está abierto, p.ej., porque está cerrado temporalmente por renovaciones.

El día de inicio de periods NO es fijo y no se debe suponer que es el domingo. La API determina el día de inicio en función de diversos factores. Por ejemplo, en el caso de una empresa que opera las 24 horas, el primer período puede comenzar el día de la solicitud. En el caso de otros negocios, puede ser el primer día de la semana en que están abiertos.

NOTA: El orden del array periods es independiente del orden del array weekdayDescriptions. No supongas que comenzarán el mismo día.
weekdayDescriptions[]

string

Son cadenas localizadas que describen el horario de atención de este lugar, una cadena para cada día de la semana.

NOTA: El orden de los días y el inicio de la semana se determinan según la configuración regional (idioma y región). El orden del array periods es independiente del orden del array weekdayDescriptions. No supongas que comenzarán el mismo día.

Estará vacío si se desconocen las horas o no se pudieron convertir a texto localizado. Ejemplo: “Dom.: 18:00 a 6:00”
secondaryHoursType

enum (SecondaryHoursType)

Es una cadena de tipo que se usa para identificar el tipo de horario secundario.
specialDays[]

object (SpecialDay)

Es la información estructurada para los días especiales que se encuentran dentro del período que abarca el horario de atención devuelto. Los días especiales son aquellos que podrían afectar el horario de atención de un lugar, p.ej., el día de Navidad. Se establece para currentOpeningHours y currentSecondaryOpeningHours si hay horarios excepcionales.
nextOpenTime

string (Timestamp format)

La próxima vez que comience el período de horario de atención actual, hasta 7 días en el futuro. Este campo solo se completa si el período de horario de atención no está activo en el momento de entregar la solicitud.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
nextCloseTime

string (Timestamp format)

La próxima vez que finalice el período de horario de atención actual, hasta 7 días en el futuro. Este campo solo se completa si el período de horario de atención está activo en el momento de publicar la solicitud.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
openNow

boolean

Indica si el período de horario de atención está activo en este momento. En el caso del horario de atención habitual y el horario de atención actual, este campo indica si el lugar está abierto. En el caso del horario de atención secundario y el horario de atención secundario actual, este campo indica si el horario secundario de este lugar está activo.

Período

Es el período durante el que el lugar permanece en el estado openNow.

Representación JSON 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Campos
open

object (Point)

Es la hora en la que el lugar comienza a estar abierto.
close

object (Point)

Es la hora en que el lugar comienza a estar cerrado.

Punto

Puntos de cambio de estado.

Representación JSON 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Campos
date

object (Date)

Fecha en la zona horaria local del lugar.
truncated

boolean

Indica si este extremo se truncó o no. El truncamiento se produce cuando las horas reales están fuera del período entre el que queremos devolver horas, por lo que truncamos las horas hasta estos límites. Esto garantiza que se devuelvan, como máximo, 24 * 7 horas desde la medianoche del día de la solicitud.
day

integer

Día de la semana, como un número entero en el rango de 0 a 6. El 0 es domingo, el 1 es lunes, etcétera.
hour

integer

Hora en formato de 24 horas. El rango es de 0 a 23.
minute

integer

El minuto. El rango es de 0 a 59.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

  • Una fecha completa con valores para el año, mes y día que no sean cero.
  • Un mes y un día, con cero año (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo.

SecondaryHoursType

Es un tipo que se usa para identificar el tipo de horario secundario.

Enumeraciones
SECONDARY_HOURS_TYPE_UNSPECIFIED Es el valor predeterminado cuando no se especifica el tipo de hora secundaria.
DRIVE_THROUGH Hora de servicio en ventanilla de bancos, restaurantes o farmacias.
HAPPY_HOUR La hora feliz.
DELIVERY Hora de entrega.
TAKEOUT La hora de retiro.
KITCHEN La hora de la cocina.
BREAKFAST La hora del desayuno.
LUNCH La hora del almuerzo.
DINNER La hora de la cena.
BRUNCH La hora del brunch.
PICKUP Hora de retiro.
ACCESS Son las horas de acceso a los lugares de almacenamiento.
SENIOR_HOURS El horario especial para adultos mayores
ONLINE_SERVICE_HOURS Horario de atención en línea

SpecialDay

Es la información estructurada para los días especiales que se encuentran dentro del período que abarca el horario de atención devuelto. Los días especiales son aquellos que podrían afectar el horario de atención de un lugar, p.ej., el día de Navidad.

Representación JSON 
{
  "date": {
    object (Date)
  }
}
Campos
date

object (Date)

Fecha de este día especial

TimeZone

Representa una zona horaria de la base de datos de zonas horarias de IANA.

Representación JSON 
{
  "id": string,
  "version": string
}
Campos
id

string

Zona horaria de la base de datos de zonas horarias de IANA. Por ejemplo, "America/New_York".
version

string

Opcional. Número de versión de la base de datos de zonas horarias de IANA. Por ejemplo, "2019a".

Foto

Es información sobre una foto de un lugar.

Representación JSON 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
Campos
name

string

Identificador. Es una referencia que representa esta foto del lugar y que se puede usar para volver a buscarla (también se denomina nombre del "recurso" de la API: places/{placeId}/photos/{photo}).
widthPx

integer

Es el ancho máximo disponible, en píxeles.
heightPx

integer

Es la altura máxima disponible, en píxeles.
authorAttributions[]

object (AuthorAttribution)

Son los autores de esta foto.
flagContentUri

string

Un vínculo en el que los usuarios pueden marcar un problema con la foto
googleMapsUri

string

Un vínculo para mostrar la foto en Google Maps

BusinessStatus

Es el estado de la empresa para el lugar.

Enumeraciones
BUSINESS_STATUS_UNSPECIFIED Valor predeterminado Este valor no se usa.
OPERATIONAL El establecimiento está en funcionamiento, pero no necesariamente abierto en este momento.
CLOSED_TEMPORARILY El establecimiento está cerrado temporalmente.
CLOSED_PERMANENTLY El establecimiento está cerrado permanentemente.

PriceLevel

Es el nivel de precios del lugar.

Enumeraciones
PRICE_LEVEL_UNSPECIFIED No se especificó o se desconoce el nivel de precios del lugar.
PRICE_LEVEL_FREE El lugar ofrece servicios gratuitos.
PRICE_LEVEL_INEXPENSIVE El lugar ofrece servicios económicos.
PRICE_LEVEL_MODERATE El lugar ofrece servicios a precios moderados.
PRICE_LEVEL_EXPENSIVE El lugar ofrece servicios costosos.
PRICE_LEVEL_VERY_EXPENSIVE El lugar ofrece servicios muy costosos.

Atribución

Es información sobre los proveedores de datos de este lugar.

Representación JSON 
{
  "provider": string,
  "providerUri": string
}
Campos
provider

string

Nombre del proveedor de datos del lugar.
providerUri

string

Es el URI del proveedor de datos del lugar.

PaymentOptions

Son las opciones de pago que acepta el lugar.

Representación JSON 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Campos
acceptsCreditCards

boolean

El lugar acepta tarjetas de crédito como forma de pago.
acceptsDebitCards

boolean

El lugar acepta tarjetas de débito como forma de pago.
acceptsCashOnly

boolean

El lugar solo acepta efectivo como forma de pago. Es posible que los lugares con este atributo sigan aceptando otras formas de pago.
acceptsNfc

boolean

El lugar acepta pagos NFC.

ParkingOptions

Es información sobre las opciones de estacionamiento del lugar. Un estacionamiento podría admitir más de una opción al mismo tiempo.

Representación JSON 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Campos
freeParkingLot

boolean

El lugar ofrece estacionamiento gratuito.
paidParkingLot

boolean

El lugar ofrece estacionamientos pagados.
freeStreetParking

boolean

El lugar ofrece estacionamiento gratuito en la calle.
paidStreetParking

boolean

El lugar ofrece estacionamiento pagado en la calle.
valetParking

boolean

El lugar ofrece servicio de estacionamiento.
freeGarageParking

boolean

El lugar ofrece estacionamiento gratuito en cochera.
paidGarageParking

boolean

El lugar ofrece estacionamiento en cochera de pago.

SubDestination

Los subdestinos son lugares específicos asociados a un lugar principal. Proporcionan destinos más específicos para los usuarios que realizan búsquedas dentro de un lugar grande o complejo, como un aeropuerto, un parque nacional, una universidad o un estadio. Por ejemplo, las subdestinaciones en un aeropuerto podrían incluir las terminales y los estacionamientos asociados. Los subdestinos devuelven el ID de lugar y el nombre del recurso de lugar, que se pueden usar en solicitudes posteriores a Place Details (nuevo) para recuperar detalles más enriquecidos, incluidos el nombre visible y la ubicación del subdestino.

Representación JSON 
{
  "name": string,
  "id": string
}
Campos
name

string

Es el nombre del recurso del subdestino.
id

string

Es el ID de lugar del subdestino.

AccessibilityOptions

Es información sobre las opciones de accesibilidad que ofrece un lugar.

Representación JSON 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Campos
wheelchairAccessibleParking

boolean

El lugar ofrece estacionamiento accesible para personas en silla de ruedas.
wheelchairAccessibleEntrance

boolean

El lugar tiene entrada con acceso para silla de ruedas.
wheelchairAccessibleRestroom

boolean

El lugar tiene sanitarios accesibles para personas en silla de ruedas.
wheelchairAccessibleSeating

boolean

El lugar tiene espacio accesible para personas en silla de ruedas.

FuelOptions

Es la información más reciente sobre las opciones de combustible en una estación de servicio. Esta información se actualiza con regularidad.

Representación JSON 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Campos
fuelPrices[]

object (FuelPrice)

Es el último precio conocido del combustible para cada tipo de combustible que tiene esta estación. Hay una entrada por cada tipo de combustible que tiene la estación. El orden no es importante.

FuelPrice

Es la información del precio del combustible para un tipo determinado.

Representación JSON 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Campos
type

enum (FuelType)

Es el tipo de combustible.
price

object (Money)

Es el precio del combustible.
updateTime

string (Timestamp format)

Fecha y hora en la que se actualizó el precio del combustible por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

FuelType

Tipos de combustible

Enumeraciones
FUEL_TYPE_UNSPECIFIED Tipo de combustible sin especificar.
DIESEL Combustible diésel
DIESEL_PLUS Combustible diésel y combustible adicional
REGULAR_UNLEADED Gasolina normal sin plomo.
MIDGRADE Súper
PREMIUM Alta calidad
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG Gas licuado de petróleo.
E80 E 80.
E85 E 85.
E100 E 100.
METHANE Metano
BIO_DIESEL Biodiésel
TRUCK_DIESEL Diésel para camiones

Dinero

Representa un importe de dinero con su tipo de moneda.

Representación JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campos
currencyCode

string

Es el código de moneda de tres letras definido en la norma ISO 4217.
units

string (int64 format)

La unidad entera del importe. Por ejemplo, si currencyCode es "USD", 1 unidad es un dólar estadounidense.
nanos

integer

Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si units es positivo, nanos debe ser positivo o cero. Si units es cero, nanos puede ser positivo, cero o negativo. Si units es negativo, nanos debe ser negativo o cero. Por ejemplo, –$1.75 se representa como units=-1 y nanos=-750,000,000.

EVChargeOptions

Es la información sobre la estación de carga de VE alojada en el lugar. La terminología sigue https://afdc.energy.gov/fuels/electricity_infrastructure.html. Un puerto puede cargar un automóvil a la vez. Un puerto tiene uno o más conectores. Una estación tiene uno o más puertos.

Representación JSON 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Campos
connectorCount

integer

Cantidad de conectores en esta estación. Sin embargo, debido a que algunos puertos pueden tener varios conectores, pero solo pueden cargar un automóvil a la vez (p.ej.), la cantidad de conectores puede ser mayor que la cantidad total de automóviles que se pueden cargar de forma simultánea.
connectorAggregation[]

object (ConnectorAggregation)

Es una lista de agregaciones de conectores de carga de VE que contienen conectores del mismo tipo y la misma tarifa de carga.

ConnectorAggregation

Es la información de carga de VE agrupada por [type, maxChargeRateKw]. Muestra la agregación de carga de VE de los conectores que tienen el mismo tipo y la misma tasa de carga máxima en kW.

Representación JSON 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Campos
type

enum (EVConnectorType)

Es el tipo de conector de esta agregación.
maxChargeRateKw

number

Es la tasa de carga máxima estática en kW de cada conector de la agregación.
count

integer

Es la cantidad de conectores en esta agregación.
availabilityLastUpdateTime

string (Timestamp format)

Es la marca de tiempo de la última actualización de la información de disponibilidad del conector en esta agregación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
availableCount

integer

Es la cantidad de conectores en esta agregación que están disponibles actualmente.
outOfServiceCount

integer

Es la cantidad de conectores de esta agregación que actualmente están fuera de servicio.

EVConnectorType

Consulta http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 para obtener información o contexto adicional sobre los tipos de conectores de carga de VE.

Enumeraciones
EV_CONNECTOR_TYPE_UNSPECIFIED Conector sin especificar.
EV_CONNECTOR_TYPE_OTHER Otros tipos de conectores
EV_CONNECTOR_TYPE_J1772 Conector tipo 1 J1772.
EV_CONNECTOR_TYPE_TYPE_2 Conector IEC 62196 tipo 2. A menudo se la conoce como MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Conector tipo CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Sistema de carga combinado (CA y CC). Se basa en el SAE. Conector J-1772 tipo 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Sistema de carga combinado (CA y CC). Basado en el conector Mennekes tipo 2
EV_CONNECTOR_TYPE_TESLA Es el conector genérico de TESLA. Este es el NACS en América del Norte, pero puede no serlo en otras partes del mundo (p.ej., CCS Combo 2 [CCS2] o GB/T). Este valor es menos representativo de un tipo de conector real y más representativo de la capacidad de cargar un vehículo de la marca Tesla en una estación de carga propiedad de Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T El tipo GB/T corresponde al estándar GB/T de China. Este tipo abarca todos los tipos de GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Tomacorriente sin especificar.
EV_CONNECTOR_TYPE_NACS El North American Charging System (NACS), estandarizado como SAE J3400.

GenerativeSummary

Es un resumen del lugar generado por IA.

Representación JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Campos
overview

object (LocalizedText)

Es el resumen del lugar.
overviewFlagContentUri

string

Es un vínculo en el que los usuarios pueden marcar un problema con el resumen de la descripción general.
disclosureText

object (LocalizedText)

El mensaje de divulgación de IA "Resumen con Gemini" (y sus variantes localizadas). Si está disponible, se mostrará en el idioma especificado en la solicitud.

ContainingPlace

Es la información sobre el lugar en el que se encuentra este lugar.

Representación JSON 
{
  "name": string,
  "id": string
}
Campos
name

string

Es el nombre del recurso del lugar en el que se encuentra este lugar.
id

string

Es el ID del lugar en el que se encuentra este lugar.

AddressDescriptor

Es una descripción relacional de una ubicación. Incluye un conjunto clasificado de puntos de referencia cercanos y áreas de contención precisas, así como su relación con la ubicación objetivo.

Representación JSON 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
Campos
landmarks[]

object (Landmark)

Es una lista clasificada de puntos de referencia cercanos. Los puntos de referencia más reconocibles y cercanos se clasifican primero.
areas[]

object (Area)

Es una lista clasificada de áreas adyacentes o que contienen el área buscada. Las áreas más reconocibles y precisas se clasifican primero.

Punto de referencia

Información básica sobre el punto de referencia y su relación con la ubicación objetivo

Los puntos de referencia son lugares destacados que se pueden usar para describir una ubicación.

Representación JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
Campos
name

string

Es el nombre del recurso del punto de referencia.
placeId

string

Es el ID de lugar del punto de referencia.
displayName

object (LocalizedText)

Es el nombre visible del punto de referencia.
types[]

string

Es un conjunto de etiquetas de tipo para este punto de referencia. Para obtener una lista completa de los valores posibles, consulta https://developers.google.com/maps/documentation/places/web-service/place-types.
spatialRelationship

enum (SpatialRelationship)

Define la relación espacial entre la ubicación objetivo y el punto de referencia.
straightLineDistanceMeters

number

Es la distancia en línea recta, en metros, entre el punto central del objetivo y el punto central del punto de referencia. En algunas situaciones, este valor puede ser mayor que travelDistanceMeters.
travelDistanceMeters

number

Es la distancia de viaje, en metros, a lo largo de la red de rutas desde el objetivo hasta el punto de referencia, si se conoce. Este valor no tiene en cuenta el medio de transporte, como caminar, conducir o andar en bicicleta.

SpatialRelationship

Define la relación espacial entre la ubicación objetivo y el punto de referencia.

Enumeraciones
NEAR Esta es la relación predeterminada cuando no se aplica ninguna otra más específica a continuación.
WITHIN El punto de referencia tiene una geometría espacial y el objetivo se encuentra dentro de sus límites.
BESIDE El destino se encuentra directamente junto al punto de referencia.
ACROSS_THE_ROAD El destino se encuentra directamente frente al punto de referencia, del otro lado de la ruta.
DOWN_THE_ROAD En la misma ruta que el punto de referencia, pero no al lado ni enfrente
AROUND_THE_CORNER No está en la misma ruta que el punto de referencia, pero se encuentra a un solo giro de distancia.
BEHIND Cerca de la estructura del punto de referencia, pero más lejos de las entradas a la calle

Área

Es la información del área y su relación con la ubicación objetivo.

Las áreas incluyen sublocalidades precisas, vecindarios y grandes complejos que son útiles para describir una ubicación.

Representación JSON 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
Campos
name

string

Es el nombre del recurso del área.
placeId

string

Es el ID de lugar del área.
displayName

object (LocalizedText)

Es el nombre visible del área.
containment

enum (Containment)

Define la relación espacial entre la ubicación objetivo y el área.

Contención

Define la relación espacial entre la ubicación objetivo y el área.

Enumeraciones
CONTAINMENT_UNSPECIFIED La contención no se especifica.
WITHIN La ubicación objetivo se encuentra dentro de la región del área, cerca del centro.
OUTSKIRTS La ubicación de destino se encuentra dentro de la región del área, cerca del borde.
NEAR La ubicación objetivo está fuera de la región del área, pero cerca.

PriceRange

Es el rango de precios asociado con un lugar. endPrice podría no establecerse, lo que indica un rango sin límite superior (p.ej., "Más de USD 100").

Representación JSON 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
Campos
startPrice

object (Money)

Es el límite inferior del intervalo de precios (inclusive). El precio debe ser igual o superior a este importe.
endPrice

object (Money)

Es el límite superior del intervalo de precios (exclusivo). El precio debe ser inferior a este importe.

ReviewSummary

Es un resumen del lugar generado por IA a partir de las opiniones de los usuarios.

Representación JSON 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
Campos
text

object (LocalizedText)

Es el resumen de las opiniones de los usuarios.
flagContentUri

string

Un vínculo en el que los usuarios pueden marcar un problema con el resumen
disclosureText

object (LocalizedText)

El mensaje de divulgación de IA "Resumen con Gemini" (y sus variantes localizadas). Si está disponible, se mostrará en el idioma especificado en la solicitud.
reviewsUri

string

Es un vínculo para mostrar las opiniones sobre este lugar en Google Maps.

EvChargeAmenitySummary

Es el resumen de las comodidades cercanas a la estación de carga de VE. Esto solo se aplica a los lugares de tipo electric_vehicle_charging_station. Se garantiza que se proporcionará el campo overview, mientras que los demás campos son opcionales.

Representación JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Campos
overview

object (ContentBlock)

Una descripción general de los servicios disponibles Se garantiza que se proporcionará.
coffee

object (ContentBlock)

Un resumen de las opciones de cafeterías cercanas.
restaurant

object (ContentBlock)

Es un resumen de los restaurantes cercanos.
store

object (ContentBlock)

Es un resumen de las tiendas cercanas.
flagContentUri

string

Un vínculo en el que los usuarios pueden marcar un problema con el resumen
disclosureText

object (LocalizedText)

El mensaje de divulgación de IA "Resumen con Gemini" (y sus variantes localizadas). Si está disponible, se mostrará en el idioma especificado en la solicitud.

ContentBlock

Es un bloque de contenido que se puede publicar de forma individual.

Representación JSON 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
Campos
content

object (LocalizedText)

Contenido relacionado con el tema.
referencedPlaces[]

string

Es la lista de nombres de recursos de los lugares a los que se hace referencia. Este nombre se puede usar en otras APIs que acepten nombres de recursos de Place.

NeighborhoodSummary

Es un resumen de los puntos de interés cercanos al lugar.

Representación JSON 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Campos
overview

object (ContentBlock)

Un resumen general del vecindario.
description

object (ContentBlock)

Es una descripción detallada del vecindario.
flagContentUri

string

Un vínculo en el que los usuarios pueden marcar un problema con el resumen
disclosureText

object (LocalizedText)

El mensaje de divulgación de IA "Resumen con Gemini" (y sus variantes localizadas). Si está disponible, se mostrará en el idioma especificado en la solicitud.

Métodos

autocomplete

 Devuelve predicciones para la entrada proporcionada.

get

 Obtén los detalles de un lugar según su nombre de recurso, que es una cadena en formato places/{place_id}.

searchNearby

 Buscar lugares cerca de ubicaciones

searchText

 Es una búsqueda de lugares basada en una consulta de texto.