Place

Clase Place

Clase google.maps.places.Place

Para acceder, llama a const {Place} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

Place
Place(options)
Parámetros: 
searchByText
searchByText(request)
Parámetros: 
Valor que se devuelve:  Promise<{places:Array<Place>}>
Búsqueda de lugares basada en búsquedas de texto.
accessibilityOptions
Tipo:  AccessibilityOptions optional
Opciones de accesibilidad de este lugar. Es undefined si no se llamó a los datos de opciones de accesibilidad desde el servidor.
addressComponents
Tipo:  Array<AddressComponent> optional
Es el conjunto de componentes de dirección para la ubicación de este lugar. El objeto estará vacío si no hay datos de dirección conocidos. Es undefined si no se llamó a los datos de la dirección desde el servidor.
adrFormatAddress
Tipo:  string optional
Es la representación de la dirección del lugar en microformato adr.
attributions
Tipo:  Array<Attribution> optional
Texto de atribución que debe mostrarse para este resultado de lugar.
businessStatus
Tipo:  BusinessStatus optional
El estado operativo de la ubicación. null si no hay un estado conocido. Es undefined si los datos de estado no se cargaron desde el servidor.
displayName
Tipo:  string optional
El nombre visible de la ubicación null si no hay nombre. Es undefined si los datos del nombre no se cargaron desde el servidor.
editorialSummary
Tipo:  string optional
El resumen editorial de este lugar. null si no hay un resumen editorial. undefined si aún no se solicitó este campo.
editorialSummaryLanguageCode
Tipo:  string optional
El idioma del resumen editorial de este lugar. null si no hay un resumen editorial. undefined si aún no se solicitó este campo.
formattedAddress
Tipo:  string optional
La dirección completa de las ubicaciones
googleMapsURI
Tipo:  string optional
URL de la página oficial de Google del sitio. Es la página de Google que contiene la mejor información disponible acerca del lugar.
hasCurbsidePickup
Tipo:  boolean optional
Si un lugar ofrece retiros en la puerta. Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
hasDelivery
Tipo:  boolean optional
Si un lugar ofrece entregas. Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
hasDineIn
Tipo:  boolean optional
Si un lugar ofrece opciones de consumo en un lugar. Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
hasTakeout
Tipo:  boolean optional
Indica si un lugar ofrece opciones de comida para llevar. Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
iconBackgroundColor
Tipo:  string optional
Es el código de color hexadecimal predeterminado para la categoría del lugar.
id
Tipo:  string
Es el ID de lugar único.
internationalPhoneNumber
Tipo:  string optional
Es el número de teléfono del lugar en formato internacional. El formato internacional incluye el código de país y está precedido por un signo más (+).
isReservable
Tipo:  boolean optional
Si un lugar se puede reservar Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
location
Tipo:  LatLng optional
La posición del lugar.
nationalPhoneNumber
Tipo:  string optional
Indica el número de teléfono del lugar, con el formato indicado en la convención regional del número.
photos
Tipo:  Array<Photo> optional
Fotos de este lugar. La colección contendrá hasta diez objetos Photo.
plusCode
Tipo:  PlusCode optional
priceLevel
Tipo:  PriceLevel optional
El nivel de precio del lugar. Esta propiedad puede mostrar cualquiera de los siguientes valores
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
Tipo:  number optional
Una calificación entre 1.0 y 5.0, basada en las opiniones de los usuarios sobre este lugar.
regularOpeningHours
Tipo:  OpeningHours optional
requestedLanguage
Tipo:  string optional
Es el idioma solicitado para este lugar.
requestedRegion
Tipo:  string optional
Es la región solicitada para este lugar.
reviews
Tipo:  Array<Review> optional
Una lista de opiniones sobre este lugar.
servesBeer
Tipo:  boolean optional
Si un lugar sirve cerveza. Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
servesBreakfast
Tipo:  boolean optional
Si un lugar sirve desayunos Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
servesBrunch
Tipo:  boolean optional
Si un lugar sirve brunch Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
servesDinner
Tipo:  boolean optional
Si un lugar sirve cenas Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
servesLunch
Tipo:  boolean optional
Si un lugar sirve almuerzos Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
servesVegetarianFood
Tipo:  boolean optional
Si un lugar sirve comida vegetariana Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
servesWine
Tipo:  boolean optional
Si un lugar sirve vino. Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido. Muestra "indefinido" si aún no se solicitó este campo.
svgIconMaskURI
Tipo:  string optional
Es el URI del recurso de máscara de imagen SVG que se puede usar para representar la categoría de un lugar.
types
Tipo:  Array<string> optional
Un array de tipos para este lugar (por ejemplo, ["political", "locality"] o ["restaurant", "establishment"]).
userRatingCount
Tipo:  number optional
La cantidad de calificaciones de los usuarios que contribuyeron a la Place.rating de este lugar.
utcOffsetMinutes
Tipo:  number optional
La compensación desde UTC de la zona horaria actual del lugar, en minutos. Por ejemplo, la hora estándar del este de Austria (GMT+10) en el horario de verano está 11 horas por delante del UTC, por lo que el utc_offset_minutes será 660. Para las zonas horarias retrasadas con respecto a UTC, la compensación es negativa. Por ejemplo, utc_offset_minutes es -60 para Cabo Verde.
viewport
Tipo:  LatLngBounds optional
El viewport preferido cuando se muestra este lugar en un mapa.
websiteURI
Tipo:  string optional
El sitio web autorizado para este lugar, como la página principal de una empresa.
openingHours
Tipo:  OpeningHours optional
fetchFields
fetchFields(options)
Parámetros: 
Valor que se devuelve:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Parámetros: 
  • dateDate optional
