REST Resource: places

{
  "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)
  },
  "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)
  }
}

string

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

string

Es el identificador único de un lugar.

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.

string

Un conjunto de etiquetas de tipo para este resultado. Por ejemplo, "política" y "locality". Para obtener una lista completa de los valores posibles, consulta las tablas A y B en https://developers.google.com/maps/documentation/places/web-service/place-types.

string

Es el tipo principal del resultado dado. Este tipo debe ser uno de los tipos admitidos por la API de Places. Por ejemplo, "restaurante", "cafetería", "aeropuerto", etc. Un lugar solo puede tener un solo tipo principal. Para obtener una lista completa de los valores posibles, consulta las tablas A y B en https://developers.google.com/maps/documentation/places/web-service/place-types.

object (LocalizedText)

El nombre visible del tipo principal, localizado en el idioma de la solicitud, si corresponde. Para obtener una lista completa de los valores posibles, consulta las tablas A y B en https://developers.google.com/maps/documentation/places/web-service/place-types.

string

Es un número de teléfono legible del lugar en formato nacional.

string

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

string

Una dirección completa y legible por humanos de este lugar.

string

Una dirección corta y legible del lugar para este lugar.

object (AddressComponent)

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

object (PlusCode)

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

object (LatLng)

La posición de este lugar.

object (Viewport)

Un viewport adecuado para mostrar el lugar en un mapa de tamaño promedio

number

Una calificación entre 1.0 y 5.0, basada en los comentarios de los usuarios sobre este lugar.

string

Una URL que proporciona más información sobre este lugar.

string

El sitio web autorizado para este lugar, p.ej., “a business” página principal. Ten en cuenta que, en el caso de los lugares que forman parte de una cadena (p.ej., una tienda de IKEA), suele ser el sitio web de la tienda individual, no de la cadena general.

object (Review)

Lista de opiniones sobre este lugar, ordenadas por relevancia. Se puede devolver un máximo de 5 opiniones.

object (OpeningHours)

El horario habitual de atención.

object (Photo)

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

string

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

enum (BusinessStatus)

Es el estado de la empresa del lugar.

enum (PriceLevel)

Es el nivel de precios del lugar.

object (Attribution)

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

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").

string

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

object (OpeningHours)

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

object (OpeningHours)

Contiene un array de entradas para los próximos siete días e incluye información sobre el horario de atención secundario de una empresa. El horario secundario es diferente del horario principal de una empresa. Por ejemplo, un restaurante puede especificar el horario de atención al público o de entrega a domicilio como su horario secundario. Este campo propaga el subcampo de tipo, que se obtiene 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.

object (OpeningHours)

Contiene un array de entradas para obtener información acerca del horario de atención secundario normal de una empresa. El horario secundario es diferente del horario principal de una empresa. Por ejemplo, un restaurante puede especificar el horario de atención al público o de entrega a domicilio como su horario secundario. Este campo propaga el subcampo de tipo, que se obtiene de una lista predefinida de tipos de horarios de atención (como drive_THROUGH, PICKUP o takeOUT) según los tipos de lugares.

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 para estos, si corresponde. El texto de resumen se debe presentar tal como está y no puede modificarse ni alterarse.

object (PaymentOptions)

Opciones de pago que acepta el lugar. Si los datos de una opción de pago no están disponibles, se desactivará el campo de opción de pago.

object (ParkingOptions)

Las opciones de estacionamiento que proporciona el lugar.

object (SubDestination)

Es una lista de subdestinos relacionados con el lugar.

object (FuelOptions)

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

object (EVChargeOptions)

Información sobre las opciones de carga para vehículos eléctricos.

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.

object (AreaSummary)

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

Resumen generado por IA del área en la que se encuentra el lugar.

integer

Cantidad de minutos que la zona horaria de este lugar está desfasada actualmente con respecto a UTC. Esto se expresa en minutos para admitir zonas horarias que se desplazan por fracciones de hora, p.ej., X horas y 15 minutos.

integer

Cantidad total de opiniones (con o sin texto) sobre este lugar.

boolean

Especifica si la empresa admite comida para llevar.

boolean

Especifica si la empresa admite entregas.

boolean

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

boolean

Especifica si la empresa admite retiros en la puerta.

boolean

Especifica si el lugar admite reservas.

boolean

Especifica si el lugar sirve desayuno.

boolean

Especifica si el lugar sirve almuerzo.

boolean

Especifica si el lugar sirve cenas.

boolean

Especifica si el lugar sirve cerveza.

boolean

Especifica si el lugar sirve vino.

boolean

Especifica si el lugar sirve brunch.

boolean

Especifica si el lugar sirve comida vegetariana.

boolean

El lugar cuenta con asientos al aire libre.

boolean

El lugar ofrece música en vivo.

boolean

El lugar tiene un menú para niños.

boolean

Lugar donde se sirven cocteles.

boolean

Lugar donde se sirven postres.

boolean

Lugar en el que se sirve café.

boolean

El lugar es apto para niños.

boolean

El lugar admite perros.

boolean

El lugar tiene sanitario.

boolean

El lugar tiene capacidad para grupos.

boolean

