- Recurso: Place
- LocalizedText
- AddressComponent
- PlusCode
- LatLng
- Ventana gráfica
- Revisión
- AuthorAttribution
- OpeningHours
- Período
- Punto
- Fecha
- SecondaryHoursType
- SpecialDay
- Foto
- BusinessStatus
- PriceLevel
- Attribution
- PaymentOptions
- ParkingOptions
- SubDestination
- AccessibilityOptions
- FuelOptions
- FuelPrice
- FuelType
- Dinero
- EVChargeOptions
- ConnectorAggregation
- EVConnectorType
- GenerativeSummary
- Referencias
- AreaSummary
- ContentBlock
- ContainingPlace
- AddressDescriptor
- Punto de referencia
- SpatialRelationship
- Área
- Contención
- GoogleMapsLinks
- PriceRange
- Métodos
Recurso: Place
Toda la información que representa un lugar.
Representación JSON |
---|
{ "name": string, "id": string, "displayName": { object ( |
Campos | |
---|---|
name |
Es el nombre del recurso de este lugar, en formato |
id |
Es el identificador único de un lugar. |
display |
El nombre localizado del lugar, adecuado como una descripción breve legible por humanos. Por ejemplo, “Google Sídney”, “Starbucks”, “Pyrmont”, etcétera. |
types[] |
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. |
primary |
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. |
primary |
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. |
national |
Es un número de teléfono legible del lugar en formato nacional. |
international |
Es un número de teléfono legible del lugar en formato internacional. |
formatted |
Una dirección completa y legible por humanos de este lugar. |
short |
Es una dirección corta y legible por humanos de este lugar. |
address |
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. |
plus |
Código plus de la latitud y longitud de la ubicación del lugar |
location |
Es la posición de este lugar. |
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 |
Es una calificación entre 1.0 y 5.0, según las opiniones de los usuarios sobre este lugar. |
google |
Una URL que proporciona más información sobre este lugar. |
website |
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[] |
Es la lista de opiniones sobre este lugar, ordenadas según su relevancia. Se puede mostrar un máximo de 5 opiniones. |
regular |
El horario de atención habitual. |
photos[] |
Información (incluidas las referencias) sobre las fotos de este lugar. Se pueden mostrar un máximo de 10 fotos. |
adr |
La dirección del lugar en el microformato adr: http://microformats.org/wiki/adr. |
business |
|
price |
Es el nivel de precios del lugar. |
attributions[] |
Es un conjunto de proveedores de datos que se debe mostrar con este resultado. |
icon |
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"). |
icon |
Es el color de fondo de icon_mask en formato hexadecimal, p.ej., #909CE1. |
current |
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. |
current |
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. |
regular |
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. |
editorial |
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. |
payment |
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á. |
parking |
Son las opciones de estacionamiento que ofrece el lugar. |
sub |
Es una lista de destinos secundarios relacionados con el lugar. |
fuel |
La información más reciente sobre las opciones de combustible en una gasolinera. Esta información se actualiza con regularidad. |
ev |
Información sobre las opciones de carga de VE. |
generative |
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. |
area |
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. |
containing |
Es la lista de lugares en los que se encuentra el lugar actual. |
address |
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. |
google |
Vínculos para activar diferentes acciones de Google Maps. |
price |
Es el rango de precios asociado con un lugar. |
utc |
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. |
user |
Es la cantidad total de opiniones (con o sin texto) de este lugar. |
takeout |
Especifica si la empresa admite la función de llevar. |
delivery |
Especifica si la empresa admite entregas. |
dine |
Especifica si la empresa admite opciones de asientos en interiores o exteriores. |
curbside |
Especifica si la empresa admite retiros en la puerta. |
reservable |
Especifica si el lugar admite reservas. |
serves |
Especifica si el lugar sirve desayuno. |
serves |
Especifica si el lugar ofrece almuerzo. |
serves |
Especifica si el lugar sirve cena. |
serves |
Especifica si el lugar sirve cerveza. |
serves |
Especifica si el lugar sirve vino. |
serves |
Especifica si el lugar sirve brunch. |
serves |
Especifica si el lugar ofrece comida vegetariana. |
outdoor |
El lugar tiene asientos al aire libre. |
live |
El lugar ofrece música en vivo. |
menu |
El lugar tiene un menú para niños. |
serves |
El lugar sirve cocteles. |
serves |
Lugar donde se sirven postres. |
serves |
El lugar sirve café. |
good |
El lugar es apto para niños. |
allows |
El lugar permite perros. |
restroom |
El lugar tiene sanitario. |
good |
El lugar admite grupos. |
good |
El lugar es adecuado para mirar deportes. |
accessibility |
Información sobre las opciones de accesibilidad que ofrece un lugar. |
pure |
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 |
A continuación, se muestra una cadena localizada en el idioma correspondiente a |
language |
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 | |
---|---|
long |
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". |
short |
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[] |
Es un array que indica los tipos de componentes de la dirección. |
language |
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 | |
---|---|
global |
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). |
compound |
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 |
La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0]. |
longitude |
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 yhigh.longitude
= 180 grados, la ventana de visualización incluye todas las longitudes.Si
low.longitude
= 180 grados yhigh.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 ( |
Campos | |
---|---|
low |
Obligatorio. Es el punto inferior de la vista del puerto. |
high |
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 ( |
Campos | |
---|---|
name |
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: |
relative |
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 |
Es el texto localizado de la opinión. |
original |
Es el texto de la opinión en su idioma original. |
rating |
Un número entre 1.0 y 5.0, también llamado cantidad de estrellas. |
author |
Es el autor de esta opinión. |
publish |
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: |
flag |
Un vínculo en el que los usuarios pueden marcar un problema con la opinión. |
google |
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 | |
---|---|
display |
|
uri |
|
photo |
|
OpeningHours
Información sobre el horario de atención del lugar.
Representación JSON |
---|
{ "periods": [ { object ( |
Campos | |
---|---|
periods[] |
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. |
weekday |
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" |
secondary |
Es una cadena de tipo que se usa para identificar el tipo de horas secundarias. |
special |
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. |
next |
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: |
next |
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: |
open |
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 ( |
Campos | |
---|---|
open |
La hora en la que el lugar comienza a estar abierto. |
close |
La hora a la que el lugar comienza a cerrarse. |
Punto
Puntos de cambio de estado
Representación JSON |
---|
{
"date": {
object ( |
Campos | |
---|---|
date |
Fecha en la zona horaria local del lugar |
truncated |
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 |
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 |
La hora en 2 dígitos. Va de 00 a 23. |
minute |
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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Representación JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year |
Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año. |
month |
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 |
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 ( |
Campos | |
---|---|
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 ( |
Campos | |
---|---|
name |
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: |
width |
Es el ancho máximo disponible, en píxeles. |
height |
La altura máxima disponible en píxeles. |
author |
Los autores de esta foto |
flag |
Un vínculo mediante el cual los usuarios pueden marcar un problema con la foto. |
google |
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 |
Es el nombre del proveedor de datos del lugar. |
provider |
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 | |
---|---|
accepts |
El lugar acepta pagos con tarjetas de crédito. |
accepts |
El lugar acepta tarjetas de débito como forma de pago. |
accepts |
Place solo acepta efectivo como forma de pago. Es posible que los lugares con este atributo acepten otras formas de pago. |
accepts |
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 | |
---|---|
free |
Este lugar ofrece estacionamiento gratuito. |
paid |
Este lugar ofrece estacionamiento pagado. |
free |
Este lugar ofrece estacionamiento gratuito en la calle. |
paid |
El lugar ofrece estacionamiento pagado en la calle. |
valet |
El lugar ofrece servicio de estacionamiento. |
free |
El lugar ofrece estacionamiento en cochera gratuito. |
paid |
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 |
Es el nombre del recurso del destino secundario. |
id |
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 | |
---|---|
wheelchair |
Este lugar ofrece estacionamiento accesible para personas en silla de ruedas. |
wheelchair |
El lugar tiene entrada accesible para personas en silla de ruedas. |
wheelchair |
El lugar tiene sanitarios accesibles para personas en silla de ruedas. |
wheelchair |
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 ( |
Campos | |
---|---|
fuel |
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 ( |
Campos | |
---|---|
type |
Es el tipo de combustible. |
price |
Es el precio del combustible. |
update |
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: |
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 | |
---|---|
currency |
Es el código de moneda de tres letras definido en la norma ISO 4217. |
units |
La unidad entera del importe. Por ejemplo, si |
nanos |
Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si |
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 ( |
Campos | |
---|---|
connector |
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. |
connector |
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 ( |
Campos | |
---|---|
type |
El tipo de conector de esta agregación. |
max |
Es la tasa de carga máxima estática en kW de cada conector en la agregación. |
count |
Cantidad de conectores en esta agregación. |
availability |
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: |
available |
Cantidad de conectores de esta agregación que están disponibles actualmente. |
out |
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 ( |
Campos | |
---|---|
overview |
Es la descripción general del lugar. |
overview |
Un vínculo en el que los usuarios pueden marcar un problema con el resumen general. |
description |
Es la descripción detallada del lugar. |
description |
Es un vínculo en el que los usuarios pueden marcar un problema con el resumen de la descripción. |
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 ( |
Campos | |
---|---|
reviews[] |
Opiniones que sirven como referencias |
places[] |
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 ( |
Campos | |
---|---|
content |
Bloques de contenido que componen el resumen del área Cada bloque tiene un tema diferente sobre el área. |
flag |
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 ( |
Campos | |
---|---|
topic |
Es el tema del contenido, por ejemplo, "descripción general" o "restaurante". |
content |
Contenido relacionado con el tema |
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 |
Es el nombre del recurso del lugar en el que se encuentra este lugar. |
id |
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 ( |
Campos | |
---|---|
landmarks[] |
Una lista clasificada de puntos de referencia cercanos. Los lugares de interés más reconocibles y cercanos se clasifican primero. |
areas[] |
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 ( |
Campos | |
---|---|
name |
Es el nombre del recurso del punto de referencia. |
place |
El ID de Place del lugar de interés |
display |
Es el nombre visible del lugar de interés. |
types[] |
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. |
spatial |
Define la relación espacial entre la ubicación de destino y el punto de referencia. |
straight |
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 |
travel |
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 ( |
Campos | |
---|---|
name |
El nombre del recurso del área. |
place |
Es el ID de lugar del área. |
display |
Es el nombre visible del área. |
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. |
GoogleMapsLinks
Vínculos para activar diferentes acciones de Google Maps.
Representación JSON |
---|
{ "directionsUri": string, "placeUri": string, "writeAReviewUri": string, "reviewsUri": string, "photosUri": string } |
Campos | |
---|---|
directions |
Un vínculo para mostrar las instrucciones sobre cómo llegar al lugar El vínculo solo propaga la ubicación de destino y usa el modo de viaje predeterminado |
place |
Un vínculo para mostrar este lugar. |
write |
Un vínculo para escribir una opinión sobre este lugar Por el momento, este vínculo no es compatible con Google Maps para dispositivos móviles y solo funciona en la versión web de Google Maps. |
reviews |
Un vínculo para mostrar las opiniones de este lugar. Por el momento, este vínculo no es compatible con Google Maps para dispositivos móviles y solo funciona en la versión web de Google Maps. |
photos |
Es un vínculo para mostrar fotos de este lugar. Este vínculo no es compatible actualmente con Google Maps para dispositivos móviles y solo funciona en la versión web de Google Maps. |
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 ( |
Campos | |
---|---|
start |
Es el límite inferior del rango de precios (inclusivo). El precio debe ser igual o superior a este importe. |
end |
Es el límite superior del rango de precios (exclusivo). El precio debe ser inferior a este importe. |
Métodos |
|
---|---|
|
Muestra las predicciones para la entrada determinada. |
|
Obtén los detalles de un lugar según su nombre de recurso, que es una cadena en formato places/{place_id} . |
|
Busca lugares cerca de las ubicaciones. |
|
Búsqueda de lugares basada en una búsqueda de texto. |