Places Widgets

Clase PlaceAutocompleteElement

class google.maps.places.PlaceAutocompleteElement extends HTMLElement implements PlaceAutocompleteElementOptions
library "places"

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

PlaceAutocompleteElement usa automáticamente AutocompleteSessionToken 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 devuelve 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 el funcionamiento de los tokens de sesión.

<gmp-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-place-autocomplete>

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places");

Constructor
PlaceAutocompleteElement	PlaceAutocompleteElement([options]) Parámetros: options: PlaceAutocompleteElementOptions optional

Propiedades
description attr: description	Tipo: string optional Es la descripción que se usará para el elemento de entrada. Los lectores de pantalla detectarán esto cuando se enfoque el elemento de entrada. Consulta https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby para obtener más detalles. Atributo HTML: description="string"
disabled attr: disabled	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si el elemento de entrada está inhabilitado. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled para obtener más detalles. Atributo HTML: disabled
futureOpeningBusinessesIncluded attr: future-opening-businesses-included	Tipo: boolean optional Indica si se deben incluir los lugares que aún no están abiertos, pero que se espera que abran en el futuro. Atributo HTML: future-opening-businesses-included
includedPrimaryTypes attr: included-primary-types	Tipo: Array<string> optional Incluye el tipo de lugar principal (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 especifica ningún tipo, se devuelven todos los tipos de Place. Atributo HTML: included-primary-types="type1 type2 type3..."
includedRegionCodes attr: included-region-codes	Tipo: Array<string> optional Solo incluye resultados en las regiones especificadas, que se indican con hasta 15 códigos de región de dos caracteres del CLDR. 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: included-region-codes="c1 c2 c3..."
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
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.
maxlength attr: maxlength	Tipo: number optional Es la cantidad máxima de caracteres que puede ingresar el usuario. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength para obtener más detalles. Atributo HTML: maxlength="number"
name attr: name	Tipo: string optional Es el 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: name="string"
noClearButton attr: no-clear-button	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si se debe ocultar el botón para borrar. Atributo HTML: no-clear-button
noInputIcon attr: no-input-icon	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si se debe ocultar el ícono de entrada. Atributo HTML: no-input-icon
origin attr: origin	Tipo de entrada: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Tipo de salida: LatLngAltitude optional 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: origin="lat,lng" origin="lat,lng,altitude"
placeholder attr: placeholder	Tipo: string optional Es el texto de marcador de posición que se usará para el elemento de entrada. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder para obtener más detalles. Atributo HTML: placeholder="string"
pureServiceAreaBusinessesIncluded attr: pure-service-area-businesses-included	Tipo: boolean optional Indica si se deben incluir lugares que sean exclusivamente empresas de servicio en el área. Atributo HTML: pure-service-area-businesses-included
readonly attr: readonly	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si el elemento de entrada es de solo lectura. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly para obtener más detalles. Atributo HTML: readonly
requestedLanguage attr: requested-language	Tipo: string optional Es un identificador del 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 restringen a este idioma. Consulta la lista de idiomas compatibles. Atributo HTML: requested-language="string"
requestedRegion attr: requested-region	Tipo: string optional Es un código de región que se usa para dar formato a los resultados y filtrarlos. No restringe las sugerencias a este país. El código de región acepta un valor de dos caracteres de ccTLD ("dominio de nivel superior"). 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 "Reino Unido de Gran Bretaña e Irlanda del Norte"). Atributo HTML: requested-region="string"
unitSystem attr: unit-system	Tipo de entrada: UnitSystem optional Tipo de salida: 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 requestedRegion. Atributo HTML: unit-system="value-name"
value	Tipo de entrada: string optional Tipo de salida: string Es el valor del elemento de entrada.

Ranuras
clear-icon	Coloca el elemento con ranura en la posición del ícono de borrar. El botón para borrar se muestra al final del cuadro de entrada cuando hay texto en la entrada.
input-icon	Coloca el elemento con ranura en la posición del ícono de entrada. El ícono de entrada se muestra al principio del cuadro de entrada en el modo intercalado.
prediction-item-icon	Este espacio acepta exactamente un elemento <template> para renderizarlo como el ícono que se muestra junto al elemento de predicción.

Piezas
focus-ring	Es el elemento que se usa para mostrar el anillo de enfoque alrededor del elemento enfocado (entrada o elementos de predicción).
input	Es el elemento de entrada para el elemento de autocompletado.
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 de prediction-item 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 prediction-item-main-text se muestra 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 solo se destaca dentro de prediction-item-main-text.
prediction-item-nonmatch	La parte del texto principal de la predicción que no coincide con la entrada del usuario.
prediction-item-secondary-text	Es una parte de prediction-item que es el texto secundario de la predicción. El texto adicional normalmente es una dirección.
prediction-item-selected	Es el elemento que aparece cuando el usuario navega hasta él con el teclado. Nota: Los elementos seleccionados se verán afectados por los estilos de esta parte y también por los estilos de la parte prediction-item.
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 de PlaceAutocompleteElement.

Propiedades de CSS
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	Anula la fuente del elemento.
color-scheme	Indica en qué esquema de colores 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	Anula la fuente del elemento.
font-family	Anula la fuente del elemento.
font-size	Anula la fuente del elemento.
font-style	Anula la fuente del elemento.
font-weight	Anula la fuente del elemento.
line-height	Anula la fuente del elemento.

Métodos
Heredado: addEventListener, removeEventListener

Eventos
gmp-error	function(errorEvent) Argumentos: errorEvent: Event optional 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: placePredictionSelectEvent: PlacePredictionSelectEvent optional 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 google.maps.places.PlaceAutocompleteElementOptions
implementada por PlaceAutocompleteElement

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

Propiedades
description opcional	Tipo: string optional Es la descripción que se usará para el elemento de entrada. Los lectores de pantalla detectarán esto cuando se enfoque el elemento de entrada.
disabled opcional	Tipo: boolean optional
futureOpeningBusinessesIncluded opcional	Tipo: boolean optional
includedPrimaryTypes opcional	Tipo: Array<string> optional
includedRegionCodes opcional	Tipo: Array<string> optional
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional
locationBias opcional	Tipo: LocationBias optional
locationRestriction opcional	Tipo: LocationRestriction optional
maxlength opcional	Tipo: number optional
name opcional	Tipo: string optional
noClearButton opcional	Tipo: boolean optional
noInputIcon opcional	Tipo: boolean optional
origin opcional	Tipo: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
placeholder opcional	Tipo: string optional
pureServiceAreaBusinessesIncluded opcional	Tipo: boolean optional
readonly opcional	Tipo: boolean optional
requestedLanguage opcional	Tipo: string optional
requestedRegion opcional	Tipo: string optional
unitSystem opcional	Tipo: UnitSystem optional
value opcional	Tipo: string optional Es el valor del elemento de entrada.

Clase PlacePredictionSelectEvent

class google.maps.places.PlacePredictionSelectEvent extends Event
library "places"

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.

Convierte placePrediction en un Place llamando a PlacePrediction.toPlace.

const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places");

Propiedades
placePrediction readonly	Tipo: PlacePrediction Para convertirlo en un Place, llama a PlacePrediction.toPlace.

Clase BasicPlaceAutocompleteElement

class google.maps.places.BasicPlaceAutocompleteElement extends HTMLElement implements BasicPlaceAutocompleteElementOptions
library "places"

BasicPlaceAutocompleteElement es una subclase de HTMLElement que proporciona un componente de IU para la API de Place Autocomplete.

<gmp-basic-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-basic-place-autocomplete>

const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places");

Constructor
BasicPlaceAutocompleteElement	BasicPlaceAutocompleteElement([options]) Parámetros: options: BasicPlaceAutocompleteElementOptions optional

Propiedades
description attr: description	Tipo: string optional Es la descripción que se usará para el elemento de entrada. Los lectores de pantalla detectarán esto cuando se enfoque el elemento de entrada. Consulta https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby para obtener más detalles. Atributo HTML: description="string"
disabled attr: disabled	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si el elemento de entrada está inhabilitado. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled para obtener más detalles. Atributo HTML: disabled
futureOpeningBusinessesIncluded attr: future-opening-businesses-included	Tipo: boolean optional Indica si se deben incluir los lugares que aún no están abiertos, pero que se espera que abran en el futuro. Atributo HTML: future-opening-businesses-included
includedPrimaryTypes attr: included-primary-types	Tipo: Array<string> optional Incluye el tipo de lugar principal (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 especifica ningún tipo, se devuelven todos los tipos de Place. Atributo HTML: included-primary-types="type1 type2 type3..."
includedRegionCodes attr: included-region-codes	Tipo: Array<string> optional Solo incluye resultados en las regiones especificadas, que se indican con hasta 15 códigos de región de dos caracteres del CLDR. 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: included-region-codes="c1 c2 c3..."
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
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.
maxlength attr: maxlength	Tipo: number optional Es la cantidad máxima de caracteres que puede ingresar el usuario. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength para obtener más detalles. Atributo HTML: maxlength="number"
name attr: name	Tipo: string optional Es el 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: name="string"
noClearButton attr: no-clear-button	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si se debe ocultar el botón para borrar. Atributo HTML: no-clear-button
noInputIcon attr: no-input-icon	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si se debe ocultar el ícono de entrada. Atributo HTML: no-input-icon
origin attr: origin	Tipo de entrada: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Tipo de salida: LatLngAltitude optional 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: origin="lat,lng" origin="lat,lng,altitude"
placeholder attr: placeholder	Tipo: string optional Es el texto de marcador de posición que se usará para el elemento de entrada. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder para obtener más detalles. Atributo HTML: placeholder="string"
pureServiceAreaBusinessesIncluded attr: pure-service-area-businesses-included	Tipo: boolean optional Indica si se deben incluir lugares que sean exclusivamente empresas de servicio en el área. Atributo HTML: pure-service-area-businesses-included
readonly attr: readonly	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si el elemento de entrada es de solo lectura. Consulta https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly para obtener más detalles. Atributo HTML: readonly
requestedLanguage attr: requested-language	Tipo: string optional Es un identificador del 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 restringen a este idioma. Consulta la lista de idiomas compatibles. Atributo HTML: requested-language="string"
requestedRegion attr: requested-region	Tipo: string optional Es un código de región que se usa para dar formato a los resultados y filtrarlos. No restringe las sugerencias a este país. El código de región acepta un valor de dos caracteres de ccTLD ("dominio de nivel superior"). 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 "Reino Unido de Gran Bretaña e Irlanda del Norte"). Atributo HTML: requested-region="string"
unitSystem attr: unit-system	Tipo de entrada: UnitSystem optional Tipo de salida: 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 requestedRegion. Atributo HTML: unit-system="value-name"

