Places Widgets

Clase PlaceAutocompleteElement

Clase google.maps.places.PlaceAutocompleteElement

PlaceAutocompleteElement es una subclase de HTMLElement que proporciona un componente de IU para la API de Places Autocomplete.

PlaceAutocompleteElement usa automáticamente AutocompleteSessionTokens de forma interna para agrupar las fases de consulta y selección de la búsqueda con autocompletado de un usuario.

La primera llamada a Place.fetchFields en un Place que muestra PlacePrediction.toPlace incluirá automáticamente el token de sesión que se usó para recuperar el PlacePrediction.

Consulta https://developers.google.com/maps/documentation/places/web-service/place-session-tokens para obtener más detalles sobre cómo funcionan las sesiones.

Elemento personalizado:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-place-autocomplete>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceAutocompleteElementOptions.

Llama al const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parámetros: 
includedPrimaryTypes
Tipo:  Array<string> optional
Es el Tipo de lugar principal incluido (por ejemplo, "restaurant" o "gas_station").

Solo se devuelve un lugar si su tipo principal se incluye en esta lista. Se pueden especificar hasta 5 valores. Si no se especifican tipos, se devuelven todos los tipos de Place.
Atributo HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
Tipo:  Array<string> optional
Solo se incluyen los resultados de las regiones especificadas, que se indican con hasta 15 códigos de región CLDR de dos caracteres. Un conjunto vacío no restringirá los resultados. Si se configuran locationRestriction y includedRegionCodes, los resultados se ubicarán en el área de intersección.
Atributo HTML:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
Tipo:  LocationBias optional
Es un límite o una sugerencia flexible que se usa cuando se buscan lugares.
locationRestriction
Tipo:  LocationRestriction optional
Son los límites para restringir los resultados de la búsqueda.
name
Tipo:  string optional
Nombre que se usará para el elemento de entrada. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name para obtener más detalles. Sigue el mismo comportamiento que el atributo name para las entradas. Ten en cuenta que este es el nombre que se usará cuando se envíe un formulario. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form para obtener más detalles.
Atributo HTML:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
Es el origen desde el que se calcula la distancia. Si no se especifica, no se calcula la distancia. Si se proporciona la altitud, no se usa en el cálculo.
Atributo HTML:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
Tipo:  string optional
Es un identificador de idioma para el idioma en el que se deben devolver los resultados, si es posible. Es posible que los resultados en el idioma seleccionado tengan una clasificación más alta, pero las sugerencias no se limitan a este idioma. Consulta la lista de idiomas compatibles.
Atributo HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Tipo:  string optional
Es un código de región que se usa para el formato y el filtrado de los resultados. No restringe las sugerencias a este país. 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 de "El Reino Unido de Gran Bretaña e Irlanda del Norte").
Atributo HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem
Tipo:  UnitSystem optional
Es el sistema de unidades que se usa para mostrar las distancias. Si no se especifica, el sistema de unidades se determina según el valor de requestedRegion.
Atributo HTML:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
prediction-item
Es un elemento del menú desplegable de predicciones que representa una sola predicción.
prediction-item-icon
Icono que aparece a la izquierda de cada elemento de la lista de predicciones.
prediction-item-main-text
Es una parte del elemento de predicción que es el texto principal de la predicción. En el caso de las ubicaciones geográficas, contiene un nombre de lugar, como "Sídney", o un nombre y un número de una calle, como "10 King Street". De forma predeterminada, el texto principal del elemento de predicción es de color negro. Si hay texto adicional en prediction-item, este queda fuera de prediction-item-main-text y hereda su diseño de prediction-item. Su color predeterminado es el gris. El texto adicional normalmente es una dirección.
prediction-item-match
La parte de la predicción mostrada que coincide con la entrada del usuario. De manera predeterminada, este texto coincidente se resalta en negrita. Ten en cuenta que el texto coincidente puede estar en cualquier parte de prediction-item. No necesariamente forma parte de prediction-item-main-text.
prediction-item-selected
La figura que aparece cuando el usuario navega a un elemento a través del teclado. Nota: Los elementos seleccionados se verán afectados por los estilos de esta parte y por los estilos de la parte del elemento de predicción.
prediction-list
Elemento visual que contiene la lista de predicciones devueltas por el servicio de autocompletado de sitios. Esta lista aparece como una lista desplegable debajo del PlaceAutocompleteElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.
gmp-error
function(errorEvent)
Argumentos: 
Este evento se activa cuando se rechaza una solicitud al backend (p.ej., clave de API incorrecta). Este evento no se propaga.
gmp-select
function(placePredictionSelectEvent)
Argumentos: 
Este evento se activa cuando un usuario selecciona una predicción de lugar. Contiene un objeto PlacePrediction que se puede convertir en un objeto Place.

