Package google.maps.places.v1

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.

string

Obligatorio. Cadena de texto en la que se realiza la búsqueda

LocationBias

Opcional. Personalizar resultados en función de una ubicación específica

Se debe establecer location_bias o location_restriction como máximo. Si no se establece ninguna, los resultados se personalizarán según la dirección IP. Esto significa que la dirección IP se asignará a una ubicación imprecisa y se utilizará como señal de personalización.

LocationRestriction

Opcional. Restringe los resultados a una ubicación específica.

Se debe establecer location_bias o location_restriction como máximo. Si no se establece ninguna, los resultados se personalizarán según la dirección IP. Esto significa que la dirección IP se asignará a una ubicación imprecisa y se utilizará como señal de personalización.

string

Opcional. Se incluyó el tipo de lugar principal (por ejemplo, "restaurante" o "gas_station") de la Tabla A o la Tabla B en los Tipos de Lugar (https://developers.google.com/maps/documentation/places/web-service/place-types), o solo (regiones) o solo (ciudades). Un sitio solo se devuelve si su tipo principal se incluye en esta lista. Se pueden especificar hasta 5 valores. Si no se especifican tipos, se muestran todos los tipos de lugar.

string

Opcional. Solo incluye resultados en las regiones especificadas, con un máximo de 15 códigos de región CLDR de dos caracteres. Un conjunto vacío no restringirá los resultados. Si se configuran location_restriction y included_region_codes, los resultados se ubicarán en el área de intersección.

string

Opcional. El idioma en el que se mostrarán los resultados. La configuración predeterminada es en-US. Los resultados pueden estar en varios idiomas si el idioma utilizado en input es diferente de language_code o si el lugar que se muestra no tiene una traducción del idioma local al language_code.

string

Opcional. Es el código de región, especificado como un código de región CLDR de dos caracteres. Esto afecta el formato de la dirección y la clasificación de los resultados, y puede influir en los resultados que se muestran. Esto no restringe los resultados a la región especificada. Para restringir los resultados a una región, usa region_code_restriction.

LatLng

Opcional. Punto de origen desde el que se calcula la distancia geodésica hasta el destino (se muestra como distance_meters). Si se omite este valor, no se mostrará la distancia geodésica.

int32

Opcional. Un desplazamiento de caracteres Unicode basado en cero de input que indica la posición del cursor en input. La posición del cursor puede influir en las predicciones que se muestran.

Si está vacío, el valor predeterminado es la longitud de input.

bool

Opcional. Si es verdadero, la respuesta incluirá las predicciones de Places y de consultas. De lo contrario, la respuesta solo mostrará predicciones de Places.

string

Opcional. Es una cadena que identifica una sesión de Autocomplete con fines de facturación. Debe ser una string base64 segura de URL y nombre de archivo con un máximo de 36 caracteres ASCII de longitud. De lo contrario, se muestra un error INVALID_ARGUMENT.

La sesión se inicia cuando el usuario comienza a escribir una consulta y termina cuando selecciona un lugar y se realiza una llamada a Place Details o Address Validation. Cada sesión puede tener varias consultas, seguidas de una solicitud de Place Details o Address Validation. Las credenciales que se usan para cada solicitud dentro de una sesión deben pertenecer al mismo proyecto de la consola de Google Cloud. Una vez que finaliza la sesión, el token deja de ser válido; tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro session_token, o si reutilizas un token de sesión, la sesión se cobrará como si no se hubiera proporcionado un token de sesión (cada solicitud se factura por separado).

Recomendamos los siguientes lineamientos:

• Usa tokens de sesión para todas las llamadas de Place Autocomplete.
• Genera un token nuevo para cada sesión. Se recomienda usar un UUID de versión 4.
• Asegúrate de que las credenciales que se usan para todas las solicitudes de Place Autocomplete, Place Details y Address Validation dentro de una sesión pertenezcan al mismo proyecto de la consola de Cloud.
• Asegúrate de pasar un token de sesión único para cada sesión nueva. Si usas el mismo token en más de una sesión, cada solicitud se facturará de forma individual.

Viewport

Un viewport definido por una esquina noreste y suroeste

Circle

Es un círculo definido por un punto central y un radio.

Viewport

Un viewport definido por una esquina noreste y suroeste

Circle

Es un círculo definido por un punto central y un radio.

Suggestion

Contiene una lista de sugerencias, ordenadas de forma descendente según su relevancia.

PlacePrediction

Es una predicción de un lugar.

QueryPrediction

Una predicción para una consulta.

string

Texto que se puede utilizar tal como está o que se puede utilizar con el formato matches.

StringRange

Una lista de rangos de cadenas que identifican el lugar en el que la solicitud de entrada coincidió en text. Los rangos se pueden usar para dar formato a partes específicas de text. Es posible que las substrings no sean coincidencias exactas de input si la coincidencia se determinó mediante criterios distintos de la coincidencia de cadenas (por ejemplo, correcciones ortográficas o transliteraciones).

Estos valores son desplazamientos de caracteres Unicode de text. Se garantiza que los rangos están ordenados en valores de desplazamiento crecientes.

string

El nombre del recurso del sitio sugerido. Este nombre se puede usar en otras APIs que aceptan nombres de lugar.

string

Es el identificador único del lugar sugerido. Este identificador se puede usar en otras APIs que aceptan IDs de lugar.

FormattableText

Contiene el nombre legible del resultado que se muestra. Para los resultados de establecimientos, suele incluir el nombre y la dirección de la empresa.

Se recomienda text para los desarrolladores que desean mostrar un solo elemento de la IU. Es posible que los desarrolladores que deseen mostrar dos elementos de IU separados, pero relacionados, quieran usar structured_format en su lugar. Son dos formas diferentes de representar una predicción de lugar. Los usuarios no deben intentar analizar structured_format en text o viceversa.

Este texto puede diferir del display_name que devuelve GetPlace.

Puede estar en varios idiomas si la solicitud input y language_code están en diferentes idiomas o si el lugar no tiene una traducción del idioma local al language_code.

StructuredFormat

Un desglose de la predicción del lugar en texto principal que contiene el nombre del lugar y un texto secundario que contenga características adicionales que desambiguan (como una ciudad o región).

Se recomienda structured_format para los desarrolladores que desean mostrar dos elementos de la IU separados pero relacionados. Los desarrolladores que deseen mostrar un solo elemento de la IU pueden usar text en su lugar. Son dos formas diferentes de representar una predicción de lugar. Los usuarios no deben intentar analizar structured_format en text o viceversa.

string

Lista de los tipos que se aplican a este lugar de la Tabla A o de la Tabla B en https://developers.google.com/maps/documentation/places/web-service/place-types.

Un tipo es una categorización de un lugar. Los lugares que se compartan con tipos de lugares tendrán características similares.

int32

La longitud de la línea geodésica en metros desde origin si se especifica origin. Es posible que algunas predicciones, como las rutas, no propaguen este campo.

FormattableText

Es el texto predicho. Este texto no representa un lugar, sino una consulta de texto que podría usarse en un punto final de búsqueda (por ejemplo, Text Search).

Se recomienda text para los desarrolladores que desean mostrar un solo elemento de la IU. Es posible que los desarrolladores que deseen mostrar dos elementos de IU separados, pero relacionados, quieran usar structured_format en su lugar. Son dos formas diferentes de representar una predicción de consulta. Los usuarios no deben intentar analizar structured_format en text o viceversa.

Puede estar en varios idiomas si la solicitud input y language_code están en diferentes idiomas o si parte de la consulta no tiene una traducción del idioma local al language_code.

StructuredFormat

Un desglose de la predicción de la consulta en texto principal que contiene la consulta y el texto secundario, que contiene atributos adicionales que desambiguan (como una ciudad o región).

Se recomienda structured_format para los desarrolladores que desean mostrar dos elementos de la IU separados pero relacionados. Los desarrolladores que deseen mostrar un solo elemento de la IU pueden usar text en su lugar. Son dos formas diferentes de representar una predicción de consulta. Los usuarios no deben intentar analizar structured_format en text o viceversa.

int32

Desplazamiento basado en cero del primer carácter Unicode de la string (inclusive).

int32

Desplazamiento basado en cero del último carácter Unicode (exclusivo).

FormattableText

Representa el nombre del lugar o la consulta.

FormattableText

Representa características adicionales que desambiguan (como una ciudad o región) para identificar mejor el lugar o definir mejor la consulta.

LatLng

Obligatorio. Latitud y longitud centrales.

El rango de latitud debe estar dentro de [-90.0, 90.0]. El rango de longitud debe estar dentro de [-180.0, 180.0].

double

Obligatorio. Radio medido en metros El radio debe estar dentro de [0.0, 50,000.0].

string

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

LocalizedText

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.

Review

Lista de opiniones acerca de este lugar, relacionadas con la búsqueda del lugar.

Photo

Información (incluidas las referencias) sobre las fotos de este lugar, relacionadas con la consulta del lugar.

Justification

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

Justificaciones para el lugar

ReviewJustification

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

BusinessAvailabilityAttributesJustification

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

bool

Si un lugar ofrece comida para llevar.

bool

Si un lugar ofrece entregas a domicilio.

bool

Si un lugar ofrece opciones para comer allí.

HighlightedText

Review

La opinión a partir de la cual se genera el texto destacado.

string

HighlightedTextRange

Es la lista de los rangos del texto destacado.

int32

int32

int32

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.

ConnectorAggregation

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

EVConnectorType

El tipo de conector de esta agregación.

double

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

int32

Cantidad de conectores en esta agregación.

Timestamp

La marca de tiempo de cuando se actualizó por última vez la información de disponibilidad del conector en esta agregación.

int32

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

int32

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

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.

FuelType

El tipo de combustible.

Money

El precio del combustible.

Timestamp

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

string

Obligatorio. El nombre del recurso de un medio de foto en el formato: places/{place_id}/photos/{photo_reference}/media.

El nombre de recurso de una foto como se muestra en el campo photos.name de un objeto Place tiene el formato places/{place_id}/photos/{photo_reference}. Debes agregar /media al final del recurso de foto para obtener el nombre del recurso multimedia de la foto.

int32

Opcional. Especifica el ancho máximo deseado (en píxeles) de la imagen. Si la imagen es más pequeña que los valores especificados, se devolverá la imagen original. Si la imagen es más grande en dimensión, se ajustará para que coincida con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original. Las propiedades max_height_px y max_width_px aceptan un número entero entre 1 y 4,800, inclusive. Si el valor no está dentro del rango permitido, se mostrará un error INVALID_ARGUMENT.

Se debe especificar, al menos, uno de los valores de max_height_px o max_width_px. Si no se especifica max_height_px ni max_width_px, se mostrará un error INVALID_ARGUMENT.

int32

Opcional. Especifica la altura máxima deseada (en píxeles) para la imagen. Si la imagen es más pequeña que los valores especificados, se devolverá la imagen original. Si la imagen es más grande en dimensión, se ajustará para que coincida con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original. Las propiedades max_height_px y max_width_px aceptan un número entero entre 1 y 4,800, inclusive. Si el valor no está dentro del rango permitido, se mostrará un error INVALID_ARGUMENT.

Se debe especificar, al menos, uno de los valores de max_height_px o max_width_px. Si no se especifica max_height_px ni max_width_px, se mostrará un error INVALID_ARGUMENT.

bool

Opcional. Si se configura, omite el comportamiento predeterminado de redireccionamiento HTTP y renderiza una respuesta en formato de texto (por ejemplo, en formato JSON para casos de uso de HTTP). Si no se establece, se emitirá un redireccionamiento HTTP para redireccionar la llamada al medio de la imagen. Esta opción se ignora para solicitudes que no son HTTP.

string

Obligatorio. El nombre de recurso de un lugar, en formato places/{place_id}.

string

Opcional. Los detalles del lugar se mostrarán en el idioma preferido, si está disponible.

Lista actual de idiomas admitidos: https://developers.google.com/maps/faq#languagesupport.

string

Opcional. El código Unicode de país o región (CLDR) de la ubicación de donde proviene la solicitud. Este parámetro se usa para mostrar los detalles del lugar, como el nombre del lugar específico de una región, si está disponible. El parámetro puede afectar los resultados según la ley aplicable. Para obtener más información, consulta https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Ten en cuenta que actualmente no se admiten los códigos regionales de 3 dígitos.

string

Opcional. Es una cadena que identifica una sesión de Autocomplete con fines de facturación. Debe ser una string base64 segura de URL y nombre de archivo con un máximo de 36 caracteres ASCII de longitud. De lo contrario, se muestra un error INVALID_ARGUMENT.

La sesión se inicia cuando el usuario comienza a escribir una consulta y termina cuando selecciona un lugar y se realiza una llamada a Place Details o Address Validation. Cada sesión puede tener varias consultas, seguidas de una solicitud de Place Details o Address Validation. Las credenciales que se usan para cada solicitud dentro de una sesión deben pertenecer al mismo proyecto de la consola de Google Cloud. Una vez que finaliza la sesión, el token deja de ser válido; tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro session_token, o si reutilizas un token de sesión, la sesión se cobrará como si no se hubiera proporcionado un token de sesión (cada solicitud se factura por separado).

Recomendamos los siguientes lineamientos:

• Usa tokens de sesión para todas las llamadas de Place Autocomplete.
• Genera un token nuevo para cada sesión. Se recomienda usar un UUID de versión 4.
• Asegúrate de que las credenciales que se usan para todas las solicitudes de Place Autocomplete, Place Details y Address Validation dentro de una sesión pertenezcan al mismo proyecto de la consola de Cloud.
• Asegúrate de pasar un token de sesión único para cada sesión nueva. Si usas el mismo token en más de una sesión, cada solicitud se facturará de forma individual.

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/{place_id}/photos/{photo}).