Ranuras
clear-icon	Coloca el elemento con ranura en la posición del ícono de borrar. El botón para borrar se muestra al final del cuadro de entrada cuando hay texto en la entrada.
input-icon	Coloca el elemento con ranura en la posición del ícono de entrada. El ícono de entrada se muestra al principio del cuadro de entrada en el modo intercalado.
prediction-item-icon	Este espacio acepta exactamente un elemento <template> para renderizarlo como el ícono que se muestra junto al elemento de predicción.

Piezas
focus-ring	Es el elemento que se usa para mostrar el anillo de enfoque alrededor del elemento enfocado (entrada o elementos de predicción).
input	Es el elemento de entrada para el elemento de autocompletado.
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 de prediction-item 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 prediction-item-main-text se muestra 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 solo se destaca dentro de prediction-item-main-text.
prediction-item-nonmatch	La parte del texto principal de la predicción que no coincide con la entrada del usuario.
prediction-item-secondary-text	Es una parte de prediction-item que es el texto secundario de la predicción. El texto adicional normalmente es una dirección.
prediction-item-selected	Es el elemento que aparece cuando el usuario navega hasta él con el teclado. Nota: Los elementos seleccionados se verán afectados por los estilos de esta parte y también por los estilos de la parte prediction-item.
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 de PlaceAutocompleteElement.

Propiedades de CSS
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	Anula la fuente del elemento.
color-scheme	Indica en qué esquema de colores 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	Anula la fuente del elemento.
font-family	Anula la fuente del elemento.
font-size	Anula la fuente del elemento.
font-style	Anula la fuente del elemento.
font-weight	Anula la fuente del elemento.
line-height	Anula la fuente del elemento.

Métodos
Heredado: addEventListener, removeEventListener

Eventos
gmp-error	function(errorEvent) Argumentos: errorEvent: Event optional 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(placeSelectEvent) Argumentos: placeSelectEvent: PlaceSelectEvent optional Este evento se activa cuando un usuario selecciona una predicción de lugar. Contiene un objeto Place.

Interfaz BasicPlaceAutocompleteElementOptions

interfaz google.maps.places.BasicPlaceAutocompleteElementOptions
implementada por BasicPlaceAutocompleteElement

Opciones para construir un BasicPlaceAutocompleteElement.

Propiedades
description opcional	Tipo: string optional Es la descripción que se usará para el elemento de entrada. Los lectores de pantalla detectarán esto cuando se enfoque el elemento de entrada.
disabled opcional	Tipo: boolean optional
futureOpeningBusinessesIncluded opcional	Tipo: boolean optional
includedPrimaryTypes opcional	Tipo: Array<string> optional
includedRegionCodes opcional	Tipo: Array<string> optional
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional
locationBias opcional	Tipo: LocationBias optional
locationRestriction opcional	Tipo: LocationRestriction optional
maxlength opcional	Tipo: number optional
name opcional	Tipo: string optional
noClearButton opcional	Tipo: boolean optional
noInputIcon opcional	Tipo: boolean optional
origin opcional	Tipo: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
placeholder opcional	Tipo: string optional
pureServiceAreaBusinessesIncluded opcional	Tipo: boolean optional
readonly opcional	Tipo: boolean optional
requestedLanguage opcional	Tipo: string optional
requestedRegion opcional	Tipo: string optional
unitSystem opcional	Tipo: UnitSystem optional

Clase PlaceDetailsElement

clase google.maps.places.PlaceDetailsElement extiende HTMLElement implementa PlaceDetailsElementOptions
extendida por AdvancedPlaceDetailsElement
biblioteca "places"

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

Ejemplo:

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details> 

Para usar este elemento, habilita la API del kit de IU de Places para tu proyecto en la consola de Google Cloud.

<gmp-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-place-details>

const {PlaceDetailsElement} = await google.maps.importLibrary("places");

Constructor
PlaceDetailsElement	PlaceDetailsElement([options]) Parámetros: options: PlaceDetailsElementOptions optional

Propiedades
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
place readonly	Tipo: Place optional Solo lectura. Es el objeto Place que contiene el ID, la ubicación y el viewport del lugar renderizado actualmente.

Propiedades de CSS
--gmp-button-border-color	Es el color del borde del botón "Abrir en Maps".
--gmp-button-border-radius	Es el radio del borde del botón "Abrir en Maps".
--gmp-button-border-width	Es el ancho del borde del botón "Abrir en Maps".
--gmp-collage-border-radius-outer	Es el radio del borde de las esquinas exteriores del collage de contenido multimedia.
--gmp-dialog-border-radius	Es el radio del borde del diálogo de divulgación de Google Maps.
--gmp-mat-color-disabled-surface	Color de superficie destinado a transmitir estados inhabilitados o de no presencia. Se usa para las estrellas de opiniones vacías.
--gmp-mat-color-info	Es el color de los elementos de la IU con un sentimiento informativo. Se usa para el ícono de silla de ruedas.
--gmp-mat-color-negative	Es el color de los elementos de la IU con un sentimiento negativo. Se usa para el texto "Cerrado" en el estado de apertura actual.
--gmp-mat-color-neutral-container	Es el color del contenedor para los elementos de la IU con relleno neutro. Se usa para los marcadores de posición de imágenes y la insignia de la fecha de publicación de la opinión.
--gmp-mat-color-on-neutral-container	Color del texto y de los íconos sobre el color neutro del contenedor. Se usa para la insignia de la fecha de publicación de la opinión y la insignia de disponibilidad del cargador de VE cuando no está disponible.
--gmp-mat-color-on-positive-container	Color de los textos y los íconos en contraste con el color del contenedor positivo. Se usa para la insignia de disponibilidad del cargador de VE cuando está disponible.
--gmp-mat-color-on-secondary-container	Es el color del texto y de 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 el texto normal.
--gmp-mat-color-on-surface-variant	Es el color de menor énfasis para el texto y los íconos sobre cualquier color de superficie. Se usa para texto con menos énfasis.
--gmp-mat-color-outline-decorative	Es el color del contorno de los elementos no interactivos. Se usa para el borde del elemento.
--gmp-mat-color-positive	Es el color de los elementos de la IU con un sentimiento positivo. Se usa para el texto "Abierto" en el estado de abierto ahora.
--gmp-mat-color-positive-container	Es el color del contenedor para los elementos de la IU que transmiten un sentimiento positivo. Se usa para la insignia de disponibilidad del cargador de VE cuando está disponible.
--gmp-mat-color-primary	Es el color del texto y los íconos interactivos en comparación con el color de la superficie. Se usa para el recuento de opiniones, los vínculos en el diálogo de divulgaciones de Google Maps, el vínculo al sitio web, los íconos en la pestaña Resumen y (desplazamiento/enfoque/color del texto) en los títulos de la barra de pestañas.
--gmp-mat-color-secondary-container	Es un color de relleno menos destacado contra 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 divulgación de Google Maps.
--gmp-mat-font-body-medium	Se usa para la dirección, la calificación, el tipo, el precio, el estado de apertura, el horario de atención, las opiniones, el número de teléfono, el sitio web, el Plus Code, las características principales y el texto del cuerpo del diálogo de divulgación de Google Maps.
--gmp-mat-font-body-small	Se usa para el texto del cuerpo de la lista de funciones en la pestaña "Acerca de".
--gmp-mat-font-display-small	Se usa para el nombre del lugar y el texto de cada encabezado de atributo en la pestaña "Acerca de".
--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 divulgación de Google Maps.
--gmp-mat-font-label-large	Se usa para los títulos de las pestañas, el botón "Abrir en Maps", el texto de atribución del usuario que envía la opinión en la galería de fotos, el texto de atribución del usuario que envía la opinión en la sección de opiniones y los vínculos en el diálogo de divulgación de Google Maps.
--gmp-mat-font-label-medium	Se usa para la insignia de recuento de fotos y la insignia de fecha de publicación de la opinión.
--gmp-mat-font-title-small	Se usa para el título de cada sección en la pestaña "Acerca de".
--gmp-mat-spacing-extra-large	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-extra-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-large	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-medium	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-two-extra-large	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-star-rating-color	Es el color de las estrellas completas en la calificación.
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 en qué esquema de colores 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 la escala de todo el texto y los íconos del elemento, que se definen internamente en ems. La configuración predeterminada es 16px.

Métodos
Heredado: addEventListener, removeEventListener

Eventos
gmp-error	function(event) Argumentos: event: Event optional 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: event: Event optional Este evento se activa cuando el elemento carga y renderiza su contenido. Este evento no se propaga.

Interfaz PlaceDetailsElementOptions

interfaz google.maps.places.PlaceDetailsElementOptions
extendida por AdvancedPlaceDetailsElementOptions
implementada por AdvancedPlaceDetailsElement, PlaceDetailsElement

Opciones para PlaceDetailsElement.

Propiedades
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS.

Clase PlaceDetailsCompactElement

clase google.maps.places.PlaceDetailsCompactElement extiende HTMLElement implementa PlaceDetailsCompactElementOptions
extendida por AdvancedPlaceDetailsCompactElement
biblioteca "places"

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

Ejemplo:

 <gmp-place-details-compact>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details-compact> 

Para usar este elemento, habilita la API del kit de IU de Places para tu proyecto en la consola de Google Cloud.

<gmp-place-details-compact
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  truncation-preferred>
</gmp-place-details-compact>

const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places");

Constructor
PlaceDetailsCompactElement	PlaceDetailsCompactElement([options]) Parámetros: options: PlaceDetailsCompactElementOptions optional

Propiedades
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
orientation attr: orientation	Tipo: PlaceDetailsOrientation optional La configuración predeterminada es PlaceDetailsOrientation.VERTICAL. Es la variante de orientación (vertical u horizontal) del elemento. Atributo HTML: orientation="value-name"
place readonly	Tipo: Place optional Solo lectura. Es el objeto Place que contiene el ID, la ubicación y el viewport del lugar renderizado actualmente.
truncationPreferred attr: truncation-preferred	Tipo de entrada: boolean optional Tipo de salida: boolean La configuración predeterminada es false. Si es verdadero, trunca el nombre y la dirección del lugar para que quepan en una línea en lugar de ajustarse. Atributo HTML: truncation-preferred