Interfaz PlaceAutocompleteElementOptions

Interfaz de google.maps.places.PlaceAutocompleteElementOptions

Opciones para construir un PlaceAutocompleteElement. Para obtener la descripción de cada propiedad, consulta la propiedad con el mismo nombre en la clase PlaceAutocompleteElement.

locationBias optional
Tipo:  LocationBias optional
locationRestriction optional
Tipo:  LocationRestriction optional
name optional
Tipo:  string optional
requestedLanguage optional
Tipo:  string optional

Clase PlacePredictionSelectEvent

Clase google.maps.places.PlacePredictionSelectEvent

Este evento se crea después de que el usuario selecciona un elemento de predicción con PlaceAutocompleteElement. Accede a la selección con event.placePrediction.

Llama a PlacePrediction.toPlace para convertir placePrediction en un Place.

Esta clase extiende Event.

Llama al const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

placePrediction
Para convertirlo en un Place, llama a PlacePrediction.toPlace.

Clase PlaceAutocompleteRequestErrorEvent

Clase google.maps.places.PlaceAutocompleteRequestErrorEvent

El evento se emite desde PlaceAutocompleteElement cuando hay un problema con la solicitud de red.

Esta clase extiende Event.

Llama al const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

Clase PlaceContextualElement

Clase google.maps.places.PlaceContextualElement

Es un widget que usa el token de contexto para mostrar una vista contextual de la respuesta de Grounding con Google Maps.

Elemento personalizado:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceContextualElementOptions.