int32

El ancho máximo disponible en píxeles.

int32

La altura máxima disponible en píxeles.

AuthorAttribution

Autores de esta foto.

string

El nombre del recurso de un medio de foto en el formato: places/{place_id}/photos/{photo_reference}/media.

string

Es un URI de corta duración que se puede usar para renderizar la foto.

string

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

string

Es el identificador único de un lugar.

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

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.

AddressComponent

Componentes repetidos para cada nivel de localidad. Ten en cuenta lo siguiente sobre el array address_components[]: - El array de componentes de dirección puede contener más componentes que el valor de formatted_address. - La matriz no incluye necesariamente todas las entidades políticas que contienen una dirección, además de las incluidas en format_address. 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, el número de address_components 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

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

LatLng

La posición de este lugar.

Viewport

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

double

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., 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), suele ser el sitio web de la tienda individual, no de la cadena general.

Review

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

OpeningHours

El horario habitual de atención.

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.

BusinessStatus

Es el estado de la empresa del lugar.

PriceLevel

Es el nivel de precios del lugar.

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.

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

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

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.

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.

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.

ParkingOptions

Las opciones de estacionamiento que proporciona el lugar.

SubDestination

Es una lista de subdestinos relacionados con el lugar.

FuelOptions

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

EVChargeOptions