Propiedades de CSS
--gmp-button-border-color	Es el color del borde del botón "Abrir en Maps".
--gmp-button-border-radius	Es el radio del borde del botón "Abrir en Maps".
--gmp-button-border-width	Es el ancho del borde del botón "Abrir en Maps".
--gmp-dialog-border-radius	Es el radio del borde del diálogo de divulgación de Google Maps.
--gmp-mat-color-info	Es el color de los elementos de la IU con un sentimiento informativo. Se usa para el ícono de silla de ruedas.
--gmp-mat-color-negative	Es el color de los elementos de la IU con un sentimiento negativo. Se usa para el texto "Cerrado" en el estado de apertura actual.
--gmp-mat-color-neutral-container	Es el color del contenedor para los elementos de la IU con relleno neutro. Se usa para los marcadores de posición de imágenes.
--gmp-mat-color-on-secondary-container	Es el color del texto y de 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 el texto normal.
--gmp-mat-color-on-surface-variant	Es el color de menor énfasis para el texto y los íconos sobre cualquier color de superficie. Se usa para texto con menos énfasis.
--gmp-mat-color-outline-decorative	Es el color del contorno de los elementos no interactivos. Se usa para el borde del elemento.
--gmp-mat-color-positive	Es el color de los elementos de la IU con un sentimiento positivo. Se usa para el texto "Abierto" en el estado de abierto ahora.
--gmp-mat-color-primary	Es el color del texto y los íconos interactivos en comparación con el color de la superficie. Se usa para el recuento de opiniones, así como para los vínculos en el diálogo de divulgación de Google Maps.
--gmp-mat-color-secondary-container	Es un color de relleno menos destacado contra 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 divulgación de Google Maps.
--gmp-mat-font-body-medium	Se usa para el texto del cuerpo en el diálogo de divulgaciones de Google Maps.
--gmp-mat-font-body-small	Se usa para la dirección, la calificación, el tipo, el precio y el estado de apertura 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 divulgación de Google Maps.
--gmp-mat-font-label-large	Se usa para el botón "Abrir en Maps", así como para los vínculos en el diálogo de divulgación de Google Maps y el texto de atribución del revisor en la galería de fotos.
--gmp-mat-font-label-medium	Se usa para la insignia de recuento de fotos.
--gmp-mat-font-title-small	Se usa para el nombre del lugar.
--gmp-mat-spacing-extra-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-large	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-medium	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-star-rating-color	Es el color de las estrellas completas en la calificación.
--gmp-thumbnail-border-radius	Es el radio del borde de la imagen en miniatura 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 en qué esquema de colores 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 la escala de todo el texto y los íconos del elemento, que se definen internamente en ems. La configuración predeterminada es 16px.

Métodos
Heredado: addEventListener, removeEventListener

Eventos
gmp-error	function(event) Argumentos: event: Event optional 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: event: Event optional Este evento se activa cuando el elemento carga y renderiza su contenido. Este evento no se propaga.

Interfaz PlaceDetailsCompactElementOptions

interfaz google.maps.places.PlaceDetailsCompactElementOptions
extendida por AdvancedPlaceDetailsCompactElementOptions
implementada por AdvancedPlaceDetailsCompactElement, PlaceDetailsCompactElement

Opciones para PlaceDetailsCompactElement.

Propiedades
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS.
orientation opcional	Tipo: PlaceDetailsOrientation optional Consulta los PlaceDetailsCompactElement.orientation.
truncationPreferred opcional	Tipo: boolean optional Consulta los PlaceDetailsCompactElement.truncationPreferred.

Clase AdvancedPlaceDetailsElement

class google.maps.places.AdvancedPlaceDetailsElement extends PlaceDetailsElement, HTMLElement implements AdvancedPlaceDetailsElementOptions, PlaceDetailsElementOptions
library "places"

Muestra los detalles de un lugar en un diseño completo. Agrega un PlaceDetailsPlaceRequestElement o un PlaceDetailsLocationRequestElement para especificar el lugar que se renderizará. Agrega un elemento PlaceStandardContentElement, PlaceAllContentElement o de Place Details directamente para configurar el contenido que se renderizará.

Ejemplo:

 <gmp-advanced-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-standard-content>
   </gmp-place-standard-content>
 </gmp-advanced-place-details> 

Para usar este elemento, habilita la API del kit de IU de Places para tu proyecto en la consola de Google Cloud.

<gmp-advanced-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details>

const {AdvancedPlaceDetailsElement} = await google.maps.importLibrary("places");

Constructor
AdvancedPlaceDetailsElement	AdvancedPlaceDetailsElement([options]) Parámetros: options: AdvancedPlaceDetailsElementOptions optional

Propiedades
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
place readonly	Tipo: Place optional Solo lectura. Es el objeto Place que contiene el ID, la ubicación y el viewport del lugar renderizado actualmente.

Ranuras
action-corner	Un horario para PlaceLinkElement y PlaceButtonElement.
action-main	Un horario para PlaceLinkElement y PlaceButtonElement.
basic-section-bottom	Aviso: Solo está disponible en el canal v=alpha. Es un espacio para el contenido HTML personalizado que se renderiza en la parte inferior de la sección de información básica, justo debajo de los botones de acción principales.
basic-section-top	Aviso: Solo está disponible en el canal v=alpha. Es un espacio para el contenido HTML personalizado que se renderiza en la sección de información básica, directamente sobre el nombre del lugar.

Propiedades de CSS

Heredados: --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-collage-border-radius-outer, --gmp-dialog-border-radius, --gmp-mat-color-disabled-surface, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-neutral-container, --gmp-mat-color-on-positive-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-positive-container, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-display-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-label-medium, --gmp-mat-font-title-small, --gmp-mat-spacing-extra-large, --gmp-mat-spacing-extra-small, --gmp-mat-spacing-large, --gmp-mat-spacing-medium, --gmp-mat-spacing-small, --gmp-mat-spacing-two-extra-large, --gmp-star-rating-color, background-color, border, border-radius, color-scheme, font-size

Métodos
Heredado: addEventListener, removeEventListener

Eventos
Heredado: gmp-error, gmp-load

Interfaz AdvancedPlaceDetailsElementOptions

interfaz google.maps.places.AdvancedPlaceDetailsElementOptions extiende PlaceDetailsElementOptions
implementada por AdvancedPlaceDetailsElement

Opciones para AdvancedPlaceDetailsElement.

Propiedades
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS.

Clase AdvancedPlaceDetailsCompactElement

class google.maps.places.AdvancedPlaceDetailsCompactElement extends PlaceDetailsCompactElement, HTMLElement implements AdvancedPlaceDetailsCompactElementOptions, PlaceDetailsCompactElementOptions
library "places"

Muestra los detalles de un lugar en un diseño compacto. Agrega un PlaceDetailsPlaceRequestElement o PlaceDetailsLocationRequestElement para especificar el lugar que se renderizará. Agrega un PlaceStandardContentElement o PlaceAllContentElement, o bien especifica elementos secundarios de contenido específicos para configurar el contenido que se renderizará.

Para usar este elemento, habilita la API del kit de IU de Places en tu proyecto de la consola de Google Cloud.

<gmp-advanced-place-details-compact
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details-compact>

const {AdvancedPlaceDetailsCompactElement} = await google.maps.importLibrary("places");

Constructor
AdvancedPlaceDetailsCompactElement	AdvancedPlaceDetailsCompactElement([options]) Parámetros: options: AdvancedPlaceDetailsCompactElementOptions optional

Propiedades
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
place readonly	Tipo: Place optional Solo lectura. Es el objeto Place que contiene el ID, la ubicación y el viewport del lugar renderizado actualmente.
Heredado: orientation (attr: orientation), truncationPreferred (attr: truncation-preferred)

Ranuras
action-corner	Un horario para PlaceLinkElement y PlaceButtonElement.
action-main	Un horario para PlaceLinkElement y PlaceButtonElement.
basic-section-bottom	Aviso: Solo está disponible en el canal v=alpha. Es un espacio para el contenido HTML personalizado que se renderiza en la parte inferior de la sección de información básica, justo debajo de los botones de acción principales.
basic-section-top	Aviso: Solo está disponible en el canal v=alpha. Es un espacio para el contenido HTML personalizado que se renderiza en la sección de información básica, directamente sobre el nombre del lugar.

Propiedades de CSS

Heredados: --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-dialog-border-radius, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-label-medium, --gmp-mat-font-title-small, --gmp-mat-spacing-extra-small, --gmp-mat-spacing-large, --gmp-mat-spacing-medium, --gmp-mat-spacing-small, --gmp-star-rating-color, --gmp-thumbnail-border-radius, background-color, border, border-radius, color-scheme, font-size

Métodos
Heredado: addEventListener, removeEventListener

Eventos
Heredado: gmp-error, gmp-load

Interfaz AdvancedPlaceDetailsCompactElementOptions

interfaz google.maps.places.AdvancedPlaceDetailsCompactElementOptions extiende PlaceDetailsCompactElementOptions
implementada por AdvancedPlaceDetailsCompactElement

Opciones para AdvancedPlaceDetailsCompactElement.

Propiedades
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS.
Heredado: orientation, truncationPreferred

Constantes de PlaceDetailsOrientation

constantes google.maps.places.PlaceDetailsOrientation
biblioteca "places"

Variantes de orientación para PlaceDetailsCompactElement.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo PlaceDetailsOrientationString.

const {PlaceDetailsOrientation} = await google.maps.importLibrary("places");

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

Clase PlaceDetailsPlaceRequestElement

class google.maps.places.PlaceDetailsPlaceRequestElement extends HTMLElement implements PlaceDetailsPlaceRequestElementOptions
library "places"

Configura un PlaceDetailsCompactElement o PlaceDetailsElement para cargar datos según un objeto Place, un ID o un nombre de recurso. Agrega este elemento como elemento secundario de un PlaceDetailsCompactElement o PlaceDetailsElement para cargar datos del lugar especificado. Por ejemplo:

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
 </gmp-place-details> 

<gmp-place-details-place-request
  place="places/###">
</gmp-place-details-place-request>

const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places");

Constructor
PlaceDetailsPlaceRequestElement	PlaceDetailsPlaceRequestElement([options]) Parámetros: options: PlaceDetailsPlaceRequestElementOptions optional

Propiedades
place attr: place	Tipo de entrada: Place|string optional Tipo de salida: Place optional La configuración predeterminada es null. Es el objeto, el ID o el nombre del recurso del lugar para el que se renderizarán los detalles en el elemento Place Details Compact. Esta propiedad se refleja en el atributo como un nombre de recurso. Atributo HTML: place="places/###"

Métodos
Heredado: addEventListener, removeEventListener

Interfaz PlaceDetailsPlaceRequestElementOptions

interfaz google.maps.places.PlaceDetailsPlaceRequestElementOptions
implementada por PlaceDetailsPlaceRequestElement

Opciones para PlaceDetailsPlaceRequestElement.

Propiedades
place opcional	Tipo: Place|string optional Ver PlaceDetailsPlaceRequestElement.place

Clase PlaceDetailsLocationRequestElement

class google.maps.places.PlaceDetailsLocationRequestElement extends HTMLElement implements PlaceDetailsLocationRequestElementOptions
library "places"

Configura un PlaceDetailsCompactElement o PlaceDetailsElement para cargar datos según una ubicación. Agrega este elemento como un elemento secundario de un PlaceDetailsCompactElement o PlaceDetailsElement para cargar datos de la ubicación especificada. Por ejemplo:

 <gmp-place-details>
   <gmp-place-details-location-request
     location="37.6207665,-122.4284806"
   ></gmp-place-details-location-request>
 </gmp-place-details> 

