REST Resource: places

Recurso: Place

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)

El nombre localizado del lugar, adecuado como una descripción breve legible por humanos. Por ejemplo, “Google Sídney”, “Starbucks”, “Pyrmont”, etcétera.

types[]

string

Es un conjunto de etiquetas de tipo para este resultado. Por ejemplo, "política" 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)

El nombre visible del tipo principal, localizado en el 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

Es un 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

Una dirección completa y 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 todas las entidades políticas que contienen una dirección específica, debes usar la geocodificación inversa, y pasar la latitud y longitud de la dirección como parámetro a la solicitud. - No se garantiza que el formato de la respuesta permanezca igual entre las 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 y 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

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.

photos[]

object (Photo)

Información (incluidas las 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)

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

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

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 todos los horarios, establecido para fechas que tienen horarios excepcionales.

regularSecondaryOpeningHours[]

object (OpeningHours)

Contiene un array de entradas para obtener información sobre los horarios secundarios habituales 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 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)

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)

El descriptor de la dirección del sitio. 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 entregas.

dineIn

boolean

Especifica si la empresa admite opciones de asientos en interiores o exteriores.

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ú para niños.

servesCocktails

boolean

El lugar sirve cocteles.

servesDessert

boolean

Lugar donde se sirven postres.

servesCoffee

boolean

El lugar sirve café.

goodForChildren

boolean

El lugar es apto para niños.

allowsDogs

boolean

El lugar permite 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)

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

pureServiceAreaBusiness

boolean

Indica si el lugar es una empresa exclusivamente 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

A continuación, se muestra una cadena localizada en el idioma correspondiente a languageCode.

languageCode

string

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 el nombre short_name "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

El código global (completo) del lugar, como "9FWM33GV+HQ", que representa un área de 1/8,000 por 1/8,000 grados (~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. Varios casos 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 producirá 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. Es el punto superior del 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 este lugar está abierto durante la semana. Los períodos están en orden cronológico, a partir del domingo en la zona horaria 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 el horario es desconocido o no se pudo 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 el período actual del horario de atención finalice hasta 7 días después. 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 el lugar comienza a cerrarse.

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 ocurre cuando las horas reales están fuera del horario entre el que estamos dispuestos a devolver las horas entre ellas, por lo que truncamos las horas de vuelta a 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

La hora en 2 dígitos. Va de 00 a 23.

minute

integer

El minuto en 2 dígitos. Va de 00 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 utiliza 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 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 Horario especial para adultos 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. Una referencia que representa esta foto del lugar que se puede utilizar para buscar esta foto de lugar nuevamente (también se denomina el nombre del "recurso" de la API: places/{placeId}/photos/{photo}).

widthPx

integer

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

heightPx

integer

La altura máxima disponible en píxeles.

authorAttributions[]

object (AuthorAttribution)

Los autores de esta foto

flagContentUri

string

Un vínculo mediante el cual los usuarios pueden marcar un problema con la foto.

googleMapsUri

string

Un vínculo para mostrar la foto en Google Maps.

BusinessStatus

Estado de la empresa del lugar.

Enumeraciones
BUSINESS_STATUS_UNSPECIFIED Valor predeterminado Este valor no se usa.
OPERATIONAL El establecimiento está en funcionamiento, no necesariamente abierto en la actualidad.
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 No se especificó el nivel de precios del lugar o se desconoce.
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

URI al 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

Place solo acepta efectivo como forma de pago. 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

Este lugar ofrece estacionamiento gratuito.

paidParkingLot

boolean

Este lugar ofrece estacionamiento pagado.

freeStreetParking

boolean

Este 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

Este lugar ofrece estacionamiento accesible para personas en silla de ruedas.

wheelchairAccessibleEntrance

boolean

El lugar tiene 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 cuenta con espacio accesible 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 definido en la norma ISO 4217.

units

string (int64 format)

La unidad entera del importe. Por ejemplo, si currencyCode es "USD", entonces 1 unidad es 1 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)

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 de 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 más representa la capacidad de cargar un vehículo de la marca Tesla en una estación de carga de este tipo.
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 diferente sobre el área.

flagContentUri

string

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

ContentBlock

Es un bloque de contenido que se puede entregar de manera 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 puntos de referencia 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 puntos de referencia son lugares prominentes que se pueden utilizar 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

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 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 Está en la misma ruta que el punto de referencia, pero no al otro lado ni al otro lado.
AROUND_THE_CORNER No está en la misma ruta que el punto de referencia, pero a solo una vuelta.
BEHIND Está cerca de la estructura del punto de referencia, pero más lejos de las entradas.

Á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

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 de segmentación se encuentra dentro de la región del área, cerca del límite.
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 las ubicaciones.

searchText

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