Valor que se devuelve:  Promise<Date optional>
Calcula la fecha que representa el siguiente OpeningHoursTime. El resultado es indefinido si los datos no son suficientes para calcular el resultado o si este sitio no está operativo.
BetaisOpen
isOpen([date])
Parámetros: 
  • dateDate optional La configuración predeterminada es ahora.
Valor que se devuelve:  Promise<boolean optional>
Verifica si el lugar está abierto en la fecha y hora indicadas. Se resuelve con undefined si los datos conocidos de la ubicación no son suficientes para calcularlo (p.ej., si no están registrados los horarios de atención).
toJSON
toJSON()
Parámetros: Ninguno
Valor que se muestra:  Object: Un objeto JSON con todas las propiedades de lugar solicitadas.

PlaceOptions

Interfaz de google.maps.places.PlaceOptions

Opciones para construir un lugar.

id
Tipo:  string
Es el ID de lugar único.
requestedLanguage optional
Tipo:  string optional
Es el identificador del idioma en el que se deben mostrar detalles. Consulta la lista de idiomas compatibles.
requestedRegion optional
Tipo:  string optional
Es el código regional de la región del usuario. Esto puede afectar las fotos que se pueden devolver y posiblemente otros factores. El código de región acepta un valor de ccTLD ("dominio de nivel superior") de dos caracteres. La mayoría de los códigos ccTLD son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD del Reino Unido es "uk" (.co.uk), mientras que su código ISO 3166-1 es "gb" (técnicamente para la entidad del "Reino Unido de Gran Bretaña e Irlanda del Norte").

Clase AccessibilityOptions

Clase google.maps.places.AccessibilityOptions

Para acceder, llama a const {AccessibilityOptions} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

hasWheelchairAccessibleEntrance
Tipo:  boolean optional
Si un lugar tiene entrada accesible para personas en silla de ruedas Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido.
hasWheelchairAccessibleParking
Tipo:  boolean optional
Si un lugar tiene estacionamiento accesible para personas en silla de ruedas Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido.
hasWheelchairAccessibleRestroom
Tipo:  boolean optional
Si un lugar tiene sanitarios accesibles para personas en silla de ruedas Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido.
hasWheelchairAccessibleSeating
Tipo:  boolean optional
Si un lugar ofrece asientos accesibles para personas en silla de ruedas. Muestra "true" o "false" si se conoce el valor. Muestra "nulo" si el valor es desconocido.