<gmp-place-details-location-request
  location="lat,lng">
</gmp-place-details-location-request>

const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places");

Constructor
PlaceDetailsLocationRequestElement	PlaceDetailsLocationRequestElement([options]) Parámetros: options: PlaceDetailsLocationRequestElementOptions optional

Propiedades
location attr: location	Tipo de entrada: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Tipo de salida: LatLngAltitude optional La configuración predeterminada es null. Es la ubicación para la que se renderizarán los detalles en el elemento Place Details. Se normaliza a un LatLngAltitude. Atributo HTML: location="lat,lng"

Métodos
Heredado: addEventListener, removeEventListener

Interfaz PlaceDetailsLocationRequestElementOptions

interfaz google.maps.places.PlaceDetailsLocationRequestElementOptions
implementada por PlaceDetailsLocationRequestElement

Opciones para PlaceDetailsLocationRequestElement.

Propiedades
location opcional	Tipo: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Es la ubicación para la que se renderizará el lugar.

Clase PlaceSearchElement

clase google.maps.places.PlaceSearchElement extiende HTMLElement implementa PlaceSearchElementOptions
extendida por AdvancedPlaceSearchElement
biblioteca "places"

Muestra los resultados de una búsqueda de lugares en una lista. Agrega un PlaceTextSearchRequestElement o PlaceNearbySearchRequestElement para especificar la solicitud para la que se renderizarán los resultados. Agrega un PlaceContentConfigElement, PlaceStandardContentElement o PlaceAllContentElement para especificar qué contenido renderizar.

Ejemplo:

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search> 

Para usar el elemento Place Search, habilita la API del kit de IU de Places para tu proyecto en la consola de Google Cloud.

<gmp-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-place-search>

const {PlaceSearchElement} = await google.maps.importLibrary("places");

Constructor
PlaceSearchElement	PlaceSearchElement([options]) Parámetros: options: PlaceSearchElementOptions optional

Propiedades
attributionPosition attr: attribution-position	Tipo de entrada: PlaceSearchAttributionPosition optional Tipo de salida: PlaceSearchAttributionPosition La configuración predeterminada es PlaceSearchAttributionPosition.TOP. La posición del logotipo de atribución y el botón de divulgación legal. Atributo HTML: attribution-position="value-name"
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
orientation attr: orientation	Tipo de entrada: PlaceSearchOrientation optional Tipo de salida: PlaceSearchOrientation La configuración predeterminada es PlaceSearchOrientation.VERTICAL. Es la variante de orientación (vertical u horizontal) del elemento. Atributo HTML: orientation="value-name"
places readonly	Tipo: Array<Place> Solo lectura. Es un array de objetos Place que contiene los IDs, las ubicaciones y los viewports de los lugares renderizados actualmente.
selectable attr: selectable	Tipo de entrada: boolean optional Tipo de salida: boolean La configuración predeterminada es false. Indica si se pueden seleccionar los elementos de la lista. Si es verdadero, los elementos de la lista serán botones que enviarán el evento gmp-select cuando se haga clic en ellos. También se admite la navegación y la selección accesibles con el teclado. Atributo HTML: selectable
truncationPreferred attr: truncation-preferred	Tipo de entrada: boolean optional Tipo de salida: boolean La configuración predeterminada es false. Si es verdadero, trunca ciertas líneas de contenido para que quepan en una línea en lugar de ajustarse. Atributo HTML: truncation-preferred

Propiedades de CSS
--gmp-button-border-color	Es el color del borde del botón "Abrir en Maps".
--gmp-button-border-radius	Es el radio del borde del botón "Abrir en Maps".
--gmp-button-border-width	Es el ancho del borde del botón "Abrir en Maps".
--gmp-card-border-radius	Es el radio del borde de las tarjetas de lugares.
--gmp-dialog-border-radius	Es el radio del borde del diálogo de divulgación de Google Maps.
--gmp-mat-color-info	Es el color de los elementos de la IU con un sentimiento informativo. Se usa para el ícono de entrada accesible.
--gmp-mat-color-negative	Es el color de los elementos de la IU con un sentimiento negativo. Se usa para la etiqueta "Cerrado" en el horario de atención de un lugar.
--gmp-mat-color-neutral-container	Es el color del contenedor para los elementos de la IU con relleno neutro. Se usa para las insignias de fecha de las opiniones y las formas de marcador de posición de carga.
--gmp-mat-color-on-neutral-container	Es el color del texto y los íconos en un contenedor neutro. Se usa para el texto de la fecha de la opinión y el texto del error de carga.
--gmp-mat-color-on-secondary-container	Es el color del texto y de los íconos sobre un color de contenedor secundario. Se usa para el texto y los íconos de los botones.
--gmp-mat-color-on-surface	Es el color del texto y los íconos sobre un color de superficie. Se usa para encabezados y contenido de diálogos.
--gmp-mat-color-on-surface-variant	Es el color de menor énfasis para el texto y los íconos sobre un color de superficie. Se usa para obtener información sobre el lugar.
--gmp-mat-color-outline-decorative	Es el color del contorno de los elementos no interactivos. Se usa para el borde del contenedor.
--gmp-mat-color-positive	Es el color de los elementos de la IU con un sentimiento positivo. Se usa para la etiqueta "Abierto" en el horario de atención de un lugar.
--gmp-mat-color-primary	Es el color del texto y los íconos interactivos en comparación con el color de la superficie. Se usa para vínculos, el indicador de carga y los íconos de resumen.
--gmp-mat-color-secondary-container	Color de relleno menos prominente contra una superficie. Se usa para los fondos de los botones.
--gmp-mat-color-surface	Color para los fondos. Se usa para los fondos de contenedores y diálogos.
--gmp-mat-font-body-small	Se usa para obtener información sobre el lugar.
--gmp-mat-font-family	Es la familia de fuentes base para todo el texto.
--gmp-mat-font-headline-medium	Se usa para los encabezados de los diálogos.
--gmp-mat-font-label-large	Se usa para el contenido de los botones.
--gmp-mat-font-title-medium	Se usa para el nombre del lugar.
--gmp-mat-spacing-extra-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-large	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-medium	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-star-rating-color	Es el color de las estrellas completas en una calificación por estrellas.
--gmp-thumbnail-border-radius	Es el radio del borde de la imagen en miniatura 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 en qué esquema de colores 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 la escala de todo el texto y los íconos del elemento. La configuración predeterminada es 16px.

Métodos
Heredado: addEventListener, removeEventListener

Eventos
gmp-error	function(event) Argumentos: event: Event optional 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: event: Event optional Este evento se activa cuando el elemento carga y renderiza su contenido. Este evento no se propaga.
gmp-select	function(event) Argumentos: event: PlaceSelectEvent optional Este evento se activa cuando se selecciona un lugar de la lista. Contiene un objeto Place con el ID, la ubicación y el viewport del lugar seleccionado.

Interfaz PlaceSearchElementOptions

interfaz google.maps.places.PlaceSearchElementOptions
extendida por AdvancedPlaceSearchElementOptions
implementada por AdvancedPlaceSearchElement, PlaceSearchElement

Opciones para PlaceSearchElement.

Propiedades
attributionPosition opcional	Tipo: PlaceSearchAttributionPosition optional Consulta los PlaceSearchElement.attributionPosition.
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS.
orientation opcional	Tipo: PlaceSearchOrientation optional Consulta los PlaceSearchElement.orientation.
selectable opcional	Tipo: boolean optional Ver PlaceSearchElement.selectable
truncationPreferred opcional	Tipo: boolean optional Consulta los PlaceSearchElement.truncationPreferred.

Clase PlaceItemElement

clase google.maps.places.PlaceItemElement extiende HTMLElement implementa PlaceItemElementOptions
extendida por AdvancedPlaceItemElement
biblioteca "places"

Wrapper de componente web público (<gmp-place-item>) para los elementos de la lista de lugares. El elemento personalizado <gmp-place-item> renderiza una tarjeta de resultado de lugar individual dentro de <gmp-place-search>. Cada <gmp-place-item> muestra información sobre el lugar compuesta por componentes visuales secundarios del kit de IU de Places.

<gmp-place-item></gmp-place-item>

const {PlaceItemElement} = await google.maps.importLibrary("places");

Métodos
Heredado: addEventListener, removeEventListener

Interfaz PlaceItemElementOptions

interfaz google.maps.places.PlaceItemElementOptions
extendida por AdvancedPlaceItemElementOptions
implementada por AdvancedPlaceItemElement, PlaceItemElement

Opciones para PlaceItemElement.

Clase AdvancedPlaceSearchElement

class google.maps.places.AdvancedPlaceSearchElement extends PlaceSearchElement, HTMLElement implements AdvancedPlaceSearchElementOptions, PlaceSearchElementOptions
library "places"

Muestra los resultados de una búsqueda avanzada de lugares en una lista. Agrega un PlaceTextSearchRequestElement o PlaceNearbySearchRequestElement para especificar la solicitud para la que se renderizarán los resultados. Agrega un PlaceStandardContentElement, un PlaceAllContentElement o un <template slot="details-item"> para especificar qué contenido renderizar.

Ejemplo:

 <gmp-advanced-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <template slot="details-item">
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </template>
 </gmp-advanced-place-search> 

Para usar el elemento Advanced Place Search, habilita la API de kit de IU de Places en tu proyecto de la consola de Google Cloud.

<gmp-advanced-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-advanced-place-search>

const {AdvancedPlaceSearchElement} = await google.maps.importLibrary("places");

Constructor
AdvancedPlaceSearchElement	AdvancedPlaceSearchElement([options]) Parámetros: options: AdvancedPlaceSearchElementOptions optional

Propiedades
attributionPosition attr: attribution-position	Tipo de entrada: PlaceSearchAttributionPosition optional Tipo de salida: PlaceSearchAttributionPosition La configuración predeterminada es PlaceSearchAttributionPosition.TOP. La posición del logotipo de atribución y el botón de divulgación legal. Atributo HTML: attribution-position="value-name"
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
orientation attr: orientation	Tipo de entrada: PlaceSearchOrientation optional Tipo de salida: PlaceSearchOrientation La configuración predeterminada es PlaceSearchOrientation.VERTICAL. Es la variante de orientación (vertical u horizontal) del elemento. Atributo HTML: orientation="value-name"
selectable attr: selectable	Tipo de entrada: boolean optional Tipo de salida: boolean La configuración predeterminada es false. Indica si se pueden seleccionar los elementos de la lista. Si es verdadero, los elementos de la lista serán botones que enviarán el evento gmp-select cuando se haga clic en ellos. También se admite la navegación y la selección accesibles con el teclado. Atributo HTML: selectable
truncationPreferred attr: truncation-preferred	Tipo de entrada: boolean optional Tipo de salida: boolean La configuración predeterminada es false. Si es verdadero, trunca ciertas líneas de contenido para que quepan en una línea en lugar de ajustarse. Atributo HTML: truncation-preferred
Heredado: places

