REST Resource: places

Recurso: Lugar

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,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "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)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "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

Es el 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 legible por humanos. 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 los valores posibles, consulta las tablas A y B en https://developers.google.com/maps/documentation/places/web-service/place-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 los valores posibles, consulta las tablas A y B en https://developers.google.com/maps/documentation/places/web-service/place-types.
nationalPhoneNumber

string

Un número de teléfono legible para el lugar, en formato nacional.
internationalPhoneNumber

string

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

string

Es una dirección completa legible por humanos de este lugar.
shortFormattedAddress

string

Es una dirección corta y legible por humanos de este lugar.
addressComponents[]

object (AddressComponent)

Componentes repetidos para cada nivel de localidad Ten en cuenta lo siguiente sobre el array addressComponents[]: - El array de componentes de dirección puede contener más componentes que el formattedAddress. - El array no necesariamente incluye todas las entidades políticas que contienen una dirección, además de las incluidas en formattedAddress. Para obtener datos sobre 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)

Código plus de la latitud/longitud de la ubicación del lugar
location

object (LatLng)

Es la posición de este lugar.
viewport

object (Viewport)

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

number

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

string

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

string

El sitio web autorizado de 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, ordenadas según su relevancia. Se puede mostrar 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 depender de que el estado de siempre abierto (24 horas) se represente como un período [open][google.foo.OpeningHours.Period.open] que contiene [day][google.foo.Point.day] con el valor 0, [hour][google.foo.Point.hour] con el valor 0 y [minute][google.foo.Point.minute] con el valor 0.
photos[]

object (Photo)

Información (incluidas referencias) sobre las fotos de este lugar Se pueden mostrar un máximo de 10 fotos.
adrFormatAddress

string

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

enum (BusinessStatus)

Es el estado de la empresa del lugar.
priceLevel

enum (PriceLevel)

Es el nivel de precios del lugar.
attributions[]

object (Attribution)

Es un conjunto de proveedores de datos que se debe 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 un sufijo de tipo al final (p. ej., ".svg" o ".png").
iconBackgroundColor

string

Es el color de fondo de icon_mask en formato hexadecimal, p.ej., #909CE1.
currentOpeningHours

object (OpeningHours)