Clase AddressComponent

Clase google.maps.places.AddressComponent

Para acceder, llama a const {AddressComponent} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

longText
Tipo:  string optional
Es el texto completo del componente de la dirección.
shortText
Tipo:  string optional
Es el texto abreviado y breve del componente de dirección proporcionado.
types
Tipo:  Array<string>
Array de cadenas que denotan el tipo de este componente de la dirección. Puedes encontrar una lista de los tipos válidos aquí.

Clase Attribution

Clase google.maps.places.Attribution

Para acceder, llama a const {Attribution} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

provider
Tipo:  string optional
Texto de atribución que debe mostrarse para este resultado de lugar.
providerURI
Tipo:  string optional

FetchFieldsRequest

Interfaz de google.maps.places.FetchFieldsRequest

Opciones para recuperar los campos de lugar.

fields
Tipo:  Array<string>
Lista de campos que se recuperarán.

Clase OpeningHours

Clase google.maps.places.OpeningHours

Para acceder, llama a const {OpeningHours} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

periods
Períodos de apertura que cubren cada día de la semana, a partir del domingo, en orden cronológico. No incluye los días en los que el lugar no está abierto.
weekdayDescriptions
Tipo:  Array<string>
Es un array de siete cadenas que representan los horarios de atención con formato para cada día de la semana. El Servicio Places dará formato al horario de atención y lo localizará de forma adecuada para el idioma actual. El orden de los elementos en este array depende del lenguaje. En algunos idiomas, la semana comienza el lunes y, en otros, el domingo.

Clase OpeningHoursPeriod

Clase google.maps.places.OpeningHoursPeriod

Para acceder, llama a const {OpeningHoursPeriod} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

close
Tipo:  OpeningHoursPoint optional
La hora de cierre del lugar.
open
La hora de apertura del lugar.

Clase OpeningHoursPoint

Clase google.maps.places.OpeningHoursPoint

Para acceder, llama a const {OpeningHoursPoint} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

day
Tipo:  number
Es el día de la semana, como un número dentro del rango [0, 6], a partir del domingo. Por ejemplo, "2" significa "martes".
hour
Tipo:  number
La hora de OpeningHoursPoint.time como un número, en el rango [0, 23]. Esto se informará en la zona horaria del lugar.
minute
Tipo:  number
El minuto de OpeningHoursPoint.time como número, en el rango [0, 59]. Esto se informará en la zona horaria del lugar.

Clase Photo

Clase google.maps.places.Photo

Para acceder, llama a const {Photo} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

authorAttributions
Texto de atribución que debe mostrarse para esta foto.
heightPx
Tipo:  number
La altura de la foto en píxeles.
widthPx
Tipo:  number
Es el ancho de la foto en píxeles.
getURI
getURI([options])
Parámetros: 
Valor que se devuelve:  string
Muestra la URL de la imagen que corresponde a las opciones especificadas.

Clase AuthorAttribution

Clase google.maps.places.AuthorAttribution

Para acceder, llama a const {AuthorAttribution} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

displayName
Tipo:  string
Es el nombre del autor de este resultado.
photoURI
Tipo:  string optional
URI de la foto del autor para este resultado. Es posible que esta opción no siempre esté disponible.
uri
Tipo:  string optional
URI del perfil del autor para este resultado.

Clase PlusCode

Clase google.maps.places.PlusCode

Para acceder, llama a const {PlusCode} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

compoundCode
Tipo:  string optional
Un código plus con un número 1/8,000 de grado por 1/8,000 de un área de grados en el que los primeros cuatro caracteres (el código de área) se eliminan y se reemplazan por una descripción de localidad. Por ejemplo, “9G8F+5W Zúrich, Suiza”.
globalCode
Tipo:  string optional
Un código plus con un valor de 1/8,000 de un grado por 1/8,000 de un área de grado Por ejemplo, “8FVC9G8F+5W”.

Clase Review

Clase google.maps.places.Review

Para acceder, llama a const {Review} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