Información sobre las opciones de carga para vehículos

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

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.

int32

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.

int32

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

bool

Especifica si la empresa admite comida para llevar.

bool

Especifica si la empresa admite entregas.

bool

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

bool

Especifica si la empresa admite retiros en la puerta.

bool

Especifica si el lugar admite reservas.

bool

Especifica si el lugar sirve desayuno.

bool

Especifica si el lugar sirve almuerzo.

bool

Especifica si el lugar sirve cenas.

bool

Especifica si el lugar sirve cerveza.

bool

Especifica si el lugar sirve vino.

bool

Especifica si el lugar sirve brunch.

bool

Especifica si el lugar sirve comida vegetariana.

bool

El lugar cuenta con asientos al aire libre.

bool

El lugar ofrece música en vivo.

bool

El lugar tiene un menú para niños.

bool

Lugar donde se sirven cocteles.

bool

Lugar donde se sirven postres.

bool

Lugar en el que se sirve café.

bool

El lugar es apto para niños.

bool

El lugar admite perros.

bool

El lugar tiene sanitario.

bool

El lugar tiene capacidad para grupos.

bool

El lugar es adecuado para mirar deportes.

AccessibilityOptions

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

bool

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

bool

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

bool

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

bool

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

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.

ContentBlock

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

string