El horario de atención de los próximos siete días (incluido 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 todas las horas, establecido para fechas que tienen horas excepcionales.
currentSecondaryOpeningHours[]

object (OpeningHours)

Contiene un array de entradas para los próximos siete días, incluida información sobre los horarios secundarios de una empresa. Los horarios secundarios son diferentes de los horarios principales de una empresa. Por ejemplo, un restaurante puede especificar los horarios de atención para el servicio de autoservicio o de entrega a domicilio como sus horarios secundarios. Este campo completa el subcampo de tipo, que se extrae de una lista predefinida de tipos de horarios de atención (como DRIVE_THROUGH, PICKUP o TAKEOUT) según los tipos de lugares. Este campo incluye el subcampo specialDays de todas las horas, establecido para fechas que tienen horas excepcionales.
regularSecondaryOpeningHours[]

object (OpeningHours)

Contiene un array de entradas para obtener información sobre los horarios secundarios habituales de una empresa. Los horarios secundarios son diferentes de los horarios principales de una empresa. Por ejemplo, un restaurante puede especificar los horarios de atención para el servicio de autoservicio o de entrega a domicilio como sus horarios secundarios. Este campo completa el subcampo de tipo, que se extrae de una lista predefinida de tipos de horarios de atención (como DRIVE_THROUGH, PICKUP o TAKEOUT) según los tipos de lugares.
editorialSummary

object (LocalizedText)

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

object (PaymentOptions)

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

object (ParkingOptions)

Son las opciones de estacionamiento que ofrece el lugar.
subDestinations[]

object (SubDestination)

Es una lista de destinos secundarios relacionados con el lugar.
fuelOptions

object (FuelOptions)

La información más reciente sobre las opciones de combustible en una gasolinera. Esta información se actualiza con regularidad.
evChargeOptions

object (EVChargeOptions)

Información sobre las opciones de carga de VE.
generativeSummary

object (GenerativeSummary)

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más información.

Resumen del lugar generado por IA.
areaSummary

object (AreaSummary)

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más información.

Es un resumen generado por IA del área en la que se encuentra el lugar.
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 de los descriptores de direcciones en https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
priceRange

object (PriceRange)

Es el rango de precios asociado con un lugar.
utcOffsetMinutes

integer

Es la cantidad de minutos de diferencia de la zona horaria actual de este lugar respecto de la zona UTC. Se expresa en minutos para admitir zonas horarias que tienen una compensación de fracciones de hora, p.ej., X horas y 15 minutos.
userRatingCount

integer

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

boolean

Especifica si la empresa admite la función de llevar.
delivery

boolean

Especifica si la empresa admite la entrega.
dineIn

boolean

Especifica si el negocio admite opciones de asientos interiores o al aire libre.
curbsidePickup

boolean

Especifica si la empresa admite retiros en la puerta.
reservable

boolean

Especifica si el lugar admite reservas.
servesBreakfast

boolean

Especifica si el lugar sirve desayuno.
servesLunch

boolean

Especifica si el lugar ofrece almuerzo.
servesDinner

boolean

Especifica si el lugar sirve cena.
servesBeer

boolean

Especifica si el lugar sirve cerveza.
servesWine

boolean

Especifica si el lugar sirve vino.
servesBrunch

boolean

Especifica si el lugar sirve brunch.
servesVegetarianFood

boolean

Especifica si el lugar ofrece comida vegetariana.
outdoorSeating

boolean

El lugar tiene asientos al aire libre.
liveMusic

boolean

El lugar ofrece música en vivo.
menuForChildren

boolean

El lugar tiene un menú infantil.
servesCocktails

boolean

El lugar sirve cocteles.
servesDessert

boolean

El lugar sirve postres.
servesCoffee

boolean

El lugar sirve café.
goodForChildren

boolean

El lugar es bueno para niños.
allowsDogs

boolean

El lugar permite perros.
restroom

boolean

El lugar tiene sanitarios.
goodForGroups

boolean

El lugar admite grupos.
goodForWatchingSports

boolean

El lugar es adecuado para mirar deportes.
accessibilityOptions

object (AccessibilityOptions)

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. Una empresa exclusivamente de servicio en el área es una empresa que visita a los clientes o les proporciona sus servicios de forma directa, pero que no los atiende en su dirección comercial. Por ejemplo, empresas de servicios de limpieza o plomería. Es posible que esas empresas no tengan una dirección física ni una ubicación en Google Maps.

LocalizedText

Es la variante localizada de un texto en un idioma en particular.

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.

AddressComponent

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 o el nombre completo del componente de la dirección. Por ejemplo, un componente de dirección para el país Australia puede tener un valor long_name de "Australia".
shortText

string

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

string

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

string

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

PlusCode

El Plus Code (http://plus.codes) es una referencia de ubicación con dos formatos: el código global, que define un rectángulo de 14 m x 14 m (1/8,000 de un grado) o menos, y el 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 (~14 por 14 metros).
compoundCode

string

El código compuesto del lugar, como "33GV+HQ, Ramberg, Noruega", que contiene el sufijo del código global y reemplaza el prefijo por un 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

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

  • Si low = high, la ventana de visualización consta de ese único punto.

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

  • Si low.longitude = -180 grados y high.longitude = 180 grados, la ventana de visualización 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 propagar low y high, y el cuadro representado no puede estar vacío (como se especifica en las definiciones anteriores). Si el viewport está vacío, se generará un error.

Por ejemplo, este viewport encierra por completo 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)

Obligatorio. Es el punto inferior de la vista del puerto.
high

object (LatLng)

Obligatorio. El punto alto de la viewport.

Revisar

Es la información sobre una 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 de "recurso" de la API: places/{placeId}/reviews/{review}).
relativePublishTimeDescription

string

Es una cadena de hora reciente con formato que expresa la hora de la opinión en relación con la hora actual en un formato adecuado 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

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

object (AuthorAttribution)

Es el autor de esta opinión.
publishTime

string (Timestamp format)

Marca de tiempo de la opinión.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
flagContentUri

string

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

string

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

AuthorAttribution

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

Es el nombre del autor de 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 de Photo o Review.

OpeningHours

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)

Los períodos en los que el lugar está abierto durante la semana. Los períodos están en orden cronológico, comenzando con el domingo 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 reformas.
weekdayDescriptions[]

string

Cadenas localizadas que describen el horario de atención de este lugar, una cadena para cada día de la semana. Estará vacío si las horas son desconocidas o no se pudieron convertir a texto localizado. Ejemplo: "Dom: 18:00–06:00"
secondaryHoursType

enum (SecondaryHoursType)

Es una cadena de tipo que se usa para identificar el tipo de horas secundarias.
specialDays[]

object (SpecialDay)

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

string (Timestamp format)

La próxima vez que comience el período del 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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
nextCloseTime