authorAttribution
Tipo:  AuthorAttribution optional
El revisor.
publishTime
Tipo:  Date optional
rating
Tipo:  number optional
Es la calificación de esta opinión, en un número entre 1.0 y 5.0 (inclusive).
relativePublishTimeDescription
Tipo:  string optional
Es una cadena de tiempo reciente con formato que expresa el tiempo de revisión en relación con la hora actual en un formato adecuado para el idioma y el país. Por ejemplo: "hace un mes".
text
Tipo:  string optional
Es el texto de una opinión.
textLanguageCode
Tipo:  string optional
Es un código de idioma IETF que indica el idioma en el que está escrita esta opinión. Ten en cuenta que este código incluye solo la etiqueta de idioma principal, sin ninguna etiqueta secundaria que indique el país o la región. Por ejemplo, todas las opiniones en inglés están etiquetadas como 'en' en lugar de "en-AU" o "en-UK".

Constantes PriceLevel

Constantes google.maps.places.PriceLevel

Enumeración de nivel de precio para objetos Place.

Para acceder, llama a const {PriceLevel} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

SearchByTextRequest

Interfaz de google.maps.places.SearchByTextRequest

Interfaz de solicitud para Place.searchByText.

fields
Tipo:  Array<string>
Campos que se incluirán en la respuesta y que se facturarán. Si se pasa ['*'], se mostrarán y se facturarán todos los campos disponibles (esto no se recomienda para las implementaciones de producción). Para obtener una lista de campos, consulta PlaceResult. Los campos anidados se pueden especificar con rutas de puntos (por ejemplo, "geometry.location").
includedType optional
Tipo:  string optional
Es 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. Consulta SearchByTextRequest.useStrictTypeFiltering
isOpenNow optional
Tipo:  boolean optional
Valor predeterminado: false
Se usa para restringir la búsqueda a los lugares que están abiertos en ese momento.
language optional
Tipo:  string optional
Los detalles del lugar se mostrarán en el idioma preferido si están disponibles. Se establecerá de forma predeterminada la preferencia de idioma del navegador. Lista actual de idiomas admitidos: https://developers.google.com/maps/faq#languagesupport.
locationBias optional
La región en la que se buscará. Esta ubicación sirve como sesgo, lo que significa que podrían devolverse resultados en torno a una ubicación determinada. No se puede establecer junto con locationRestriction.
locationRestriction optional
La región en la que se buscará. Esta ubicación sirve 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 locationBias.
maxResultCount optional
Tipo:  number optional
Cantidad máxima de resultados que se mostrarán Debe ser un valor entre 1 y 20, inclusive.
minRating optional
Tipo:  number optional
Filtra 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á al valor máximo de 0.5(límite) más cercano. Por ejemplo, una calificación de 0.6 eliminará todos los resultados con una calificación inferior a 1.0.
priceLevels optional
Tipo:  Array<PriceLevel> optional
Se usa para restringir la búsqueda a lugares marcados con determinados niveles de precios. Se puede elegir cualquier combinación de niveles de precios. La configuración predeterminada es todos los niveles de precios.
query optional
Tipo:  string optional
BetarankBy optional
rankPreference optional
Valor predeterminado: SearchByTextRankPreference.DISTANCE
Cómo se clasificarán los resultados en la respuesta.
region optional
Tipo:  string optional
Es el código Unicode de país o región (CLDR) de la ubicación de la que 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.
textQuery optional
Tipo:  string optional
Obligatorio. Es la consulta de texto para la búsqueda textual.
useStrictTypeFiltering optional
Tipo:  boolean optional
Valor predeterminado: false
Se usa para establecer un filtro de tipo estricto para SearchByTextRequest.includedType. Si se configura como true, solo se mostrarán resultados del mismo tipo.

Constantes SearchByTextRankPreference

Constantes google.maps.places.SearchByTextRankPreference

Enum RankPreference para SearchByTextRequest

Para acceder, llama a const {SearchByTextRankPreference} = await google.maps.importLibrary("places"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

DISTANCE Clasifica los resultados por distancia.
RELEVANCE Clasifica los resultados por relevancia.