Autocomplete Data

Clase AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion clase
biblioteca "places"

Es un resultado de sugerencia de Autocomplete.

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

Métodos estáticos

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Parámetros: autocompleteRequest: AutocompleteRequest Valor de retorno: Promise<{suggestions:Array<AutocompleteSuggestion>}> Recupera una lista de AutocompleteSuggestions. Si se proporciona un AutocompleteRequest.sessionToken en la solicitud, ese token de sesión se incluirá automáticamente cuando se llame a Place.fetchFields por primera vez, en cada Place que devuelva PlacePrediction.toPlace en los PlacePrediction resultantes.

Propiedades

placePrediction readonly

Tipo: PlacePrediction optional Contiene el nombre legible por humanos del resultado que se muestra. En el caso de los resultados de establecimientos, suele ser el nombre y la dirección de la empresa. Si se proporcionó un AutocompleteRequest.sessionToken en la AutocompleteRequest que se usó para recuperar esta AutocompleteSuggestion, se incluirá automáticamente el mismo token cuando se llame a Place.fetchFields por primera vez en el Place que se devuelva con una llamada a PlacePrediction.toPlace.

Interfaz AutocompleteRequest

Interfaz google.maps.places.AutocompleteRequest

Es la interfaz de solicitud para AutocompleteSuggestion.fetchAutocompleteSuggestions.

Propiedades
input	Tipo: string Es la cadena de texto en la que se realizará la búsqueda.
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 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.
includedRegionCodes opcional	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.
inputOffset opcional	Tipo: number optional Es un desplazamiento de caracteres Unicode basado en cero de input que indica la posición del cursor en input. La posición del cursor puede influir en las predicciones que se devuelven. Si no se especifica, el valor predeterminado es la longitud de input.
language opcional	Tipo: string optional Es el idioma en el que se devolverán los resultados. Se establecerá de forma predeterminada en la preferencia de idioma del navegador. Los resultados pueden estar en varios idiomas si el idioma que se usa en input es diferente de language o si el lugar que se devuelve no tiene una traducción del idioma local a language.
locationBias opcional	Tipo: LocationBias optional Personaliza los resultados según una ubicación específica. Se debe establecer como máximo uno de los valores locationBias o locationRestriction. Si no se establece ninguno, los resultados se personalizarán según la dirección IP, lo que significa que la dirección IP se asignará a una ubicación imprecisa y se usará como indicador de personalización.
locationRestriction opcional	Tipo: LocationRestriction optional Restringe los resultados a una ubicación específica. Se debe establecer como máximo uno de los valores locationBias o locationRestriction. Si no se establece ninguno, los resultados se personalizarán según la dirección IP, lo que significa que la dirección IP se asignará a una ubicación imprecisa y se usará como indicador de personalización.
origin opcional	Tipo: LatLng|LatLngLiteral optional Es el punto de origen desde el que se calcula la distancia geodésica hasta el destino (se devuelve como PlacePrediction.distanceMeters). Si se omite este valor, no se devolverá la distancia geodésica.
pureServiceAreaBusinessesIncluded opcional	Tipo: boolean optional Incluye empresas exclusivamente de servicio en el área si el campo se establece en verdadero. Una empresa exclusivamente de servicio en el área es una empresa que visita a los clientes o les entrega sus productos directamente, pero que no los atiende en su dirección comercial. Por ejemplo, es posible que las empresas de servicios de limpieza o de plomería no tengan una dirección física o una ubicación en Google Maps.
region opcional	Tipo: string optional Es el código de región, especificado como un código de región de dos caracteres del CLDR. Esto afecta el formato de la dirección, la clasificación de los resultados y puede influir en los resultados que se devuelven. Esto no restringe los resultados a la región especificada.
sessionToken opcional	Tipo: AutocompleteSessionToken optional Es un token que identifica una sesión de Autocomplete para fines de facturación. Genera un token de sesión nuevo a través de AutocompleteSessionToken. La sesión se inicia cuando el usuario comienza a escribir una consulta y termina cuando selecciona un lugar y llama a Place.fetchFields. Cada sesión puede tener varias búsquedas, seguidas de una llamada a fetchFields. Las credenciales que se usan para cada solicitud dentro de una sesión deben pertenecer al mismo proyecto de la consola de Google Cloud. Una vez que finaliza la sesión, el token deja de ser válido. Tu app debe generar un token nuevo para cada sesión. Si se omite el parámetro sessionToken, o si reutilizas un token de sesión, la sesión se cobrará como si no se hubiera proporcionado un token de sesión (cada solicitud se factura por separado). Cuando se proporciona un token de sesión en la solicitud a AutocompleteSuggestion.fetchAutocompleteSuggestions, el mismo token se incluirá automáticamente en la primera llamada a fetchFields en un Place que se devuelve llamando a PlacePrediction.toPlace en uno de los AutocompleteSuggestions resultantes. Te recomendamos que sigas estos lineamientos: Usa tokens de sesión para todas las llamadas de Place Autocomplete. Genera un token nuevo para cada sesión. Asegúrate de pasar un token de sesión único para cada sesión nueva. Usar el mismo token en más de una sesión hará que cada solicitud se facture de forma individual.