string (Timestamp format)

La próxima vez que finalice el período del 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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
openNow

boolean

Indica si el período del horario de atención está activo en este momento. En el caso de los horarios de atención habituales y los actuales, este campo indica si el lugar está abierto. En el caso de los horarios de atención secundarios y los horarios de atención secundarios actuales, este campo indica si los horarios secundarios de este lugar están activos.

Período

Es el período durante el cual el lugar permanece en el estado de abierto.

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

object (Point)

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

object (Point)

La hora a la que comienza a cerrar el lugar.

Punto

Puntos de cambio de estado

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

object (Date)

Es la fecha en la zona horaria local del lugar.
truncated

boolean

Indica si este extremo se truncó o no. La truncación se produce cuando las horas reales están fuera de los horarios que estamos dispuestos a mostrar, por lo que las truncamos hasta estos límites. Esto garantiza que se muestren como máximo 24 × 7 horas a partir de la medianoche del día de la solicitud.
day

integer

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

integer

Es la hora en formato de 24 horas. Va de 0 a 23.
minute

integer

El minuto. Va 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 horas secundarias.

Enumeraciones
SECONDARY_HOURS_TYPE_UNSPECIFIED Es el valor predeterminado cuando no se especifica el tipo de hora secundaria.
DRIVE_THROUGH La hora de atención en los carriles para vehículos de bancos, restaurantes o farmacias
HAPPY_HOUR La hora feliz.
DELIVERY La hora de entrega.
TAKEOUT La hora de comida para llevar.
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 La hora de retiro.
ACCESS Las horas de acceso a los lugares de almacenamiento
SENIOR_HOURS Los horarios especiales para personas mayores.
ONLINE_SERVICE_HOURS El horario de atención en línea

SpecialDay

Es la información estructurada de los días especiales que se encuentran dentro del período que abarcan los horarios de atención que se muestran. Los días especiales son días 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)

La fecha de este día especial.

Foto

Es la 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 la foto del lugar y que se puede usar para volver a buscarla (también se denomina nombre de "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)

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 del lugar.

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

PriceLevel

Es el nivel de precios del lugar.

Enumeraciones
PRICE_LEVEL_UNSPECIFIED El nivel de precios del lugar no se especifica o es desconocido.
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

Información sobre los proveedores de datos de este lugar

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

string

Es el nombre del proveedor de datos del lugar.
providerUri

string

Es el URI del proveedor de datos del lugar.

PaymentOptions

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 pagos con tarjetas de crédito.
acceptsDebitCards

boolean

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

boolean

El lugar solo acepta pagos en efectivo. Es posible que los lugares con este atributo acepten otras formas de pago.
acceptsNfc

boolean

El lugar acepta pagos con NFC.

ParkingOptions

Información sobre las opciones de estacionamiento del lugar. Un estacionamiento puede 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 estacionamientos gratuitos.
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 en cochera gratuito.
paidGarageParking

boolean

El lugar ofrece estacionamiento en cochera de pago.

SubDestination

Es el nombre del recurso de lugar y el ID de los destinos secundarios que se relacionan con él. Por ejemplo, las diferentes terminales son destinos diferentes de un aeropuerto.

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

string

Es el nombre del recurso del destino secundario.
id

string

El ID del lugar del destino secundario.

AccessibilityOptions

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

Los lugares tienen una entrada accesible para personas en silla de ruedas.
wheelchairAccessibleRestroom

boolean

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

boolean

El lugar tiene asientos accesibles para personas en silla de ruedas.

FuelOptions

La información más reciente sobre las opciones de combustible en una gasolinera. Esta información se actualiza con regularidad.

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

object (FuelPrice)

Es el último precio conocido de 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

Información sobre el precio del combustible de 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)

La hora en la que se actualizó el precio de la gasolina por última vez.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

FuelType

Tipos de combustible

Enumeraciones
FUEL_TYPE_UNSPECIFIED Tipo de combustible no especificado
DIESEL Combustible diésel
REGULAR_UNLEADED Sin plomo normal
MIDGRADE Midgrade
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 GLP
E80 E 80.
E85 E 85.
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, según 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

Información sobre la estación de carga de VE alojada en el lugar La terminología se basa en https://afdc.energy.gov/fuels/electricity_infrastructure.html. Un puerto puede cargar un vehículo 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, como algunos puertos pueden tener varios conectores, pero solo pueden cargar un vehículo a la vez (p.ej.), la cantidad de conectores puede ser mayor que la cantidad total de vehículos que se pueden cargar de forma simultánea.
connectorAggregation[]

