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.
Constructor | |
---|---|
Place |
Place(options) Parámetros:
|
Métodos estáticos | |
---|---|
|
findPlaceFromPhoneNumber(request) Parámetros:
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. |
|
findPlaceFromQuery(request) Parámetros:
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. |
|
searchByText(request) Parámetros:
Búsqueda de lugares basada en búsquedas de texto. |
Propiedades | |
---|---|
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. |
|
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 |
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
|
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 |
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. |
Métodos | |
---|---|
|
fetchFields(options) Parámetros:
|
|
getNextOpeningTime([date]) Parámetros:
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. |
|
isOpen([date]) Parámetros:
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.
Propiedades | |
---|---|
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.
Propiedades | |
---|---|
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.
Propiedades | |
---|---|
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
Propiedades | |
---|---|
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.
Propiedades | |
---|---|
periods |
Tipo:
Array<OpeningHoursPeriod> 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.
Propiedades | |
---|---|
close |
Tipo:
OpeningHoursPoint optional La hora de cierre del lugar. |
open |
Tipo:
OpeningHoursPoint 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.
Propiedades | |
---|---|
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.
Propiedades | |
---|---|
authorAttributions |
Tipo:
Array<AuthorAttribution> 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. |
Métodos | |
---|---|
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.
Propiedades | |
---|---|
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.
Propiedades | |
---|---|
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.
Propiedades | |
---|---|
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.
Constantes | |
---|---|
EXPENSIVE |
|
FREE |
|
INEXPENSIVE |
|
MODERATE |
|
VERY_EXPENSIVE |
SearchByTextRequest
Interfaz google.maps.places.SearchByTextRequest
Interfaz de solicitud para
.Place.searchByText
Propiedades | |
---|---|
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 |
Tipo:
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|CircleLiteral|Circle 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 |
Tipo:
LatLngBounds|LatLngBoundsLiteral 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. |
|
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.
Constantes | |
---|---|
DISTANCE |
Clasifica los resultados por distancia. |
RELEVANCE |
Clasifica los resultados por relevancia. |