Llama al const {PlaceContextualElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

contextToken
Tipo:  string optional
Es el token de contexto.
Atributo HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceContextualElementOptions

Interfaz de google.maps.places.PlaceContextualElementOptions

Opciones para PlaceContextualElement.

contextToken optional
Tipo:  string optional
Es el token de contexto que proporciona la respuesta de Fundamentación con Google Maps.

Clase PlaceContextualListConfigElement

Clase google.maps.places.PlaceContextualListConfigElement

Es un elemento HTML que configura opciones para la vista de lista del elemento contextual de lugar.

Elemento personalizado:
<gmp-place-contextual-list-config layout="compact" map-hidden></gmp-place-contextual-list-config>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceContextualListConfigElementOptions.

Llama al const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

layout
Tipo:  PlaceContextualListLayout optional
Es el diseño.
Atributo HTML:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
Tipo:  boolean optional
Indica si el mapa está oculto.
Atributo HTML:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz PlaceContextualListConfigElementOptions

Interfaz de google.maps.places.PlaceContextualListConfigElementOptions

Son las opciones de PlaceContextualListConfigElement.

layout optional
Tipo:  PlaceContextualListLayout optional
Es el diseño. El valor predeterminado es PlaceContextualListLayout.VERTICAL.
mapHidden optional
Tipo:  boolean optional
Indica si el mapa está oculto. El valor predeterminado es mostrar el mapa (valor falso).

Constantes de PlaceContextualListLayout

Constantes de google.maps.places.PlaceContextualListLayout

Es la lista de diseños que admite el elemento contextual de lugar para la vista de lista.

Llama al const {PlaceContextualListLayout} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

COMPACT Diseño de lista compacto: Los elementos de la lista se renderizan como vínculos en una sola línea, con desbordamientos en una lista desplegable.
VERTICAL Diseño de lista vertical: Los elementos de la lista se renderizan como tarjetas en una lista vertical.

Clase PlaceDetailsElement

Clase google.maps.places.PlaceDetailsElement

Es un elemento HTML que muestra detalles de un lugar. Usa los métodos configureFromPlace() o configureFromLocation() para especificar el contenido que se renderizará. Para usar el elemento Place Details, habilita la API de Places UI Kit para tu proyecto en la consola de Google Cloud.

Elemento personalizado:
<gmp-place-details size="small"></gmp-place-details>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceDetailsElementOptions.

Llama al const {PlaceDetailsElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceDetailsElement
PlaceDetailsElement([options])
Parámetros: 
place
Tipo:  Place optional
Solo lectura. Objeto Place que contiene el ID, la ubicación y la ventana gráfica del lugar renderizado actualmente.
size
Tipo:  PlaceDetailsSize optional
Es la variante de tamaño del PlaceDetailsElement. De forma predeterminada, el elemento mostrará PlaceDetailsSize.X_LARGE.
Atributo HTML:
  • <gmp-place-details size="small"></gmp-place-details>
  • <gmp-place-details size="medium"></gmp-place-details>
  • <gmp-place-details size="large"></gmp-place-details>
  • <gmp-place-details size="x-large"></gmp-place-details>
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
configureFromLocation
configureFromLocation(location)
Parámetros: 
  • locationLatLng|LatLngLiteral Es la ubicación para la que se renderizarán los detalles del lugar.
Valor de devolución:  Promise<void> Es una promesa que se resuelve una vez que se cargan y renderizan los datos del lugar.
Configura el widget desde un LatLng con la geocodificación inversa.
configureFromPlace
configureFromPlace(place)
Parámetros: 
  • placePlace|{id:string} Es el lugar para renderizar los detalles.
Valor de devolución:  Promise<void> Es una promesa que se resuelve una vez que se cargan y renderizan los datos del lugar.
Configura el widget a partir de un objeto Place o un ID de lugar.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.
gmp-load
function(event)
Argumentos: 
Este evento se activa cuando el elemento carga y renderiza su contenido. Este evento no se propaga.
gmp-requesterror
function(event)
Argumentos: 
Este evento se activa cuando se rechaza una solicitud al backend (p.ej., clave de API incorrecta). Este evento no se propaga.

Interfaz PlaceDetailsElementOptions

Interfaz de google.maps.places.PlaceDetailsElementOptions

Opciones para PlaceDetailsElement.

size optional
Tipo:  PlaceDetailsSize optional

Constantes de PlaceDetailsSize

Constantes de google.maps.places.PlaceDetailsSize

Son las variantes de tamaño para PlaceDetailsElement.

Llama al const {PlaceDetailsSize} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

LARGE Variante grande que incluye una imagen grande, información básica y de contacto.
MEDIUM Variante mediana que incluye una imagen grande y la información básica.
SMALL Es una variante pequeña que incluye una imagen pequeña y la información básica.
X_LARGE Variante extra grande que incluye un collage de fotos, opiniones e información completa del lugar.

Clase PlaceDetailsCompactElement

Clase google.maps.places.PlaceDetailsCompactElement

Muestra los detalles de un lugar en un diseño compacto. Agrega un PlaceDetailsPlaceRequestElement para especificar el lugar que se renderizará. Agrega un PlaceContentConfigElement, PlaceStandardContentElement o PlaceAllContentElement para especificar qué contenido se debe renderizar.

Para usar este elemento, habilita la API de Places UI Kit para tu proyecto en la consola de Google Cloud.

Elemento personalizado:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceDetailsCompactElementOptions.

Llama al const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Parámetros: 
orientation
Tipo:  PlaceDetailsOrientation optional
Predeterminado: PlaceDetailsOrientation.VERTICAL
Es la variante de orientación (vertical u horizontal) del elemento.
Atributo HTML:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
Tipo:  Place optional
Solo lectura. Objeto Place que contiene el ID, la ubicación y el viewport del lugar renderizado actualmente.
truncationPreferred
Tipo:  boolean
Predeterminado: false
Si es verdadero, trunca el nombre y la dirección del lugar para que quepan en una sola línea en lugar de ajustarse.
Atributo HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-mat-color-info
Color de los elementos de la IU con un sentimiento informativo. Se usa para el ícono de silla de ruedas.
--gmp-mat-color-negative
Color de los elementos de la IU con opinión negativa. Se usa para el texto "Cerrado" en el estado de apertura.
--gmp-mat-color-neutral-container
Color del contenedor para elementos de la IU completados neutros. Se usa para los marcadores de posición de imágenes.
--gmp-mat-color-on-secondary-container
Color del texto y los íconos sobre el color del contenedor secundario. Se usa para el texto y los íconos del botón "Abrir en Maps".
--gmp-mat-color-on-surface
Color para el texto y los íconos sobre cualquier color de superficie. Se usa para texto normal.
--gmp-mat-color-on-surface-variant
Color de menor énfasis para el texto y los íconos sobre cualquier color de superficie. Se usa para texto menos enfatizado.
--gmp-mat-color-outline-decorative
Color de contorno de los elementos no interactivos. Se usa para el borde del elemento.
--gmp-mat-color-positive
Color de los elementos de la IU con opinión positiva. Se usa para el texto "Abierto" en el estado de apertura actual.
--gmp-mat-color-primary
Color de los íconos y el texto interactivos en relación con el color de la superficie. Se usa para el recuento de opiniones y los vínculos en el diálogo de atribución.
--gmp-mat-color-secondary-container
Color de relleno menos destacado en comparación con la superficie, para componentes recesivos, como los botones tonales. Se usa para el fondo del botón "Abrir en Maps".
--gmp-mat-color-surface
Color para los fondos. Se usa para los fondos del elemento y el diálogo de atribución.
--gmp-mat-font-body-medium
Se usa para el texto del cuerpo en el diálogo de atribución.
--gmp-mat-font-body-small
Se usa para la dirección, la calificación, el tipo, el precio y el estado de apertura actual del lugar.
--gmp-mat-font-family
Es la familia de fuentes base que se usa para todo el texto.
--gmp-mat-font-headline-medium
Se usa para el texto del encabezado en el diálogo de atribución.
--gmp-mat-font-label-large
Se usa para el botón "Abrir en Maps" y los vínculos en el diálogo de atribución.
--gmp-mat-font-title-small
Se usa para el nombre del lugar.
background-color
Anula el color de fondo del elemento.
border
Anula el borde del elemento.
border-radius
Anula el radio del borde del elemento.
color-scheme
Indica con qué esquema de color se puede renderizar este elemento. Consulta la documentación de color-scheme para obtener más detalles. La configuración predeterminada es color-scheme: light dark.
font-size
Ajusta el tamaño de todo el texto y los íconos del elemento, que se definen internamente en ems. La configuración predeterminada es 16px.
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.
gmp-error
function(event)
Argumentos: 
Este evento se activa cuando se rechaza una solicitud al backend (p.ej., clave de API incorrecta). Este evento no se propaga.
gmp-load
function(event)
Argumentos: 
Este evento se activa cuando el elemento carga y renderiza su contenido. Este evento no se propaga.

Interfaz de PlaceDetailsCompactElementOptions

Interfaz de google.maps.places.PlaceDetailsCompactElementOptions

Opciones para PlaceDetailsCompactElement.

orientation optional
Tipo:  PlaceDetailsOrientation optional
truncationPreferred optional
Tipo:  boolean optional

Constantes de PlaceDetailsOrientation

Constantes de google.maps.places.PlaceDetailsOrientation

Son las variantes de orientación para PlaceDetailsCompactElement.

Llama al const {PlaceDetailsOrientation} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

HORIZONTAL Orientación horizontal.
VERTICAL Orientación vertical.

Clase PlaceDetailsPlaceRequestElement

Clase google.maps.places.PlaceDetailsPlaceRequestElement

Configura un elemento Place Details Compact para cargar datos basados en un objeto, un ID o un nombre de recurso de lugar. Agrega este elemento como secundario de un PlaceDetailsCompactElement para cargar datos del lugar especificado.

Elemento personalizado:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceDetailsPlaceRequestElementOptions.

Llama al const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Parámetros: 
place
Tipo:  Place optional
Es el objeto, el ID o el nombre del recurso del lugar para el que se renderizarán los detalles en el elemento compacto de Place Details. Esta propiedad se refleja en el atributo como un nombre de recurso.
Atributo HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceDetailsPlaceRequestElementOptions

Interfaz de google.maps.places.PlaceDetailsPlaceRequestElementOptions

Opciones para PlaceDetailsPlaceRequestElement.

place optional
Tipo:  Place|string optional

Clase PlaceContentConfigElement

Clase google.maps.places.PlaceContentConfigElement

Configura el contenido que mostrará un elemento de Place Details Compact. Agrega este elemento como secundario de un PlaceDetailsCompactElement para usarlo. Agrega cualquiera de los siguientes elementos a PlaceContentConfigElement para mostrar el contenido correspondiente:
PlaceMediaElement, PlaceAddressElement, PlaceRatingElement, PlaceTypeElement, PlacePriceElement, PlaceAccessibleEntranceIconElement, PlaceOpenNowStatusElement, PlaceAttributionElement
El orden de los elementos secundarios no importa; el elemento renderiza el contenido en un orden estándar que no se puede personalizar.

Elemento personalizado:
<gmp-place-content-config></gmp-place-content-config>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceContentConfigElementOptions.

Llama al const {PlaceContentConfigElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceContentConfigElement
PlaceContentConfigElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz PlaceContentConfigElementOptions

Interfaz de google.maps.places.PlaceContentConfigElementOptions

Opciones para PlaceContentConfigElement.

Clase PlaceMediaElement

Clase google.maps.places.PlaceMediaElement

Configura un elemento de Place Details Compact para mostrar el contenido multimedia de un lugar, como fotos. Agrega este elemento como secundario de un PlaceContentConfigElement para usarlo.

Elemento personalizado:
<gmp-place-media lightbox-preferred></gmp-place-media>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceMediaElementOptions.

Llama al const {PlaceMediaElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceMediaElement
PlaceMediaElement([options])
Parámetros: 
lightboxPreferred
Tipo:  boolean optional
Predeterminado: false
Indica si se debe habilitar o inhabilitar la Lightbox de medios en los casos en que se admiten ambas opciones.
Atributo HTML:
  • <gmp-place-media lightbox-preferred></gmp-place-media>
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceMediaElementOptions

Interfaz de google.maps.places.PlaceMediaElementOptions

Opciones para PlaceMediaElement.

lightboxPreferred optional
Tipo:  boolean optional

Clase PlaceAddressElement

Clase google.maps.places.PlaceAddressElement

Configura un elemento Place Details Compact para mostrar la dirección de un lugar. Agrega este elemento como secundario de un PlaceContentConfigElement para usarlo.

Elemento personalizado:
<gmp-place-address></gmp-place-address>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceAddressElementOptions.

Llama al const {PlaceAddressElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceAddressElement
PlaceAddressElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceAddressElementOptions

Interfaz de google.maps.places.PlaceAddressElementOptions

Opciones para PlaceAddressElement.

Clase PlaceRatingElement

Clase google.maps.places.PlaceRatingElement

Configura un elemento Place Details Compact para mostrar la calificación de un lugar. Agrega este elemento como secundario de un PlaceContentConfigElement para usarlo.

Elemento personalizado:
<gmp-place-rating></gmp-place-rating>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceRatingElementOptions.

Llama al const {PlaceRatingElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceRatingElement
PlaceRatingElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceRatingElementOptions

Interfaz de google.maps.places.PlaceRatingElementOptions

Opciones para PlaceRatingElement.

Clase PlaceTypeElement

Clase google.maps.places.PlaceTypeElement

Configura un elemento de Place Details Compact para mostrar el tipo de lugar. Agrega este elemento como secundario de un PlaceContentConfigElement para usarlo.

Elemento personalizado:
<gmp-place-type></gmp-place-type>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceTypeElementOptions.

Llama al const {PlaceTypeElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceTypeElement
PlaceTypeElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceTypeElementOptions

Interfaz de google.maps.places.PlaceTypeElementOptions

Opciones para PlaceTypeElement.

Clase PlacePriceElement

Clase google.maps.places.PlacePriceElement

Configura un elemento de Place Details Compact para mostrar el nivel de precios o el rango de precios de un lugar. Agrega este elemento como secundario de un PlaceContentConfigElement para usarlo.

Elemento personalizado:
<gmp-place-price></gmp-place-price>

Esta clase extiende HTMLElement.

Esta clase implementa PlacePriceElementOptions.

Llama al const {PlacePriceElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlacePriceElement
PlacePriceElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlacePriceElementOptions

Interfaz de google.maps.places.PlacePriceElementOptions

Opciones para PlacePriceElement.

Clase PlaceAccessibleEntranceIconElement

Clase google.maps.places.PlaceAccessibleEntranceIconElement

Configura un elemento de Place Details Compact para mostrar un ícono de silla de ruedas si el lugar tiene una entrada accesible. Agrega este elemento como secundario de un PlaceContentConfigElement para usarlo.

Elemento personalizado:
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceAccessibleEntranceIconElementOptions.

Llama al const {PlaceAccessibleEntranceIconElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceAccessibleEntranceIconElement
PlaceAccessibleEntranceIconElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceAccessibleEntranceIconElementOptions

Interfaz de google.maps.places.PlaceAccessibleEntranceIconElementOptions

Opciones para PlaceAccessibleEntranceIconElement.

Clase PlaceOpenNowStatusElement

Clase google.maps.places.PlaceOpenNowStatusElement

Configura un elemento Place Details Compact para mostrar el estado actual de abierto o cerrado de un lugar. Agrega este elemento como secundario de un PlaceContentConfigElement para usarlo.

Elemento personalizado:
<gmp-place-open-now-status></gmp-place-open-now-status>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceOpenNowStatusElementOptions.

Llama al const {PlaceOpenNowStatusElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceOpenNowStatusElement
PlaceOpenNowStatusElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceOpenNowStatusElementOptions

Interfaz de google.maps.places.PlaceOpenNowStatusElementOptions

Opciones para PlaceOpenNowStatusElement.

Clase PlaceAttributionElement

Clase google.maps.places.PlaceAttributionElement

Permite personalizar el texto de atribución de Google Maps en un elemento compacto de Place Details. Agrega este elemento como secundario de un PlaceContentConfigElement para usarlo. Si se omite este elemento, la atribución se seguirá mostrando con los colores predeterminados.

Elemento personalizado:
<gmp-place-attribution dark-scheme-color="white" light-scheme-color="white"></gmp-place-attribution>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceAttributionElementOptions.

Llama al const {PlaceAttributionElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceAttributionElement
PlaceAttributionElement([options])
Parámetros: 
darkSchemeColor
Tipo:  AttributionColor optional
Predeterminado: AttributionColor.WHITE
Color de la atribución de Google Maps en modo oscuro.
Atributo HTML:
  • <gmp-place-attribution dark-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="gray"></gmp-place-attribution>
lightSchemeColor
Tipo:  AttributionColor optional
Predeterminado: AttributionColor.GRAY
Color de la atribución de Google Maps en modo claro.
Atributo HTML:
  • <gmp-place-attribution light-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="gray"></gmp-place-attribution>
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceAttributionElementOptions

Interfaz de google.maps.places.PlaceAttributionElementOptions

Opciones para PlaceAttributionElement.

darkSchemeColor optional
Tipo:  AttributionColor optional
lightSchemeColor optional
Tipo:  AttributionColor optional

Constantes de AttributionColor

Constantes de google.maps.places.AttributionColor

Son las opciones de color para el texto de atribución de Google Maps. La atribución se puede personalizar para usar cualquiera de estos colores.

Llama al const {AttributionColor} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

BLACK Texto de atribución negro.
GRAY Texto de atribución gris.
WHITE Texto de atribución blanco.

Clase PlaceAllContentElement

Clase google.maps.places.PlaceAllContentElement

Configura un elemento Place Details Compact para mostrar todo el contenido disponible. Agrega este elemento como secundario de un PlaceDetailsCompactElement para usarlo.

Elemento personalizado:
<gmp-place-all-content></gmp-place-all-content>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceAllContentElementOptions.

Llama al const {PlaceAllContentElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceAllContentElement
PlaceAllContentElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceAllContentElementOptions

Interfaz de google.maps.places.PlaceAllContentElementOptions

Opciones para PlaceAllContentElement.

Clase PlaceStandardContentElement

Clase google.maps.places.PlaceStandardContentElement

Configura un elemento de Place Details Compact para mostrar un conjunto estándar de contenido (multimedia, calificación, tipo, precio, ícono de entrada accesible y estado de abierto ahora). Agrega este elemento como secundario de un PlaceDetailsCompactElement para usarlo.

Elemento personalizado:
<gmp-place-standard-content></gmp-place-standard-content>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceStandardContentElementOptions.

Llama al const {PlaceStandardContentElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceStandardContentElement
PlaceStandardContentElement([options])
Parámetros: 
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz de PlaceStandardContentElementOptions

Interfaz de google.maps.places.PlaceStandardContentElementOptions

Opciones para PlaceStandardContentElement.

Clase PlaceListElement

Clase google.maps.places.PlaceListElement

Es un elemento HTML que muestra los resultados de una búsqueda de lugar en una lista. Usa los métodos configureFromSearchByTextRequest() o configureFromSearchNearbyRequest() para especificar la solicitud para la que se renderizarán los resultados. Para usar el elemento de lista de lugares, habilita la API de Places UI Kit para tu proyecto en la consola de Google Cloud.

Elemento personalizado:
<gmp-place-list selectable></gmp-place-list>

Esta clase extiende HTMLElement.

Esta clase implementa PlaceListElementOptions.

Llama al const {PlaceListElement} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

PlaceListElement
PlaceListElement([options])
Parámetros: 
places
Tipo:  Array<Place>
Solo lectura. Es un array de objetos Place que contiene los IDs, las ubicaciones y los viewport de los lugares renderizados actualmente.
selectable
Tipo:  boolean
Indica si los elementos de la lista se pueden seleccionar o no. Si es verdadero, los elementos de la lista serán botones que envían el evento gmp-placeselect cuando se hace clic en ellos. También se admite la navegación y selección accesibles con el teclado.
Atributo HTML:
  • <gmp-place-list selectable></gmp-place-list>
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listenerEventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • optionsboolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
configureFromSearchByTextRequest
configureFromSearchByTextRequest(request)
Parámetros: 
  • requestSearchByTextRequest Es la solicitud para la que se renderizarán los resultados. No se requiere la propiedad fields del objeto SearchByTextRequest.
Valor de devolución:  Promise<void> Es una promesa que se resuelve una vez que se cargan y renderizan los datos del lugar.
Configura el widget para renderizar los resultados de la búsqueda a partir de una solicitud a la API de Places Text Search.
configureFromSearchNearbyRequest
configureFromSearchNearbyRequest(request)
Parámetros: 
  • requestSearchNearbyRequest Es la solicitud para la que se renderizarán los resultados. No se requiere la propiedad fields del objeto SearchNearbyRequest.
Valor de devolución:  Promise<void> Es una promesa que se resuelve una vez que se cargan y renderizan los datos del lugar.
Configura el widget para renderizar los resultados de búsqueda de una solicitud a la API de Places Nearby Search.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • typestring Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listenerEventListener|EventListenerObject El objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento.
  • optionsboolean|EventListenerOptions optional Consulta las opciones.
Valor de devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.
gmp-load
function(event)
Argumentos: 
Este evento se activa cuando el elemento carga y renderiza su contenido. Este evento no se propaga.
gmp-placeselect
function(event)
Argumentos: 
Este evento se activa cuando un usuario selecciona un lugar. Contiene un objeto Place y el índice del lugar seleccionado en la lista.
gmp-requesterror
function(event)
Argumentos: 
Este evento se activa cuando se rechaza una solicitud al backend (p.ej., clave de API incorrecta). Este evento no se propaga.

Interfaz de PlaceListElementOptions

Interfaz de google.maps.places.PlaceListElementOptions

Opciones para PlaceListElement.

selectable optional
Tipo:  boolean optional

Clase PlaceListPlaceSelectEvent

Clase google.maps.places.PlaceListPlaceSelectEvent

PlaceListElement emite este evento cuando el usuario selecciona un lugar.

Esta clase extiende Event.

Llama al const {PlaceListPlaceSelectEvent} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

index
Tipo:  number
Índice de la lista del lugar seleccionado.
place
Tipo:  Place
Es un objeto Place que contiene el ID, la ubicación y la ventana gráfica del lugar seleccionado.

Clase Autocomplete

Clase google.maps.places.Autocomplete

Es un widget que proporciona predicciones de lugares basadas en la entrada de texto de un usuario. Se adjunta a un elemento de entrada de tipo text y escucha la entrada de texto en ese campo. La lista de predicciones se presenta como una lista desplegable y se actualiza a medida que se ingresa texto.

Esta clase extiende MVCObject.

Llama al const {Autocomplete} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

Autocomplete
Autocomplete(inputField[, opts])
Parámetros: 
Crea una instancia nueva de Autocomplete que se adjunta al campo de texto de entrada especificado con las opciones proporcionadas.
getBounds
getBounds()
Parámetros: Ninguno
Valor de devolución:  LatLngBounds|undefined Los límites del ajuste.
Devuelve los límites hacia los que se sesgan las predicciones.
getFields
getFields()
Parámetros: Ninguno
Valor de devolución:  Array<string>|undefined
Devuelve los campos que se incluirán para el lugar en la respuesta de detalles cuando estos se recuperen correctamente. Para obtener una lista de los campos, consulta PlaceResult.
getPlace
getPlace()
Parámetros: Ninguno
Valor de devolución:  PlaceResult Es el lugar seleccionado por el usuario.
Devuelve los detalles del lugar seleccionado por el usuario si se recuperaron correctamente. De lo contrario, devuelve un objeto Place de código auxiliar, con la propiedad name establecida en el valor actual del campo de entrada.
setBounds
setBounds(bounds)
Parámetros: 
Valor de retorno: Ninguno
Establece el área preferida dentro de la cual se devolverán los resultados de Place. Los resultados se personalizan, aunque no de manera exclusiva, conforme a esta área.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parámetros: 
Valor de retorno: Ninguno
Establece las restricciones del componente. Las restricciones de componentes se usan para restringir las predicciones solo a las que se encuentran dentro del componente principal. Por ejemplo, el país.
setFields
setFields(fields)
Parámetros: 
  • fieldsArray<string> optional
Valor de retorno: Ninguno
Establece los campos que se incluirán para el lugar en la respuesta de detalles cuando los detalles se recuperen correctamente. Para obtener una lista de los campos, consulta PlaceResult.
setOptions
setOptions(options)
Parámetros: 
Valor de retorno: Ninguno
setTypes
setTypes(types)
Parámetros: 
  • typesArray<string> optional Son los tipos de predicciones que se incluirán.
Valor de retorno: Ninguno
Establece los tipos de predicciones que se devolverán. Para conocer los tipos compatibles, consulta la guía para desarrolladores. Si no se especifican tipos, se devolverán todos los tipos.
Heredado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argumentos: Ninguno
Este evento se activa cuando un objeto PlaceResult está disponible para un lugar que seleccionó el usuario.
Si el usuario ingresa el nombre de un lugar que no sugirió el control y presiona la tecla Intro, o si falla una solicitud de Place Details, el objeto PlaceResult contiene la entrada del usuario en la propiedad name, sin ninguna otra propiedad definida.

Interfaz de AutocompleteOptions

Interfaz de google.maps.places.AutocompleteOptions

Son las opciones que se pueden establecer en un objeto Autocomplete.

bounds optional
Es el área en la que se buscarán lugares.
componentRestrictions optional
Tipo:  ComponentRestrictions optional
Son las restricciones del componente. Las restricciones de componentes se usan para restringir las predicciones solo a las que se encuentran dentro del componente principal. Por ejemplo, el país.
fields optional
Tipo:  Array<string> optional
Son los campos que se incluirán para el lugar en la respuesta de detalles cuando estos se recuperen correctamente, por los que se facturará. Si se pasa ['ALL'], 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 los campos, consulta PlaceResult. Los campos anidados se pueden especificar con rutas de puntos (por ejemplo, "geometry.location"). El valor predeterminado es ['ALL'].
placeIdOnly optional
Tipo:  boolean optional
Indica si se deben recuperar solo los IDs de lugar. El objeto PlaceResult que estará disponible cuando se active el evento place_changed solo tendrá los campos place_id, types y name, con los campos place_id, types y description que devuelve el servicio Autocomplete. Está inhabilitado de forma predeterminada.
strictBounds optional
Tipo:  boolean optional
Es un valor booleano que indica que el widget de Autocomplete solo debe mostrar los lugares que se encuentran dentro de los límites del widget de Autocomplete en el momento en que se envía la búsqueda. Si configuras strictBounds como false (que es el valor predeterminado), los resultados se personalizarán, aunque no de manera exclusiva, conforme a los límites.
types optional
Tipo:  Array<string> optional
Son los tipos de predicciones que se devolverán. Para conocer los tipos compatibles, consulta la guía para desarrolladores. Si no se especifican tipos, se devolverán todos los tipos.

Clase google.maps.places.SearchBox

Es un widget que proporciona predicciones de búsqueda basadas en la entrada de texto de un usuario. Se adjunta a un elemento de entrada de tipo text y escucha la entrada de texto en ese campo. La lista de predicciones se presenta como una lista desplegable y se actualiza a medida que se ingresa texto.

Esta clase extiende MVCObject.

Llama al const {SearchBox} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.

SearchBox
SearchBox(inputField[, opts])
Parámetros: 
Crea una instancia nueva de SearchBox que se adjunta al campo de texto de entrada especificado con las opciones proporcionadas.
getBounds
getBounds()
Parámetros: Ninguno
Valor de devolución:  LatLngBounds|undefined
Devuelve los límites hacia los que se sesgan las predicciones de la búsqueda.
getPlaces
getPlaces()
Parámetros: Ninguno
Valor de devolución:  Array<PlaceResult>|undefined
Devuelve la búsqueda que seleccionó el usuario para usarla con el evento places_changed.
setBounds
setBounds(bounds)
Parámetros: 
Valor de retorno: Ninguno
Establece la región que se usará para sesgar las predicciones de búsqueda. Los resultados solo se personalizarán para esta área y no se restringirán por completo a ella.
Heredado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumentos: Ninguno
Este evento se activa cuando el usuario selecciona una búsqueda. Se debe usar getPlaces para obtener lugares nuevos.

Interfaz de SearchBoxOptions

Interfaz de google.maps.places.SearchBoxOptions

Son las opciones que se pueden establecer en un objeto SearchBox.

bounds optional
Es el área hacia la que se sesgan las predicciones de la búsqueda. Las predicciones se personalizan, aunque no de manera exclusiva, conforme a las búsquedas que se dirigen a estos límites.