Place (beta)

Place

Clase google.maps.places.Place

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

Place
Place(options)
Parámetros: 
BetafindPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
Parámetros: 
Valor que se muestra:  Promise<{places:Array<Place>}>
Busca un lugar en función del número de teléfono especificado. Muestra un array debido a casos excepcionales en los que varios lugares podrían compartir un número de teléfono.
BetafindPlaceFromQuery
findPlaceFromQuery(request)
Parámetros: 
Valor que se muestra:  Promise<{places:Array<Place>}>
Busca un lugar en función de la búsqueda de texto especificada. Muestra un array debido a casos en los que la consulta es ligeramente ambigua y se muestra más de un lugar. Este método no está diseñado para búsquedas en las que se esperan varios resultados.
BetasearchByText
searchByText(request)
Parámetros: 
Valor que se muestra:  Promise<{places:Array<Place>}>
Búsqueda de lugares basada en búsquedas de texto.
addressComponents
Tipo:  Array<AddressComponent> optional
El conjunto de componentes de dirección para la ubicación de este lugar. El objeto está vacío si no hay datos de dirección conocidos. undefined si no se llamaron los datos de la dirección desde el servidor.
adrFormatAddress
Tipo:  string optional
Es la representación de la dirección del lugar en adr microformat.
attributions
Tipo:  Array<Attribution> optional
Es el 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. undefined si los datos de estado no se cargaron desde el servidor
displayName
Tipo:  string optional
El nombre visible de la ubicación. Es null si no hay nombre. undefined si los datos del nombre no se cargaron desde el servidor
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. Esta es la página de Google que contiene la mejor información disponible acerca del lugar.
hasCurbsidePickup
Tipo:  boolean optional
Indica si un lugar ofrece retiros en la puerta. Muestra "true" o "false" si se conoce el valor. Muestra "null" si el valor es desconocido. Muestra 'indefinido' si aún no se solicitó este campo.
hasDelivery
Tipo:  boolean optional
Indica si un lugar ofrece servicio de entrega. Muestra "true" o "false" si se conoce el valor. Muestra "null" si el valor es desconocido. Muestra 'indefinido' si aún no se solicitó este campo.
hasDineIn
Tipo:  boolean optional
Indica si un lugar ofrece comidas en el lugar. Muestra "true" o "false" si se conoce el valor. Muestra "null" si el valor es desconocido. Muestra 'indefinido' si aún no se solicitó este campo.
hasTakeout
Tipo:  boolean optional
Indica si un lugar ofrece comida para llevar. Muestra "true" o "false" si se conoce el valor. Muestra "null" si el valor es desconocido. Muestra 'indefinido' si aún no se solicitó este campo.
BetahasWheelchairAccessibleEntrance
Tipo:  boolean optional
Indica si un lugar tiene una entrada con acceso para sillas de ruedas. Muestra "true" o "false" si se conoce el valor. Muestra "null" 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 de Place 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
Indica si un lugar es reservable. Muestra "true" o "false" si se conoce el valor. Muestra "null" 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 de Place, con un formato conforme a la convención regional del número.
openingHours
Tipo:  OpeningHours optional
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 precios 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.
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 de este lugar
servesBeer
Tipo:  boolean optional
Si un lugar sirve cerveza Muestra "true" o "false" si se conoce el valor. Muestra "null" si el valor es desconocido. Muestra 'indefinido' si aún no se solicitó este campo.
servesBreakfast
Tipo:  boolean optional
Si un lugar sirve desayuno Muestra "true" o "false" si se conoce el valor. Muestra "null" si el valor es desconocido. Muestra 'indefinido' si aún no se solicitó este campo.
servesBrunch
Tipo:  boolean optional
Si un lugar sirve desayuno-almuerzo Muestra "true" o "false" si se conoce el valor. Muestra "null" 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 "null" 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 "null" 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 "null" 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 "null" 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 de este lugar (por ejemplo, ["political", "locality"] o ["restaurant", "establishment"]).
userRatingCount
Tipo:  number optional
Es la cantidad de calificaciones de los usuarios que contribuyeron a la Place.rating de este lugar.
utcOffsetMinutes
Tipo:  number optional
La diferencia respecto de 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 más adelantada que la UTC, por lo que el utc_offset_minutes estará 660. Para las zonas horarias detrás de UTC, la compensación es negativa. Por ejemplo, utc_offset_minutes es -60 para Cabo Verde.
viewport
Tipo:  LatLngBounds optional
El viewport preferido al mostrar este lugar en un mapa.
websiteURI
Tipo:  string optional
El sitio web autorizado de este lugar, como la página principal de una empresa.
BetafetchFields
fetchFields(options)
Parámetros: 
Valor que se muestra:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Parámetros: 
  • dateDate optional