object (ConnectorAggregation)

Es una lista de agregación de conectores de carga de VE que contienen conectores del mismo tipo y la misma tasa de carga.

ConnectorAggregation

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 en la agregación.
count

integer

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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
availableCount

integer

Cantidad de conectores de esta agregación que están disponibles actualmente.
outOfServiceCount

integer

Cantidad de conectores de esta agregación que están fuera de servicio.

EVConnectorType

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

Enumeraciones
EV_CONNECTOR_TYPE_UNSPECIFIED Conector no especificado.
EV_CONNECTOR_TYPE_OTHER Otros tipos de conectores
EV_CONNECTOR_TYPE_J1772 Conector J1772 tipo 1.
EV_CONNECTOR_TYPE_TYPE_2 Conector IEC 62196 tipo 2 A menudo se lo conoce como MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Conector tipo CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Sistema de carga combinado (CA y CC). Basada en 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 El conector TESLA genérico. En América del Norte, es NACS, 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 representa más 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 no especificado.

GenerativeSummary

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más información.

Resumen del lugar generado por IA.

Representación JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "description": {
    object (LocalizedText)
  },
  "descriptionFlagContentUri": string,
  "references": {
    object (References)
  }
}
Campos
overview

object (LocalizedText)

Es la descripción general del lugar.
overviewFlagContentUri

string

Un vínculo en el que los usuarios pueden marcar un problema con el resumen general.
description

object (LocalizedText)

Es la descripción detallada del lugar.
descriptionFlagContentUri

string

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

object (References)

Son las referencias que se usan para generar la descripción del resumen.

Referencias

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más información.

Es la referencia con la que se relaciona el contenido generativo.

Representación JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Campos
reviews[]

object (Review)

Opiniones que sirven como referencias
places[]

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.

AreaSummary

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más información.

Es un resumen generado por IA del área en la que se encuentra el lugar.

Representación JSON 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ],
  "flagContentUri": string
}
Campos
contentBlocks[]

object (ContentBlock)

Bloques de contenido que componen el resumen del área. Cada bloque tiene un tema independiente sobre el área.
flagContentUri

string

Es un vínculo en el que los usuarios pueden marcar un problema con el resumen.

ContentBlock

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

Representación JSON 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Campos
topic

string

Es el tema del contenido, por ejemplo, "descripción general" o "restaurante".
content

object (LocalizedText)

Contenido relacionado con el tema
references

object (References)

Experimental: Consulta https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative para obtener más información.

Referencias relacionadas con este bloque de contenido.

ContainingPlace

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 lugares de referencia cercanos y áreas de contención precisas, y su relación con la ubicación objetivo.

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

object (Landmark)

Una lista clasificada de lugares de interés cercanos. Los lugares de interés más reconocibles y cercanos se clasifican primero.
areas[]

object (Area)

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

Punto de referencia

Información básica del punto de referencia y su relación con la ubicación de destino

Los lugares de interés 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

El ID de Place del lugar de interés
displayName

object (LocalizedText)

Es el nombre visible del lugar de interés.
types[]

string

Es un conjunto de etiquetas de tipo para este lugar de interés. 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 de destino 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 carreteras desde el destino 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 de destino y el punto de referencia.

Enumeraciones
NEAR Esta es la relación predeterminada cuando no se aplica nada más específico a continuación.
WITHIN El punto de referencia tiene una geometría espacial y el objetivo está dentro de sus límites.
BESIDE El objetivo está directamente junto al punto de referencia.
ACROSS_THE_ROAD El destino está directamente enfrente del punto de referencia, al otro lado de la ruta.
DOWN_THE_ROAD En la misma ruta que el punto de referencia, pero no al lado o al otro lado.
AROUND_THE_CORNER No está en la misma ruta que el punto de referencia, pero está a una sola vuelta de distancia.
BEHIND Cerca de la estructura del lugar de interés, pero más lejos de sus entradas a la calle.

Área

Información del área y la relación de esta con la ubicación de destino

Las áreas incluyen sublocalidades, vecindarios y grandes complejos precisos 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 de destino y el área.

Contención

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

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

PriceRange

Es el rango de precios asociado con un lugar. endPrice podría no estar establecido, 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 rango de precios (inclusivo). El precio debe ser igual o superior a este importe.
endPrice

object (Money)

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

Métodos

autocomplete

 Muestra las predicciones para la entrada determinada.

get

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

searchNearby

 Busca lugares cerca de ubicaciones.

searchText

 Búsqueda de lugares basada en una búsqueda de texto.