El lugar es adecuado para mirar deportes.

object (AccessibilityOptions)

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

{
  "text": string,
  "languageCode": string
}

string

A continuación, se muestra una cadena localizada en el idioma correspondiente a 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.

{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}

string

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

string

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

string

Un array que indica los tipos de componentes de la dirección.

string

El lenguaje que se usa para dar formato a estos componentes, en notación CLDR.

{
  "globalCode": string,
  "compoundCode": string
}

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).

string

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.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

Obligatorio. Es el punto inferior del viewport.

object (LatLng)

Obligatorio. Es el punto superior del viewport.

{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}

string

Referencia que representa esta opinión del lugar que se puede utilizar para buscar esta opinión del lugar nuevamente (también se denomina nombre del "recurso" de la API: places/{placeId}/reviews/{review}).

string

Es una cadena de hora reciente con formato que expresa el tiempo de revisión relativo a la hora actual en un formato adecuado para el idioma y el país.

object (LocalizedText)

Es el texto localizado de la opinión.

object (LocalizedText)

Texto de la opinión en su idioma original

number

Un número entre 1.0 y 5.0, que también se denomina número de estrellas.

object (AuthorAttribution)

Autor de esta opinión.

string (Timestamp format)

Marca de tiempo de la revisió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".

{
  "displayName": string,
  "uri": string,
  "photoUri": string
}

string

Es el nombre del autor de Photo o Review.

string

Es el URI del autor de Photo o Review.

string

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

{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}

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 renovaciones.

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 de 18:00 a.m. a 6:00 p.m.".

enum (SecondaryHoursType)

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

object (SpecialDay)

Información estructurada para días especiales que se encuentran dentro del período que cubre el horario de atención que se muestra. Los días especiales son aquellos que podrían afectar el horario de atención de un lugar, p.ej., Día de Navidad. Se establece en currentOpeningHours y currentSecondaryOpeningHours si hay horarios excepcionales.

boolean

¿Este lugar está abierto en este momento? Siempre está presente, a menos que no tengamos datos sobre la hora del día o la zona horaria en relación con estos horarios de atención.

{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}

object (Point)

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

object (Point)

La hora a la que el lugar comienza a cerrarse.

{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}

object (Date)

Fecha en la zona horaria local del lugar

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 devuelvan un máximo de 24 * 7 horas a partir de la medianoche del día de la solicitud.

integer

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

integer

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

integer

El minuto en 2 dígitos. Va de 00 a 59.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

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.

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.

{
  "date": {
    object (Date)
  }
}

object (Date)

La fecha de este día especial.

{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}

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}).

integer

El ancho máximo disponible en píxeles.

integer

La altura máxima disponible en píxeles.

object (AuthorAttribution)

Autores de esta foto.

{
  "provider": string,
  "providerUri": string
}

string

Nombre del proveedor de datos del lugar.

string

URI al proveedor de datos del lugar.

{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}

boolean

Place acepta tarjetas de crédito como pago.

boolean

Place acepta tarjetas de débito como forma de pago.

boolean

Place solo acepta efectivo como forma de pago. Es posible que los lugares con este atributo acepten otras formas de pago.

boolean

Place acepta pagos NFC.

{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}

boolean

Este lugar ofrece estacionamiento gratuito.

boolean

Este lugar ofrece estacionamiento pagado.

boolean

Este lugar ofrece estacionamiento gratuito en la calle.

boolean

Este lugar ofrece estacionamiento en la calle pagado.

boolean

El lugar ofrece servicio de estacionamiento.

boolean

Este lugar ofrece estacionamiento en cochera gratuito.

boolean

Este lugar ofrece estacionamiento pagado en cochera.

{
  "name": string,
  "id": string
}

string

El nombre del recurso del subdominio.

string

Es el ID de lugar del subdominio.

{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}

boolean

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

boolean

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

boolean

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

boolean

El lugar cuenta con espacio accesible para personas en silla de ruedas.

{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}

object (FuelPrice)

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

{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}

enum (FuelType)

El tipo de combustible.

object (Money)

El precio del combustible.

string (Timestamp format)

Fecha y hora en la que se actualizó el precio del combustible 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".

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

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

string (int64 format)

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

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.

{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}

integer

Cantidad de conectores en esta estación. Sin embargo, como 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.

object (ConnectorAggregation)

Una lista de agregaciones de conectores de carga de VE que contienen conectores del mismo tipo y la misma velocidad de carga.

{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}

enum (EVConnectorType)

El tipo de conector de esta agregación.

number

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

integer

Cantidad de conectores en esta agregación.

string (Timestamp format)

La marca de tiempo de cuando se actualizó por última vez 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".

integer

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

integer

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

{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

object (LocalizedText)

La descripción general del lugar.

object (LocalizedText)

Es la descripción detallada del lugar.

object (References)

Referencias que se usan para generar la descripción resumida.

{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}

object (Review)

Opiniones que funcionan como referencias.

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 aceptan nombres de recursos de Places.

{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}

object (ContentBlock)

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

{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

string

El tema del contenido (por ejemplo, "descripción general") o "restaurante".

object (LocalizedText)

Contenido relacionado con el tema.

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.