Clase AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken clase
biblioteca "places"

Representa un token de sesión que se usa para hacer un seguimiento de una sesión de autocompletado.

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

Constructor
AutocompleteSessionToken	AutocompleteSessionToken() Parámetros: Ninguno Crea una instancia nueva de AutocompleteSessionToken.

Clase PlacePrediction

google.maps.places.PlacePrediction clase
biblioteca "places"

Son los resultados de una predicción de Place Autocomplete.

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

Propiedades
distanceMeters readonly	Tipo: number optional Es la longitud de la geodésica en metros desde origin si se especifica origin.
mainText readonly	Tipo: FormattableText optional Representa el nombre del lugar.
placeId readonly	Tipo: string Es el identificador único del lugar sugerido. Este identificador se puede usar en otras APIs que acepten IDs de lugar.
secondaryText readonly	Tipo: FormattableText optional Representa atributos de desambiguación adicionales (como una ciudad o región) para identificar mejor el lugar.
text readonly	Tipo: FormattableText Contiene el nombre legible por humanos del resultado que se muestra. En el caso de los resultados de establecimientos, suele ser el nombre y la dirección de la empresa. Se recomienda text para los desarrolladores que quieran mostrar un solo elemento de la IU. Los desarrolladores que quieran mostrar dos elementos de la IU separados, pero relacionados, pueden usar PlacePrediction.mainText y PlacePrediction.secondaryText en su lugar.
types readonly	Tipo: Array<string> Es la lista de tipos que se aplican a este lugar de la tabla A o la tabla B en https://developers.google.com/maps/documentation/places/web-service/place-types.

Métodos
fetchAddressValidation	Aviso: Solo está disponible en el canal beta. fetchAddressValidation(request) Parámetros: request: AddressValidationRequest Valor de retorno: Promise<AddressValidation> Envía una solicitud de Address Validation asociada con esta sesión de Autocomplete (completando internamente la solicitud con el token de sesión de Autocomplete). No se incluye automáticamente ninguna información de lugar de PlacePrediction. Este es un método conveniente para ayudar con la administración de sesiones de Autocomplete.
toPlace	toPlace() Parámetros: Ninguno Valor de retorno: Place Devuelve una representación de Place de este PlacePrediction. Se requiere una llamada posterior a Place.fetchFields para obtener los detalles completos del lugar. Si se proporcionó un AutocompleteRequest.sessionToken en el AutocompleteRequest que se usó para recuperar esta PlacePrediction, se incluirá automáticamente el mismo token cuando se llame a fetchFields. Como alternativa, cuando uses PlaceAutocompleteElement, la primera llamada a Place.fetchFields en un Place que devuelva PlacePrediction.toPlace incluirá automáticamente el token de sesión.

Clase StringRange

google.maps.places.StringRange clase
biblioteca "places"

Identifica una subcadena dentro de un texto determinado.

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

Propiedades
endOffset readonly	Tipo: number Es el desplazamiento basado en cero del último carácter Unicode de la subcadena (exclusivo).
startOffset readonly	Tipo: number Es el desplazamiento basado en cero del primer carácter Unicode de la subcadena (inclusive).

Clase FormattableText

google.maps.places.FormattableText clase
biblioteca "places"

Texto que representa una predicción de lugar. El texto se puede usar tal como está o con formato.

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

Propiedades
matches readonly	Tipo: Array<StringRange> Es una lista de rangos de cadenas que identifican dónde coincidió la solicitud de entrada en FormattableText.text. Los rangos se pueden usar para dar formato a partes específicas de text. Es posible que las subcadenas no sean coincidencias exactas de AutocompleteRequest.input si la coincidencia se determinó con criterios distintos de la coincidencia de cadenas (por ejemplo, correcciones ortográficas o transliteraciones). Estos valores son desplazamientos de caracteres Unicode de FormattableText.text. Se garantiza que los rangos se ordenen en valores de desplazamiento crecientes.
text readonly	Tipo: string Texto que se puede usar tal como está o con formato de FormattableText.matches.