Ranuras
details-item	Es la plantilla HTML que contiene los widgets gmp-place que se renderizarán para cada lugar en los resultados de la búsqueda.

Propiedades de CSS
--gmp-button-border-color	Es el color del borde del botón "Abrir en Maps".
--gmp-button-border-radius	Es el radio del borde del botón "Abrir en Maps".
--gmp-button-border-width	Es el ancho del borde del botón "Abrir en Maps".
--gmp-card-border-radius	Es el radio del borde de las tarjetas de lugares.
--gmp-dialog-border-radius	Es el radio del borde del diálogo de divulgación de Google Maps.
--gmp-mat-color-info	Es el color de los elementos de la IU con un sentimiento informativo. Se usa para el ícono de entrada accesible.
--gmp-mat-color-negative	Es el color de los elementos de la IU con un sentimiento negativo. Se usa para la etiqueta "Cerrado" en el horario de atención de un lugar.
--gmp-mat-color-neutral-container	Es el color del contenedor para los elementos de la IU con relleno neutro. Se usa para las insignias de fecha de las opiniones y las formas de marcador de posición de carga.
--gmp-mat-color-on-neutral-container	Es el color del texto y los íconos en un contenedor neutro. Se usa para el texto de la fecha de la opinión y el texto del error de carga.
--gmp-mat-color-on-secondary-container	Es el color del texto y de los íconos sobre un color de contenedor secundario. Se usa para el texto y los íconos de los botones.
--gmp-mat-color-on-surface	Es el color del texto y los íconos sobre un color de superficie. Se usa para encabezados y contenido de diálogos.
--gmp-mat-color-on-surface-variant	Es el color de menor énfasis para el texto y los íconos sobre un color de superficie. Se usa para obtener información sobre el lugar.
--gmp-mat-color-outline-decorative	Es el color del contorno de los elementos no interactivos. Se usa para el borde del contenedor.
--gmp-mat-color-positive	Es el color de los elementos de la IU con un sentimiento positivo. Se usa para la etiqueta "Abierto" en el horario de atención de un lugar.
--gmp-mat-color-primary	Es el color del texto y los íconos interactivos en comparación con el color de la superficie. Se usa para vínculos, el indicador de carga y los íconos de resumen.
--gmp-mat-color-secondary-container	Color de relleno menos prominente contra una superficie. Se usa para los fondos de los botones.
--gmp-mat-color-surface	Color para los fondos. Se usa para los fondos de contenedores y diálogos.
--gmp-mat-font-body-small	Se usa para obtener información sobre el lugar.
--gmp-mat-font-family	Es la familia de fuentes base para todo el texto.
--gmp-mat-font-headline-medium	Se usa para los encabezados de los diálogos.
--gmp-mat-font-label-large	Se usa para el contenido de los botones.
--gmp-mat-font-title-medium	Se usa para el nombre del lugar.
--gmp-mat-spacing-extra-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-large	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-medium	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-star-rating-color	Es el color de las estrellas completas en una calificación por estrellas.
--gmp-thumbnail-border-radius	Es el radio del borde de la imagen en miniatura 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 en qué esquema de colores 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 la escala de todo el texto y los íconos del elemento. La configuración predeterminada es 16px.

Métodos
Heredado: addEventListener, removeEventListener

Eventos
gmp-error	function(event) Argumentos: event: Event optional 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: event: Event optional Este evento se activa cuando el elemento carga y renderiza su contenido. Este evento no se propaga.
gmp-select	function(event) Argumentos: event: PlaceSelectEvent optional Este evento se activa cuando se selecciona un lugar de la lista. Contiene un objeto Place con el ID, la ubicación y el viewport del lugar seleccionado.

Interfaz AdvancedPlaceSearchElementOptions

interfaz google.maps.places.AdvancedPlaceSearchElementOptions extiende PlaceSearchElementOptions
implementada por AdvancedPlaceSearchElement

Opciones para AdvancedPlaceSearchElement.

Propiedades
attributionPosition opcional	Tipo: PlaceSearchAttributionPosition optional Consulta los PlaceSearchElement.attributionPosition.
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS.
orientation opcional	Tipo: PlaceSearchOrientation optional Consulta los PlaceSearchElement.orientation.
selectable opcional	Tipo: boolean optional Ver PlaceSearchElement.selectable
truncationPreferred opcional	Tipo: boolean optional Consulta los PlaceSearchElement.truncationPreferred.

Clase AdvancedPlaceListElement

class google.maps.places.AdvancedPlaceListElement extends HTMLElement implements AdvancedPlaceListElementOptions
library "places"

Muestra los resultados de una búsqueda de lugares en una lista. Agrega uno o más PlaceDetailsPlaceRequestElement o establece la propiedad places para especificar los lugares que se mostrarán. Agrega un PlaceStandardContentElement o PlaceAllContentElement para especificar qué contenido renderizar.

Ejemplo:

 <gmp-advanced-place-list>
   <gmp-place-details-place-request
     place="PLACE_ID"
   </gmp-place-details-place-request>
   <template slot="details-item">
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </template>
 </gmp-advanced-place-list> 

Para usar el elemento Advanced Place List, habilita la API de kit de IU de Places en tu proyecto de la consola de Google Cloud.

<gmp-advanced-place-list
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  places="space separated strings"
  selectable
  truncation-preferred>
</gmp-advanced-place-list>

const {AdvancedPlaceListElement} = await google.maps.importLibrary("places");

Constructor
AdvancedPlaceListElement	AdvancedPlaceListElement([options]) Parámetros: options: AdvancedPlaceListElementOptions optional

Propiedades
attributionPosition attr: attribution-position	Tipo de entrada: PlaceSearchAttributionPosition optional Tipo de salida: PlaceSearchAttributionPosition La configuración predeterminada es PlaceSearchAttributionPosition.TOP. La posición del logotipo de atribución y el botón de divulgación legal. Atributo HTML: attribution-position="value-name"
internalUsageAttributionIds attr: internal-usage-attribution-ids	Tipo de entrada: Iterable<string> optional Tipo de salida: Array<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS. Atributo HTML: internal-usage-attribution-ids="space separated strings"
orientation attr: orientation	Tipo de entrada: PlaceSearchOrientation optional Tipo de salida: PlaceSearchOrientation La configuración predeterminada es PlaceSearchOrientation.VERTICAL. Es la variante de orientación (vertical u horizontal) del elemento. Atributo HTML: orientation="value-name"
places attr: places	Tipo de entrada: Iterable<Place|string> optional Tipo de salida: Array<Place> Es la lista de objetos Place que contienen los IDs que se deben mostrar en este elemento. Ten en cuenta que es posible que no se muestren todos los lugares establecidos en la propiedad places si no se pudieron renderizar(p.ej., ID no válido, error de solicitud de red, etc.). Se puede leer la propiedad places para recuperar los lugares que se muestran actualmente. Atributo HTML: places="space separated strings"
selectable attr: selectable	Tipo de entrada: boolean optional Tipo de salida: boolean La configuración predeterminada es false. Indica si se pueden seleccionar los elementos de la lista. Si es verdadero, los elementos de la lista serán botones que enviarán el evento gmp-select cuando se haga clic en ellos. También se admite la navegación y la selección accesibles con el teclado. Atributo HTML: selectable
truncationPreferred attr: truncation-preferred	Tipo de entrada: boolean optional Tipo de salida: boolean La configuración predeterminada es false. Si es verdadero, trunca ciertas líneas de contenido para que quepan en una línea en lugar de ajustarse. Atributo HTML: truncation-preferred

Ranuras
details-item	Es la plantilla HTML que contiene los widgets de gmp-place que se renderizarán para cada lugar de la lista.

Propiedades de CSS
--gmp-button-border-color	Es el color del borde del botón "Abrir en Maps".
--gmp-button-border-radius	Es el radio del borde del botón "Abrir en Maps".
--gmp-button-border-width	Es el ancho del borde del botón "Abrir en Maps".
--gmp-card-border-radius	Es el radio del borde de las tarjetas de lugares.
--gmp-dialog-border-radius	Es el radio del borde del diálogo de divulgación de Google Maps.
--gmp-mat-color-info	Es el color de los elementos de la IU con un sentimiento informativo. Se usa para el ícono de entrada accesible.
--gmp-mat-color-negative	Es el color de los elementos de la IU con un sentimiento negativo. Se usa para la etiqueta "Cerrado" en el horario de atención de un lugar.
--gmp-mat-color-neutral-container	Es el color del contenedor para los elementos de la IU con relleno neutro. Se usa para las insignias de fecha de las opiniones y las formas de marcador de posición de carga.
--gmp-mat-color-on-neutral-container	Es el color del texto y los íconos en un contenedor neutro. Se usa para el texto de la fecha de la opinión y el texto del error de carga.
--gmp-mat-color-on-secondary-container	Es el color del texto y de los íconos sobre un color de contenedor secundario. Se usa para el texto y los íconos de los botones.
--gmp-mat-color-on-surface	Es el color del texto y los íconos sobre un color de superficie. Se usa para encabezados y contenido de diálogos.
--gmp-mat-color-on-surface-variant	Es el color de menor énfasis para el texto y los íconos sobre un color de superficie. Se usa para obtener información sobre el lugar.
--gmp-mat-color-outline-decorative	Es el color del contorno de los elementos no interactivos. Se usa para el borde del contenedor.
--gmp-mat-color-positive	Es el color de los elementos de la IU con un sentimiento positivo. Se usa para la etiqueta "Abierto" en el horario de atención de un lugar.
--gmp-mat-color-primary	Es el color del texto y los íconos interactivos en comparación con el color de la superficie. Se usa para vínculos, el indicador de carga y los íconos de resumen.
--gmp-mat-color-secondary-container	Color de relleno menos prominente contra una superficie. Se usa para los fondos de los botones.
--gmp-mat-color-surface	Color para los fondos. Se usa para los fondos de contenedores y diálogos.
--gmp-mat-font-body-small	Se usa para obtener información sobre el lugar.
--gmp-mat-font-family	Es la familia de fuentes base para todo el texto.
--gmp-mat-font-headline-medium	Se usa para los encabezados de los diálogos.
--gmp-mat-font-label-large	Se usa para el contenido de los botones.
--gmp-mat-font-title-medium	Se usa para el nombre del lugar.
--gmp-mat-spacing-extra-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-large	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-medium	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-mat-spacing-small	Se usa para el espaciado dentro del elemento, como el margen y el padding alrededor del texto.
--gmp-star-rating-color	Es el color de las estrellas completas en una calificación por estrellas.
--gmp-thumbnail-border-radius	Es el radio del borde de la imagen en miniatura 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 en qué esquema de colores 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 la escala de todo el texto y los íconos del elemento. La configuración predeterminada es 16px.