Nombre del proveedor de datos del lugar.

string

URI al proveedor de datos del lugar.

LocalizedText

La descripción general del lugar.

LocalizedText

Es la descripción detallada del lugar.

References

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

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

SecondaryHoursType

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

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., Navidad. Se establece en current_opening_hours y current_secondary_opening_hours si hay horas excepcionales.

bool

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

Point

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

Point

La hora a la que el lugar comienza a cerrarse.

Date

Fecha en la zona horaria local del lugar

bool

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.

int32

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.

int32

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

int32

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

Date

La fecha de este día especial.

bool

Este lugar ofrece estacionamiento gratuito.

bool

Este lugar ofrece estacionamiento pagado.

bool

Este lugar ofrece estacionamiento gratuito en la calle.

bool

Este lugar ofrece estacionamiento en la calle pagado.

bool

El lugar ofrece servicio de estacionamiento.

bool

Este lugar ofrece estacionamiento en cochera gratuito.

bool

Este lugar ofrece estacionamiento pagado en cochera.

bool

Place acepta tarjetas de crédito como pago.

bool

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

bool

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

bool

Place acepta pagos NFC.

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.

string

El nombre del recurso del subdominio.

string

Es el ID de lugar del subdominio.

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.

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/{place_id}/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.

LocalizedText