Valor que se muestra:  Promise<Date optional>
Calcula la fecha que representa el próximo OpeningHoursTime. El resultado es "indefinido" si los datos no son suficientes para calcular el resultado o si este sitio no es operativo.
BetaisOpen
isOpen([date])
Parámetros: 
  • date:  La configuración predeterminada de Date optional es ahora.
Valor que se muestra:  Promise<boolean optional>
Comprueba 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 se registran los horarios de atención.
toJSON
toJSON()
Parámetros: Ninguno
Valor que se muestra:  Object Es un objeto JSON con todas las propiedades de Place solicitadas.

PlaceOptions

Interfaz google.maps.places.PlaceOptions

Opciones para construir un lugar.

id
Tipo:  string
Es el ID de lugar único.
requestedLanguage optional
Tipo:  string optional
Un identificador de idioma para el idioma en el que se deben mostrar los 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 mostrar y, posiblemente, otras cosas. El código de región acepta un valor 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 de "Reino Unido de Gran Bretaña e Irlanda del Norte").

AddressComponent

Clase google.maps.places.AddressComponent

Para acceder, llama a const {AddressComponent} = await google.maps.importLibrary("places"). Consulta 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>
Es un array de cadenas que denota el tipo de este componente de dirección. Puede 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 Bibliotecas de la API de Maps JavaScript.

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

FetchFieldsRequest.

Interfaz google.maps.places.FetchFieldsRequest

Opciones para recuperar campos de lugar

fields
Tipo:  Array<string>
Lista de los campos que se recuperarán.
sessionToken optional
Tipo:  AutocompleteSessionToken optional
Referencia única que se usa para empaquetar la solicitud de detalles con una sesión de autocompletado.

OpeningHours.

Clase google.maps.places.OpeningHours

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

periods
Períodos de apertura que abarcan todos los días 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 strings 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 esta matriz 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 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 Bibliotecas de la API de Maps JavaScript.

day
Tipo:  number
El día de la semana, como un número en el rango [0, 6], a partir del domingo. Por ejemplo, "2" significa "martes".
hour
Tipo:  number
La hora del 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 del OpeningHoursPoint.time como un 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 Bibliotecas de la API de Maps JavaScript.

authorAttributions
Es el texto de atribución que debe mostrarse para esta foto.
heightPx
Tipo:  number
Es 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 muestra:  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 Bibliotecas de la API de Maps JavaScript.

displayName
Tipo:  string
Es el nombre del autor para 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 Bibliotecas de la API de Maps JavaScript.

compoundCode
Tipo:  string optional
Un código Plus con un grado 1/8000 por 1/8000 del área de grado 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 una 1/8,000 de 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 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, un número entre 1.0 y 5.0 (inclusive).
relativePublishTimeDescription
Tipo:  string optional
Es una string de hora 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 se escribió esta opinión. Ten en cuenta que este código incluye solo la etiqueta del 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

Es una enumeración de nivel de precios para objetos Place.

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

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

SearchByTextRequest

Interfaz google.maps.places.SearchByTextRequest

Interfaz de solicitud para BetaPlace.searchByText.

fields
Tipo:  Array<string>
Campos que se incluirán en la respuesta por los que se facturará. Si se pasa ['ALL'], se mostrarán y facturarán todos los campos disponibles (esto no se recomienda para implementaciones de producción). Para obtener una lista de campos, consulta PlaceResult. Los campos anidados se pueden especificar con rutas de acceso 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 con el idioma preferido si está disponible. Se establecerá de forma predeterminada en 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 realizará la búsqueda. Esta ubicación sirve como sesgo, lo que significa que se podrían mostrar resultados en torno a una ubicación determinada. No se puede configurar junto con locationRestriction.
locationRestriction optional
La región en la que se realizará la búsqueda. Esta ubicación funciona como una restricción, lo que significa que no se mostrarán resultados fuera de la ubicación dada. No se puede establecer junto con locationBias.
maxResultCount optional
Tipo:  number optional
Cantidad máxima de resultados que se mostrarán Debe estar comprendido 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á a la unidad de 0.5(límite) más cercana. 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 precio. 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
rankBy optional
Tipo:  SearchByTextRankBy optional
Valor predeterminado: SearchByTextRankBy.DISTANCE
Cómo se clasificarán los resultados en la respuesta.
region optional
Tipo:  string optional
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.
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 establece como verdadera, solo se mostrarán resultados del mismo tipo.

Constantes SearchByTextRankBy

Constantes google.maps.places.SearchByTextRankBy

Es una enumeración rango por búsqueda para SearchByTextRequest.

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

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