Métodos
Heredado: addEventListener, removeEventListener

Eventos
gmp-error	function(event) Argumentos: event: Event optional 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: event: Event optional Este evento se activa cuando el elemento carga y renderiza su contenido. Este evento no se propaga.
gmp-select	function(event) Argumentos: event: PlaceSelectEvent optional Este evento se activa cuando se selecciona un lugar de la lista. Contiene un objeto Place con el ID, la ubicación y el viewport del lugar seleccionado.

Interfaz AdvancedPlaceListElementOptions

interfaz google.maps.places.AdvancedPlaceListElementOptions
implementada por AdvancedPlaceListElement

Opciones para AdvancedPlaceListElement.

Propiedades
attributionPosition opcional	Tipo: PlaceSearchAttributionPosition optional Consulta los PlaceSearchElement.attributionPosition.
internalUsageAttributionIds opcional	Tipo: Iterable<string> optional Son identificadores que se usan para atribuir llamadas a paquetes específicos o bibliotecas de OSS.
orientation opcional	Tipo: PlaceSearchOrientation optional Consulta los PlaceSearchElement.orientation.
places opcional	Tipo: Iterable<Place|string> optional Consulta los AdvancedPlaceListElement.places.
selectable opcional	Tipo: boolean optional Ver PlaceSearchElement.selectable
truncationPreferred opcional	Tipo: boolean optional Consulta los PlaceSearchElement.truncationPreferred.

Clase AdvancedPlaceItemElement

class google.maps.places.AdvancedPlaceItemElement extends PlaceItemElement, HTMLElement implements AdvancedPlaceItemElementOptions, PlaceItemElementOptions
library "places"

Wrapper de componente web público (<gmp-advanced-place-item>) para elementos de lista de lugares avanzados. El elemento personalizado <gmp-advanced-place-item> renderiza una tarjeta de resultado de lugar enriquecido individual dentro de un contenedor de búsqueda avanzada o de colección, como <gmp-advanced-place-search> o <gmp-advanced-place-list>. Cada <gmp-advanced-place-item> presenta detalles enriquecidos de lugares, collages de contenido multimedia, resúmenes editoriales y botones de acción interactivos compuestos por componentes visuales secundarios del kit de IU de Places.

<gmp-advanced-place-item></gmp-advanced-place-item>

const {AdvancedPlaceItemElement} = await google.maps.importLibrary("places");

Ranuras
basic-section-bottom	Aviso: Solo está disponible en el canal v=alpha. Es un espacio para el contenido HTML personalizado que se renderiza en la parte inferior de la sección de información básica, justo debajo de los botones de acción principales.
basic-section-top	Aviso: Solo está disponible en el canal v=alpha. Es un espacio para el contenido HTML personalizado que se renderiza en la sección de información básica, directamente sobre el nombre del lugar.

Métodos
Heredado: addEventListener, removeEventListener

Interfaz AdvancedPlaceItemElementOptions

interfaz google.maps.places.AdvancedPlaceItemElementOptions extiende PlaceItemElementOptions
implementada por AdvancedPlaceItemElement

Opciones para AdvancedPlaceItemElement.

Constantes de PlaceSearchAttributionPosition

constantes google.maps.places.PlaceSearchAttributionPosition
biblioteca "places"

Posiciones de atribución para PlaceSearchElement.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo PlaceSearchAttributionPositionString.

const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places");

Constantes
BOTTOM	Atribución en la parte inferior del PlaceSearchElement
TOP	Atribución en la parte superior del PlaceSearchElement

Constantes de PlaceSearchOrientation

constantes google.maps.places.PlaceSearchOrientation
biblioteca "places"

Variantes de orientación para PlaceSearchElement.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo PlaceSearchOrientationString.

const {PlaceSearchOrientation} = await google.maps.importLibrary("places");

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

Clase PlaceSelectEvent

class google.maps.places.PlaceSelectEvent extends Event
library "places"

Este evento se activa cuando se selecciona un lugar de una lista de lugares. Accede a la selección con event.place.

const {PlaceSelectEvent} = await google.maps.importLibrary("places");

Propiedades
place readonly	Tipo: Place Es el lugar seleccionado.

Clase PlaceNearbySearchRequestElement

class google.maps.places.PlaceNearbySearchRequestElement extends HTMLElement implements PlaceNearbySearchRequestElementOptions
library "places"

Configura un PlaceSearchElement para cargar resultados según una solicitud de Nearby Search. La propiedad locationRestriction es obligatoria para que se cargue el elemento de búsqueda. Se ignorarán todas las demás propiedades configuradas si no se establece locationRestriction. Agrega este elemento como un elemento secundario de un PlaceSearchElement para cargar los resultados. Por ejemplo:

 <gmp-place-search>
   <gmp-place-nearby-search-request
     location-restriction="RADIUS@LAT,LNG"
   ></gmp-place-nearby-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search> 

<gmp-place-nearby-search-request
  excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."
  excluded-types="excluded-type1 excluded-type2..."
  included-primary-types="included-primary-type1 included-primary-type2..."
  included-types="included-type1 included-type2..."
  location-restriction="radius@lat,lng"
  max-result-count="number"
  rank-preference="value-name">
</gmp-place-nearby-search-request>

const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places");

Constructor
PlaceNearbySearchRequestElement	PlaceNearbySearchRequestElement([options]) Parámetros: options: PlaceNearbySearchRequestElementOptions optional

Propiedades
excludedPrimaryTypes attr: excluded-primary-types	Tipo de entrada: Array<string> optional Tipo de salida: Array<string> optional La configuración predeterminada es null. Son los tipos de lugares principales excluidos. Atributo HTML: excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."
excludedTypes attr: excluded-types	Tipo de entrada: Array<string> optional Tipo de salida: Array<string> optional La configuración predeterminada es null. Son los tipos de lugares excluidos. Atributo HTML: excluded-types="excluded-type1 excluded-type2..."
futureOpeningBusinessesIncluded	Tipo de entrada: boolean optional Tipo de salida: boolean optional Incluye predicciones de lugares para empresas que aún no están abiertas, pero que se espera que abran en el futuro.
includedPrimaryTypes attr: included-primary-types	Tipo de entrada: Array<string> optional Tipo de salida: Array<string> optional La configuración predeterminada es null. Se incluyó el tipo de lugar principal. Atributo HTML: included-primary-types="included-primary-type1 included-primary-type2..."
includedTypes attr: included-types	Tipo de entrada: Array<string> optional Tipo de salida: Array<string> optional La configuración predeterminada es null. Es el tipo de lugar incluido. Atributo HTML: included-types="included-type1 included-type2..."
locationRestriction attr: location-restriction	Tipo de entrada: Circle|CircleLiteral optional Tipo de salida: Circle optional La configuración predeterminada es null. Es la región en la que se realizará la búsqueda. Se normaliza a un Circle. Atributo HTML: location-restriction="radius@lat,lng"
maxResultCount attr: max-result-count	Tipo de entrada: number optional Tipo de salida: number optional La configuración predeterminada es null. Cantidad máxima de resultados que se mostrarán. Atributo HTML: max-result-count="number"
rankPreference attr: rank-preference	Tipo de entrada: SearchNearbyRankPreference optional Tipo de salida: SearchNearbyRankPreference optional La configuración predeterminada es null. Cómo se clasificarán los resultados en la respuesta. Atributo HTML: rank-preference="value-name"

Métodos
Heredado: addEventListener, removeEventListener

Interfaz PlaceNearbySearchRequestElementOptions

interfaz google.maps.places.PlaceNearbySearchRequestElementOptions
implementada por PlaceNearbySearchRequestElement

Opciones para PlaceNearbySearchRequestElement.

Propiedades
excludedPrimaryTypes opcional	Tipo: Array<string> optional Son los tipos de lugares principales excluidos. Consulta PlaceNearbySearchRequestElement.excludedPrimaryTypes y SearchNearbyRequest.excludedPrimaryTypes para obtener más información.
excludedTypes opcional	Tipo: Array<string> optional Son los tipos de lugares excluidos. Consulta PlaceNearbySearchRequestElement.excludedTypes y SearchNearbyRequest.excludedTypes para obtener más información.
futureOpeningBusinessesIncluded opcional	Tipo: boolean optional Incluye predicciones de lugares para empresas que aún no están abiertas, pero que se espera que abran en el futuro.
includedPrimaryTypes opcional	Tipo: Array<string> optional Tipos de lugares principales incluidos. Consulta PlaceNearbySearchRequestElement.includedPrimaryTypes y SearchNearbyRequest.includedPrimaryTypes para obtener más información.
includedTypes opcional	Tipo: Array<string> optional Tipos de lugares incluidos Consulta PlaceNearbySearchRequestElement.includedTypes y SearchNearbyRequest.includedTypes para obtener más información.
locationRestriction opcional	Tipo: Circle|CircleLiteral optional Es la región en la que se realizará la búsqueda. Consulta PlaceNearbySearchRequestElement.locationRestriction y SearchNearbyRequest.locationRestriction para obtener más información.
maxResultCount opcional	Tipo: number optional Cantidad máxima de resultados que se mostrarán. Consulta PlaceNearbySearchRequestElement.maxResultCount y SearchNearbyRequest.maxResultCount para obtener más información.
rankPreference opcional	Tipo: SearchNearbyRankPreference optional Cómo se clasificarán los resultados en la respuesta. Consulta PlaceNearbySearchRequestElement.rankPreference y SearchNearbyRankPreference para obtener más información.

Clase PlaceTextSearchRequestElement

class google.maps.places.PlaceTextSearchRequestElement extends HTMLElement implements PlaceTextSearchRequestElementOptions
library "places"

Configura un PlaceSearchElement para cargar resultados según una solicitud de búsqueda de texto. La propiedad textQuery es obligatoria para que se cargue el elemento de búsqueda. Se ignorarán todas las demás propiedades configuradas si no se establece textQuery. Agrega este elemento como un elemento secundario de un PlaceSearchElement para cargar los resultados. Por ejemplo:

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search> 

<gmp-place-text-search-request
  ev-connector-types="ev-connector-type1 ev-connector-type2..."
  ev-minimum-charging-rate-kw="number"
  included-type="type"
  is-open-now
  location-bias="lat,lng"
  location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
  max-result-count="number"
  min-rating="number"
  price-levels="price-level1 price-level2..."
  rank-preference="value-name"
  text-query="string"
  use-strict-type-filtering>
</gmp-place-text-search-request>

const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places");

Constructor
PlaceTextSearchRequestElement	PlaceTextSearchRequestElement([options]) Parámetros: options: PlaceTextSearchRequestElementOptions optional