Es el texto localizado de la opinión.

LocalizedText

Texto de la opinión en su idioma original

double

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

AuthorAttribution

Autor de esta opinión.

Timestamp

Marca de tiempo de la revisión.

string

Los detalles del lugar se mostrarán en el idioma preferido, si está disponible. Si no se especifica el código de idioma o no se lo reconoce, es posible que se muestren detalles de lugares en cualquier idioma, con preferencia por el inglés, si es que existen.

Lista actual de idiomas admitidos: https://developers.google.com/maps/faq#languagesupport.

string

El código Unicode de país o región (CLDR) de la ubicación de donde proviene la solicitud. Este parámetro se usa para mostrar los detalles del lugar, como el nombre del lugar específico de una región, si está disponible. El parámetro puede afectar los resultados según la ley aplicable.

Para obtener más información, consulta https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Ten en cuenta que actualmente no se admiten los códigos regionales de 3 dígitos.

string

Se debe incluir el tipo de lugar (p. ej., "restaurante" o "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types.

Se pueden especificar hasta 50 tipos de la Tabla A.

Si hay tipos en conflicto, es decir, un tipo aparece tanto en include_types como enexcluded_types, se muestra un error INVALID_ARGUMENT.

Si se especifica un tipo de lugar con varias restricciones de tipo, solo se devuelven los lugares que satisfacen todas las restricciones. Por ejemplo, si tenemos {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, los lugares que se muestran proporcionan servicios relacionados con "restaurantes", pero no operan principalmente como "restaurantes".

string

Se excluyó el tipo de lugar (p. ej., "restaurante" o "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types.

Se pueden especificar hasta 50 tipos de la Tabla A.

Si el cliente proporciona include_types (p.ej., restaurante) y excluidos_types (p.ej., cafetería), la respuesta debe incluir lugares que son restaurantes, pero no cafeterías. La respuesta incluye lugares que coinciden con, al menos, uno de los valores de include_types y ninguno de los excluidos_tipos.

Si hay tipos en conflicto, es decir, un tipo aparece tanto en include_types como enexcluded_types, se muestra un error INVALID_ARGUMENT.

Si se especifica un tipo de lugar con varias restricciones de tipo, solo se devuelven los lugares que satisfacen todas las restricciones. Por ejemplo, si tenemos {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, los lugares que se muestran proporcionan servicios relacionados con "restaurantes", pero no operan principalmente como "restaurantes".

string

Se incluyó el tipo de lugar principal (p.ej., "restaurante" o "gas_station") de https://developers.google.com/maps/documentation/places/web-service/place-types. Un lugar solo puede tener asociado un único tipo principal de la tabla de tipos admitidos.

Se pueden especificar hasta 50 tipos de la Tabla A.

Si hay tipos principales en conflicto, es decir, un tipo aparece tanto en supported_primary_types como enexcluded_primary_types, se muestra un error INVALID_ARGUMENT.

Si se especifica un tipo de lugar con varias restricciones de tipo, solo se devuelven los lugares que satisfacen todas las restricciones. Por ejemplo, si tenemos {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, los lugares que se muestran proporcionan servicios relacionados con "restaurantes", pero no operan principalmente como "restaurantes".

string

Se excluyó el tipo de lugar principal (p.ej., "restaurante" o "estación_de_gaso") de https://developers.google.com/maps/documentation/places/web-service/place-types.

Se pueden especificar hasta 50 tipos de la Tabla A.

Si hay tipos principales en conflicto, es decir, un tipo aparece tanto en supported_primary_types como enexcluded_primary_types, se muestra un error INVALID_ARGUMENT.

Si se especifica un tipo de lugar con varias restricciones de tipo, solo se devuelven los lugares que satisfacen todas las restricciones. Por ejemplo, si tenemos {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, los lugares que se muestran proporcionan servicios relacionados con "restaurantes", pero no operan principalmente como "restaurantes".

int32

Cantidad máxima de resultados que se mostrarán Debe estar entre 1 y 20 (valor predeterminado), inclusive. Si no se establece, se vuelve al límite superior. Si el número se establece como negativo o supera el límite superior, se muestra un error INVALID_ARGUMENT.

LocationRestriction

Obligatorio. La región en la que se buscará.

RankPreference

Cómo se clasificarán los resultados en la respuesta.

Circle

Es un círculo definido por el punto central y el radio.

Place

Es una lista de lugares que cumplen con los requisitos del usuario, como los tipos de lugares, la cantidad de lugares y las restricciones de ubicación específicas.

string

Obligatorio. Es la consulta de texto para la búsqueda de texto.

string

Los detalles del lugar se mostrarán en el idioma preferido, si está disponible. Si no se especifica el código de idioma o no se lo reconoce, es posible que se muestren detalles de lugares en cualquier idioma, con preferencia por el inglés, si es que existen.

Lista actual de idiomas admitidos: https://developers.google.com/maps/faq#languagesupport.

string

El código Unicode de país o región (CLDR) de la ubicación de donde proviene la solicitud. Este parámetro se usa para mostrar los detalles del lugar, como el nombre del lugar específico de una región, si está disponible. El parámetro puede afectar los resultados según la ley aplicable.

Para obtener más información, consulta https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Ten en cuenta que actualmente no se admiten los códigos regionales de 3 dígitos.

RankPreference

Cómo se clasificarán los resultados en la respuesta.

string

El tipo de lugar solicitado. Lista completa de los tipos admitidos: https://developers.google.com/maps/documentation/places/web-service/place-types. Solo se admite un tipo incluido.

bool

Se usa para restringir la búsqueda a los lugares que están abiertos en ese momento. El valor predeterminado es falso.

double

Excluye los resultados cuya calificación promedio de los usuarios sea estrictamente inferior a este límite. Un valor válido debe ser un número de punto flotante entre 0 y 5 (inclusive) con una cadencia de 0.5, es decir, [0, 0.5, 1.0, ... , 5.0] inclusive. La calificación de entrada se redondeará hacia arriba al punto 0.5(techo) más cercano. Por ejemplo, una calificación de 0.6 eliminará todos los resultados con una calificación inferior a 1.0.

int32

Obsoleto: usa page_size en su lugar.

La cantidad máxima de resultados por página que se pueden mostrar. Si la cantidad de resultados disponibles es mayor que max_result_count, se muestra una next_page_token que se puede pasar a page_token para obtener la siguiente página de resultados en solicitudes posteriores. Si se proporciona un valor de 0 o no, se usa un valor predeterminado de 20. El valor máximo es 20; los valores superiores a 20 se convertirán en 20. Los valores negativos mostrarán un error INVALID_ARGUMENT.

Si se especifican max_result_count y page_size, se ignorará max_result_count.

int32

Opcional. La cantidad máxima de resultados por página que se pueden mostrar. Si la cantidad de resultados disponibles es mayor que page_size, se muestra una next_page_token que se puede pasar a page_token para obtener la siguiente página de resultados en solicitudes posteriores. Si se proporciona un valor de 0 o no, se usa un valor predeterminado de 20. El valor máximo es 20; los valores superiores a 20 se establecerán en 20. Los valores negativos mostrarán un error INVALID_ARGUMENT.

Si se especifican max_result_count y page_size, se ignorará max_result_count.

string

Opcional. Un token de página, recibido de una llamada anterior de TextSearch. Proporciona esto para recuperar la página siguiente.

Durante la paginación, todos los parámetros que no sean page_token, page_size ni max_result_count proporcionados a TextSearch deben coincidir con la llamada inicial que proporcionó el token de la página. De lo contrario, se muestra un error INVALID_ARGUMENT.

PriceLevel

Se usa para restringir la búsqueda a los lugares marcados como niveles de precios determinados. Los usuarios pueden elegir cualquier combinación de niveles de precios. Opción predeterminada para seleccionar todos los niveles de precios.

bool

Se usa para establecer un filtro estricto de tipos para include_type. Si la estableces como verdadera, solo se mostrarán resultados del mismo tipo. El valor predeterminado es falso.

LocationBias

La región en la que se buscará. Esta ubicación sirve como un sesgo, lo que significa que es posible que se devuelvan resultados alrededor de una ubicación determinada. No se puede establecer junto con location_restriction.

LocationRestriction

La región en la que se buscará. Esta ubicación funciona como una restricción, lo que significa que no se mostrarán resultados fuera de la ubicación determinada. No se puede establecer junto con location_bias.

EVOptions

Opcional. Establece las opciones de búsqueda de VE para una solicitud de búsqueda de lugares.

double

Opcional. Velocidad de carga mínima requerida en kilovatios. Se filtrará un lugar con una tasa de carga inferior a la especificada.

EVConnectorType

Opcional. La lista de tipos de conectores de VE preferidos. Se filtrarán los lugares que no admitan ninguno de los tipos de conectores de la lista.

Viewport

Es un cuadro rectangular definido por las esquinas noreste y suroeste. rectangle.high() debe ser el punto noreste del viewport del rectángulo. rectangle.low() debe ser el punto suroeste del viewport del rectángulo. rectangle.low().latitude() no puede ser mayor que rectangle.high().latitude(). Esto dará como resultado un rango de latitud vacío. Un viewport rectangular no puede tener más de 180 grados.

Circle

Es un círculo definido por el punto central y el radio.

Viewport

Es un cuadro rectangular definido por las esquinas noreste y suroeste. rectangle.high() debe ser el punto noreste del viewport del rectángulo. rectangle.low() debe ser el punto suroeste del viewport del rectángulo. rectangle.low().latitude() no puede ser mayor que rectangle.high().latitude(). Esto dará como resultado un rango de latitud vacío. Un viewport rectangular no puede tener más de 180 grados.

Place

Es una lista de lugares que cumplen con los criterios de búsqueda de texto del usuario.

ContextualContent

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

Una lista de contenido contextual en la que cada entrada se asocia al lugar correspondiente en el mismo índice en el campo "places". Se prefiere el contenido relevante para el text_query de la solicitud. Si el contenido contextual no está disponible para uno de los lugares, mostrará contenido no contextual. Estará vacío solo cuando el contenido no esté disponible para este lugar. Esta lista debe tener tantas entradas como la lista de lugares, si se solicita.

string

Un token que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo o se deja vacío, no habrá páginas posteriores.