Propiedades
evConnectorTypes attr: ev-connector-types	Tipo de entrada: Array<EVConnectorType> optional Tipo de salida: Array<EVConnectorType> optional La configuración predeterminada es null. Es la lista de tipos de conectores de VE preferidos. Atributo HTML: ev-connector-types="ev-connector-type1 ev-connector-type2..."
evMinimumChargingRateKw attr: ev-minimum-charging-rate-kw	Tipo de entrada: number optional Tipo de salida: number optional La configuración predeterminada es null. Es la tasa de carga mínima requerida en kilovatios. Atributo HTML: ev-minimum-charging-rate-kw="number"
futureOpeningBusinessesIncluded	Tipo de entrada: boolean optional Tipo de salida: boolean optional Incluye predicciones de lugares para empresas que aún no están abiertas, pero que se espera que abran en el futuro.
includedType attr: included-type	Tipo de entrada: string optional Tipo de salida: string optional La configuración predeterminada es null. Es el tipo de lugar solicitado. Atributo HTML: included-type="type"
isOpenNow attr: is-open-now	Tipo de entrada: boolean optional Tipo de salida: boolean optional La configuración predeterminada es null. Se usa para restringir la búsqueda a los lugares que están abiertos en ese momento. Atributo HTML: is-open-now
locationBias attr: location-bias	Tipo de entrada: LocationBias optional Tipo de salida: LatLngAltitude|LatLngBounds|Circle|string optional La configuración predeterminada es null. Es la personalización de ubicación para la búsqueda. Atributo HTML: location-bias="lat,lng" location-bias="lat,lng[,altitude]" location-bias="swlat,swlng|nelat,nelng" location-bias="radius@lat,lng" location-bias="IP_BIAS"
locationRestriction attr: location-restriction	Tipo de entrada: LatLngBounds|LatLngBoundsLiteral optional Tipo de salida: LatLngBounds optional La configuración predeterminada es null. Es la restricción de ubicación para la búsqueda. Se normaliza a un LatLngBounds. Atributo HTML: location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
maxResultCount attr: max-result-count	Tipo de entrada: number optional Tipo de salida: number optional La configuración predeterminada es null. Cantidad máxima de resultados que se mostrarán. Atributo HTML: max-result-count="number"
minRating attr: min-rating	Tipo de entrada: number optional Tipo de salida: number optional La configuración predeterminada es null. Filtra los resultados cuya calificación promedio de los usuarios sea estrictamente inferior a este límite. Atributo HTML: min-rating="number"
priceLevels attr: price-levels	Tipo de entrada: Array<PriceLevel> optional Tipo de salida: Array<PriceLevel> optional La configuración predeterminada es null. Se usa para restringir la búsqueda a lugares que están marcados con ciertos niveles de precios. Atributo HTML: price-levels="price-level1 price-level2..."
rankPreference attr: rank-preference	Tipo de entrada: SearchByTextRankPreference optional Tipo de salida: SearchByTextRankPreference optional La configuración predeterminada es null. Cómo se clasificarán los resultados en la respuesta. Atributo HTML: rank-preference="value-name"
textQuery attr: text-query	Tipo de entrada: string optional Tipo de salida: string optional La configuración predeterminada es null. Es la consulta de texto para la búsqueda textual. Atributo HTML: text-query="string"
useStrictTypeFiltering attr: use-strict-type-filtering	Tipo de entrada: boolean optional Tipo de salida: boolean optional La configuración predeterminada es null. Se usa para establecer un filtrado de tipo estricto para "includedType". Atributo HTML: use-strict-type-filtering

Métodos
Heredado: addEventListener, removeEventListener

Interfaz PlaceTextSearchRequestElementOptions

interfaz google.maps.places.PlaceTextSearchRequestElementOptions
implementada por PlaceTextSearchRequestElement

Opciones para PlaceTextSearchRequestElement.

Propiedades
evConnectorTypes opcional	Tipo: Array<EVConnectorType> optional Es la lista de tipos de conectores de VE preferidos. Consulta SearchByTextRequest.evSearchOptions y PlaceTextSearchRequestElement.evConnectorTypes para obtener más información.
evMinimumChargingRateKw opcional	Tipo: number optional Es la tasa de carga mínima requerida en kilovatios. Consulta SearchByTextRequest.evSearchOptions y PlaceTextSearchRequestElement.evMinimumChargingRateKw para obtener más información.
futureOpeningBusinessesIncluded opcional	Tipo: boolean optional Incluye predicciones de lugares para empresas que aún no están abiertas, pero que se espera que abran en el futuro.
includedType opcional	Tipo: string optional Es el tipo de lugar solicitado. Consulta SearchByTextRequest.includedType y PlaceTextSearchRequestElement.includedType para obtener más información.
isOpenNow opcional	Tipo: boolean optional Se usa para restringir la búsqueda a los lugares que están abiertos en ese momento. Consulta SearchByTextRequest.isOpenNow y PlaceTextSearchRequestElement.isOpenNow para obtener más información.
locationBias opcional	Tipo: LocationBias optional Es la personalización de ubicación para la búsqueda. Consulta SearchByTextRequest.locationBias y PlaceTextSearchRequestElement.locationBias para obtener más información.
locationRestriction opcional	Tipo: LatLngBounds|LatLngBoundsLiteral optional Es la restricción de ubicación para la búsqueda. Consulta SearchByTextRequest.locationRestriction y PlaceTextSearchRequestElement.locationRestriction para obtener más información.
maxResultCount opcional	Tipo: number optional Cantidad máxima de resultados que se mostrarán. Consulta SearchByTextRequest.maxResultCount y PlaceTextSearchRequestElement.maxResultCount para obtener más información.
minRating opcional	Tipo: number optional Filtra los resultados cuya calificación promedio de los usuarios sea estrictamente inferior a este límite. Consulta SearchByTextRequest.minRating y PlaceTextSearchRequestElement.minRating para obtener más información.
priceLevels opcional	Tipo: Array<PriceLevel> optional Se usa para restringir la búsqueda a lugares que están marcados con ciertos niveles de precios. Consulta SearchByTextRequest.priceLevels y PlaceTextSearchRequestElement.priceLevels para obtener más información.
rankPreference opcional	Tipo: SearchByTextRankPreference optional Cómo se clasificarán los resultados en la respuesta. Consulta SearchByTextRequest.rankPreference y PlaceTextSearchRequestElement.rankPreference para obtener más información.
textQuery opcional	Tipo: string optional Es la consulta de texto para la búsqueda textual. Consulta SearchByTextRequest.textQuery y PlaceTextSearchRequestElement.textQuery para obtener más información.
useStrictTypeFiltering opcional	Tipo: boolean optional Se usa para establecer un filtrado de tipo estricto para SearchByTextRequest.includedType. Consulta SearchByTextRequest.useStrictTypeFiltering y PlaceTextSearchRequestElement.useStrictTypeFiltering para obtener más información.

Clase Autocomplete

class google.maps.places.Autocomplete extends MVCObject
library "places"

Obsoleto: A partir del 1 de marzo de 2025, google.maps.places.Autocomplete no estará disponible para clientes nuevos. Utilice PlaceAutocompleteElement en su lugar. En este momento, no está previsto descontinuar google.maps.places.Autocomplete, pero se recomienda usar PlaceAutocompleteElement en lugar de google.maps.places.Autocomplete. Si bien google.maps.places.Autocomplete seguirá recibiendo correcciones de errores para cualquier regresión importante, no se abordarán los errores existentes en google.maps.places.Autocomplete. Se enviará una notificación al menos 12 meses antes de descontinuar la asistencia técnica. Consulta https://developers.google.com/maps/legacy para obtener más detalles y https://developers.google.com/maps/documentation/javascript/places-migration-overview para acceder a la guía de migración.

Es un widget que proporciona predicciones de lugares según 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.

const {Autocomplete} = await google.maps.importLibrary("places");

Constructor
Autocomplete	Autocomplete(inputField[, opts]) Parámetros: inputField: HTMLInputElement: Es el campo de texto <input> al que se debe adjuntar el Autocomplete. opts: AutocompleteOptions optional Opciones. Crea una instancia nueva de Autocomplete que se adjunta al campo de texto de entrada especificado con las opciones dadas.

Métodos
getBounds	getBounds() Parámetros: Ninguno Valor de retorno: LatLngBounds|undefined Los límites de sesgo. Devuelve los límites hacia los que se sesgan las predicciones.
getFields	getFields() Parámetros: Ninguno Valor de retorno: 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 campos, consulta PlaceResult.
getPlace	getPlace() Parámetros: Ninguno Valor de retorno: PlaceResult El lugar que seleccionó el usuario. Devuelve los detalles del lugar que seleccionó el usuario si se recuperaron correctamente. De lo contrario, devuelve un objeto Place de stub, con la propiedad name establecida en el valor actual del campo de entrada.
setBounds	setBounds(bounds) Parámetros: bounds: LatLngBounds|LatLngBoundsLiteral optional: Son los límites de sesgo. Valor de retorno: Ninguno Establece el área preferida dentro de la cual se deben mostrar los resultados de Place. Los resultados tienen un sesgo hacia, aunque no se restringen a, esta área.
setComponentRestrictions	setComponentRestrictions(restrictions) Parámetros: restrictions: ComponentRestrictions optional: Son las restricciones que se usarán. Valor de retorno: Ninguno Establece las restricciones de componentes. Las restricciones de componentes se usan para limitar las predicciones solo a aquellas que se encuentran dentro del componente superior. Por ejemplo, el país.
setFields	setFields(fields) Parámetros: fields: Array<string> optional Valor de retorno: Ninguno Establece los campos que se incluirán para el lugar en la respuesta de detalles cuando estos se recuperen correctamente. Para obtener una lista de campos, consulta PlaceResult.
setOptions	setOptions(options) Parámetros: options: AutocompleteOptions optional Valor de retorno: Ninguno
setTypes	setTypes(types) Parámetros: types: Array<string> optional 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 especifica ningún tipo, se devolverán todos los tipos.
Heredados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Eventos
place_changed	function() Argumentos: Ninguno Este evento se activa cuando un PlaceResult está disponible para un lugar que el usuario seleccionó. 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, PlaceResult contiene la entrada del usuario en la propiedad name, sin otras propiedades definidas.

Interfaz AutocompleteOptions

interfaz google.maps.places.AutocompleteOptions

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

Propiedades
bounds opcional	Tipo: LatLngBounds|LatLngBoundsLiteral optional Es el área en la que se buscarán lugares.
componentRestrictions opcional	Tipo: ComponentRestrictions optional Las restricciones de los componentes. Las restricciones de componentes se usan para limitar las predicciones solo a aquellas que se encuentran dentro del componente superior. Por ejemplo, el país.
fields opcional	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 en las 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"). El valor predeterminado es ['ALL'].
placeIdOnly opcional	Obsoleto: placeIdOnly dejó de estar disponible el 15 de enero de 2019 y se desactivará el 15 de enero de 2020. Usa AutocompleteOptions.fields en su lugar: fields: ['place_id', 'name', 'types']. Tipo: boolean optional Indica si se deben recuperar solo los IDs de lugar. El PlaceResult que se pone a disposición cuando se activa el evento place_changed solo tendrá los campos ID de lugar, types y name, con los valores de ID de lugar, types y description que devuelve el servicio de Autocomplete. Está inhabilitado de forma predeterminada.
strictBounds opcional	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 consulta. Si configuras strictBounds como false (que es el valor predeterminado), la personalización de resultados se inclinará, aunque no de manera exclusiva, hacia los lugares contenidos dentro de los límites.
types opcional	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 especifica ningún tipo, se devolverán todos los tipos.

Clase SearchBox

class google.maps.places.SearchBox extends MVCObject
library "places"

Obsoleto: A partir del 1 de marzo de 2025, google.maps.places.SearchBox no estará disponible para clientes nuevos. Por el momento, no está previsto descontinuar google.maps.places.SearchBox, y se seguirán proporcionando correcciones de errores para cualquier regresión importante. Se enviará una notificación al menos 12 meses antes de descontinuar la asistencia técnica. Consulta https://developers.google.com/maps/legacy para obtener más detalles.

Es un widget que proporciona predicciones de consultas 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.

const {SearchBox} = await google.maps.importLibrary("places");

Constructor
SearchBox	SearchBox(inputField[, opts]) Parámetros: inputField: HTMLInputElement opts: SearchBoxOptions optional Crea una instancia nueva de SearchBox que se adjunta al campo de texto de entrada especificado con las opciones dadas.

Métodos
getBounds	getBounds() Parámetros: Ninguno Valor de retorno: LatLngBounds|undefined Muestra los límites hacia los que se sesgan las predicciones de búsqueda.
getPlaces	getPlaces() Parámetros: Ninguno Valor de retorno: Array<PlaceResult>|undefined Muestra la búsqueda que seleccionó el usuario para usarla con el evento places_changed.
setBounds	setBounds(bounds) Parámetros: bounds: LatLngBounds|LatLngBoundsLiteral optional Valor de retorno: Ninguno Establece la región que se usará para sesgar las predicciones de búsqueda. Los resultados solo se sesgarán hacia esta área y no se restringirán por completo a ella.
Heredados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Eventos
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 SearchBoxOptions

interfaz google.maps.places.SearchBoxOptions

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

Propiedades
bounds opcional	Tipo: LatLngBounds|LatLngBoundsLiteral optional Es el área hacia la que se deben sesgar las predicciones de la búsqueda. Las predicciones tienen sesgo hacia, aunque no se restringen a, las consultas orientadas a estos límites.

Clase PlaceContextualElement

class google.maps.places.PlaceContextualElement extends HTMLElement implements PlaceContextualElementOptions
library "places"

Aviso: Solo está disponible en el canal v=alpha.

Un widget que usa el token de contexto para mostrar una vista contextual de la respuesta de la Fundamentación con Google Maps.

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

const {PlaceContextualElement} = await google.maps.importLibrary("places");

Constructor
PlaceContextualElement	PlaceContextualElement([options]) Parámetros: options: PlaceContextualElementOptions optional

Propiedades
contextToken attr: context-token	Tipo de entrada: string optional Tipo de salida: string optional Es el token de contexto. Atributo HTML: context-token="string"

Métodos
Heredado: addEventListener, removeEventListener

Interfaz PlaceContextualElementOptions

interfaz google.maps.places.PlaceContextualElementOptions
implementada por PlaceContextualElement

Aviso: Solo está disponible en el canal v=alpha.

Opciones para PlaceContextualElement.

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

Clase PlaceContextualListConfigElement

class google.maps.places.PlaceContextualListConfigElement extends HTMLElement implements PlaceContextualListConfigElementOptions
library "places"

Aviso: Solo está disponible en el canal v=alpha.

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

<gmp-place-contextual-list-config
  layout="value-name"
  map-hidden>
</gmp-place-contextual-list-config>

const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places");

Constructor
PlaceContextualListConfigElement	PlaceContextualListConfigElement([options]) Parámetros: options: PlaceContextualListConfigElementOptions optional

Propiedades
layout attr: layout	Tipo de entrada: PlaceContextualListLayout optional Tipo de salida: PlaceContextualListLayout El diseño Atributo HTML: layout="value-name"
mapHidden attr: map-hidden	Tipo de entrada: boolean optional Tipo de salida: boolean Indica si el mapa está oculto. Atributo HTML: map-hidden

Métodos
Heredado: addEventListener, removeEventListener

Interfaz PlaceContextualListConfigElementOptions

interfaz google.maps.places.PlaceContextualListConfigElementOptions
implementada por PlaceContextualListConfigElement

Aviso: Solo está disponible en el canal v=alpha.

Opciones para PlaceContextualListConfigElement.

Propiedades
layout opcional	Tipo: PlaceContextualListLayout optional La configuración predeterminada es PlaceContextualListLayout.VERTICAL. El diseño
mapHidden opcional	Tipo: boolean optional La configuración predeterminada es false. Es verdadero si se debe ocultar el mapa.

Constantes de PlaceContextualListLayout

constantes google.maps.places.PlaceContextualListLayout
biblioteca "places"

Aviso: Solo está disponible en el canal v=alpha.

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

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo PlaceContextualListLayoutString.

const {PlaceContextualListLayout} = await google.maps.importLibrary("places");

Constantes
COMPACT	Diseño de lista compacta: 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 PlacePinElement

class google.maps.places.PlacePinElement extends HTMLElement implements PlacePinElementOptions
library "places"

Aviso: Solo está disponible en el canal v=alpha.

Muestra un marcador de mapa para un lugar, con el ícono de categoría o la foto del lugar. Agrega un PlaceDetailsPlaceRequestElement o PlaceDetailsLocationRequestElement para especificar el lugar. Usa el pin como el contenido de un AdvancedMarkerElement. No se admite en mapas 3D.

Ejemplo:

 <gmp-advanced-marker>
   <gmp-place-pin>
     <gmp-place-details-place-request
       place="PLACE_ID"
     ></gmp-place-details-place-request>
     <gmp-place-rating></gmp-place-rating>
   </gmp-place-pin>
 </gmp-advanced-marker> 

Para usar este elemento, habilita la API del kit de IU de Places para tu proyecto en la consola de Google Cloud.

<gmp-place-pin
  icon="value-name"
  scale="number">
</gmp-place-pin>

const {PlacePinElement} = await google.maps.importLibrary("places");

Constructor
PlacePinElement	PlacePinElement([options]) Parámetros: options: PlacePinElementOptions optional

Propiedades
icon attr: icon	Tipo de entrada: PlacePinIcon optional Tipo de salida: PlacePinIcon La configuración predeterminada es PlacePinIcon.TYPE. Es el ícono que se muestra dentro del pin. Consulta los PlacePinIcon. Atributo HTML: icon="value-name"
photoRendered readonly	Tipo: boolean Solo lectura. Es verdadero si el pin muestra la foto del lugar. Siempre es falso si icon no es PHOTO. Si icon es PHOTO, pero el lugar no tiene foto o esta no se cargó, el valor es falso y el pin muestra el ícono del tipo de lugar. Se establece antes de que se active gmp-load.
place readonly	Tipo: Place optional Solo lectura. Es el objeto Place que contiene el ID, la ubicación y el viewport del lugar renderizado actualmente. undefined si el lugar aún no se cargó o no se pudo cargar.
scale attr: scale	Tipo de entrada: number optional Tipo de salida: number La configuración predeterminada es 1. Es el multiplicador de tamaño del pin. Atributo HTML: scale="number"

Ranuras
default	Es el contenido opcional que se muestra en el pin, como un PlaceRatingElement, un <span> personalizado o texto. Los elementos secundarios del DOM de luz se insertan directamente en el marcador. La ubicación en la que se muestra el contenido depende de icon: junto al ícono de tipo de lugar para TYPE, como una insignia en la foto para PHOTO y como el contenido principal del pin para NONE.

Propiedades de CSS
--gmp-background	Color de fondo del pin: la píldora, el marco de la foto, la insignia de la foto, el pico y el borde del pin de tipo de lugar.
--gmp-border-radius	Es el radio del borde de la píldora (ícono de tipo de lugar con contenido de ranura o solo contenido de ranura) y del marco de fotos en los pines de PHOTO. El valor predeterminado es 30px para un ícono de tipo de lugar con contenido de ranura, 12px solo para el contenido de ranura y un marco de fotos de 12px. No se aplica al pin de tipo de lugar sin contenido con espacio.
--gmp-glyph-background	Es el color de fondo detrás del glifo del tipo de lugar. El valor predeterminado es el iconBackgroundColor del lugar.
--gmp-glyph-color	Es el color del glifo del tipo de lugar. Se aplica cada vez que se muestra el glifo, incluso cuando un pin de PHOTO recurre al ícono de tipo de lugar.

Métodos
Heredado: addEventListener, removeEventListener

Eventos
gmp-error	function(event) Argumentos: event: Event optional Este evento se activa cuando el pin no se puede renderizar, por ejemplo, debido a una falla de red, una falla de credenciales (como una clave de API incorrecta), un ID de lugar que no se puede resolver o un lugar sin ubicación. El pin está oculto. Este evento no se propaga.
gmp-load	function(event) Argumentos: event: Event optional Este evento se activa una vez que se cargan los detalles del lugar y se renderiza el pin. Cuando icon es PHOTO, se activa solo después de que la foto se haya cargado o haya fallado. Un error de foto por sí solo no activa gmp-error. Lee el lugar cargado desde PlacePinElement.place y si la foto se muestra desde PlacePinElement.photoRendered. Este evento no se propaga.

Interfaz PlacePinElementOptions

interfaz google.maps.places.PlacePinElementOptions
implementada por PlacePinElement

Aviso: Solo está disponible en el canal v=alpha.

Opciones para construir un PlacePinElement.

Propiedades
icon opcional	Tipo: PlacePinIcon optional Consulta los PlacePinElement.icon.
scale opcional	Tipo: number optional Consulta los PlacePinElement.scale.

Constantes de PlacePinIcon

constantes google.maps.places.PlacePinIcon
biblioteca "places"

Aviso: Solo está disponible en el canal v=alpha.

Opciones de ícono para PlacePinElement. TYPE es el valor predeterminado. Si faltan los datos necesarios para el ícono seleccionado, el pin recurre a TYPE. Si faltan los datos necesarios para TYPE, se muestra un ícono genérico en su lugar.

Estas constantes también se pueden usar como cadenas. En TypeScript, los literales de cadena se definen con el tipo PlacePinIconString.

const {PlacePinIcon} = await google.maps.importLibrary("places");

Constantes
NONE	No muestra ningún ícono, solo el contenido de la ranura.
PHOTO	Muestra la foto del lugar en un círculo. Recurre a TYPE si el lugar no tiene foto.
TYPE	Muestra el ícono de la categoría del lugar.