Places Service

Clase PlacesService

Clase google.maps.places.PlacesService

Contiene métodos relacionados con la búsqueda de lugares y la recuperación de detalles sobre un lugar.

Llama al const {PlacesService} = await google.maps.importLibrary("places") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
PlacesService
PlacesService(attrContainer)
Parámetros: 
Crea una instancia nueva de PlacesService que renderiza atribuciones en el contenedor especificado.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parámetros: 
Valor de retorno: Ninguno
Recupera una lista de lugares según un número de teléfono. En la mayoría de los casos, solo debería haber un elemento en la lista de resultados. Sin embargo, si la solicitud es ambigua, es posible que se muestre más de un resultado. Los PlaceResult que se pasan a la devolución de llamada son subconjuntos de un PlaceResult completo. Tu app puede obtener un objeto PlaceResult más detallado para cada lugar llamando a PlacesService.getDetails y pasando el objeto PlaceResult.place_id para el lugar deseado.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parámetros: 
Valor de retorno: Ninguno
Recupera una lista de lugares según una cadena de búsqueda. En la mayoría de los casos, solo debería haber un elemento en la lista de resultados. Sin embargo, si la solicitud es ambigua, es posible que se muestre más de un resultado. Los PlaceResult que se pasan a la devolución de llamada son subconjuntos de un PlaceResult completo. Tu app puede obtener un objeto PlaceResult más detallado para cada lugar llamando a PlacesService.getDetails y pasando el objeto PlaceResult.place_id para el lugar deseado.
getDetails
getDetails(request, callback)
Parámetros: 
Valor de retorno: Ninguno
Recupera detalles sobre el lugar identificado por el placeId determinado.
nearbySearch
nearbySearch(request, callback)
Parámetros: 
Valor de retorno: Ninguno
Recupera una lista de lugares cercanos a una ubicación en particular, según la palabra clave o el tipo. Siempre se debe especificar la ubicación, ya sea pasando un parámetro LatLngBounds o los parámetros location y radius. Los PlaceResult que se pasan a la devolución de llamada son subconjuntos del PlaceResult completo. Tu app puede obtener un objeto PlaceResult más detallado para cada lugar si envía una solicitud de Place Details que pase el objeto PlaceResult.place_id del lugar deseado. El objeto PlaceSearchPagination se puede usar para recuperar páginas adicionales de resultados (es nulo si esta es la última página de resultados o si solo hay una página de resultados).
textSearch
textSearch(request, callback)
Parámetros: 
Valor de retorno: Ninguno
Recupera una lista de lugares según una cadena de búsqueda (por ejemplo, "pizza en Nueva York" o "tiendas de zapatos cerca de Ottawa"). Los parámetros de ubicación son opcionales. Cuando se especifica la ubicación, los resultados solo se sesgan hacia los resultados cercanos en lugar de restringirse a los lugares dentro del área. Usa textSearch cuando quieras buscar lugares con una cadena arbitraria y en los casos en los que no quieras restringir los resultados de la búsqueda a una ubicación en particular. El objeto PlaceSearchPagination se puede usar para recuperar páginas adicionales de resultados (es nulo si esta es la última página de resultados o si solo hay una página de resultados).

Interfaz de PlaceDetailsRequest

Interfaz de google.maps.places.PlaceDetailsRequest

Es una consulta de Place Details que se enviará a PlacesService.
placeId
Tipo:  string
Es el ID del lugar para el que se solicitan detalles.
fields optional
Tipo:  Array<string> optional
Son los campos que se incluirán en la respuesta de detalles, por los que se facturará. Si no se especifican campos o se pasa ['ALL'], se mostrarán y se facturarán todos los campos disponibles (esto no se recomienda para las implementaciones de producción). Para obtener una lista de los campos, consulta PlaceResult. Los campos anidados se pueden especificar con rutas de acceso con puntos (por ejemplo, "geometry.location").
language optional
Tipo:  string optional
Es un identificador del idioma en el que se deben mostrar los detalles. Consulta la lista de idiomas compatibles.
region optional
Tipo:  string optional
Es el código de región del usuario. Esto puede afectar las fotos que se muestran y, posiblemente, otros elementos. El código de región acepta un valor de ccTLD ("dominio de nivel superior") de dos caracteres. La mayoría de los códigos ccTLD son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD del Reino Unido es "uk" (.co.uk), mientras que su código ISO 3166-1 es "gb" (técnicamente para la entidad de "El Reino Unido de Gran Bretaña e Irlanda del Norte").
sessionToken optional
Tipo:  AutocompleteSessionToken optional
Es una referencia única que se usa para agrupar la solicitud de detalles con una sesión de Autocomplete.

Interfaz FindPlaceFromPhoneNumberRequest

Interfaz de google.maps.places.FindPlaceFromPhoneNumberRequest

Es una solicitud de búsqueda de lugar a partir de texto que se enviará a PlacesService.findPlaceFromPhoneNumber.
fields
Tipo:  Array<string>
Campos que se incluirán en la respuesta, por los que se facturará. Si se pasa ['ALL'], se mostrarán y se facturarán todos los campos disponibles (esto no se recomienda para las implementaciones de producción). Para obtener una lista de los campos, consulta PlaceResult. Los campos anidados se pueden especificar con rutas de acceso con puntos (por ejemplo, "geometry.location").
phoneNumber
Tipo:  string
Número de teléfono del lugar que se buscará. El formato debe ser E.164.
language optional
Tipo:  string optional
Es un identificador de idioma para el idioma en el que se deben mostrar los nombres y las direcciones, cuando sea posible. Consulta la lista de idiomas compatibles.
locationBias optional
Tipo:  LocationBias optional
Es el sesgo que se usa cuando se busca un lugar. El resultado se personalizará, aunque no de manera exclusiva, según el LocationBias proporcionado.

Interfaz FindPlaceFromQueryRequest

Interfaz de google.maps.places.FindPlaceFromQueryRequest

Es una solicitud de búsqueda de lugar a partir de texto que se enviará a PlacesService.findPlaceFromQuery.
fields
Tipo:  Array<string>
Campos que se incluirán en la respuesta, por los que se facturará. Si se pasa ['ALL'], se mostrarán y se facturarán todos los campos disponibles (esto no se recomienda para las implementaciones de producción). Para obtener una lista de los campos, consulta PlaceResult. Los campos anidados se pueden especificar con rutas de acceso con puntos (por ejemplo, "geometry.location").
query
Tipo:  string
Es la búsqueda de la solicitud. Por ejemplo, el nombre o la dirección de un lugar.
language optional
Tipo:  string optional
Es un identificador de idioma para el idioma en el que se deben mostrar los nombres y las direcciones, cuando sea posible. Consulta la lista de idiomas compatibles.
locationBias optional
Tipo:  LocationBias optional
Es el sesgo que se usa cuando se busca un lugar. El resultado se personalizará, aunque no de manera exclusiva, según el LocationBias proporcionado.

Interfaz PlaceSearchRequest

Interfaz de google.maps.places.PlaceSearchRequest

Es una búsqueda de lugar que se enviará a PlacesService.
bounds optional
Son los límites dentro de los cuales se buscarán lugares. Se ignorarán location y radius si se establece bounds.
keyword optional
Tipo:  string optional
Es un término para el que se buscarán coincidencias con todos los campos disponibles, incluidos, sin limitaciones, el nombre, el tipo y la dirección, así como las opiniones de los clientes y otro contenido de terceros.
language optional
Tipo:  string optional
Es un identificador de idioma para el idioma en el que se deben mostrar los nombres y las direcciones, cuando sea posible. Consulta la lista de idiomas compatibles.
location optional
Tipo:  LatLng|LatLngLiteral optional
Ubicación alrededor de la cual se buscarán lugares.
maxPriceLevel optional
Tipo:  number optional
Restringe los resultados a los lugares que se encuentran en el nivel de precios especificado o inferior. Los valores válidos se encuentran en el rango que varía de 0 (más asequible) a 4 (más costoso), inclusive. Debe ser mayor o igual que minPrice , si se especifica.
minPriceLevel optional
Tipo:  number optional
Restringe los resultados solo a los lugares que se encuentran en el nivel de precios especificado o superior. Los valores válidos se encuentran en el rango que varía de 0 (más asequible) a 4 (más costoso), inclusive. Debe ser menor o igual que maxPrice, si se especifica.
name optional
Tipo:  string optional
Equivale a keyword. Los valores de este campo se combinan con los del campo keyword y se pasan como parte de la misma cadena de búsqueda.
openNow optional
Tipo:  boolean optional
Restringe los resultados solo a los lugares que están abiertos en este momento.
radius optional
Tipo:  number optional
Es la distancia desde la ubicación proporcionada dentro de la cual se buscarán lugares, en metros. El valor máximo permitido es 50,000.
rankBy optional
Tipo:  RankBy optional
Predeterminado: RankBy.PROMINENCE
Especifica el método de clasificación que se usará cuando se devuelvan los resultados. Ten en cuenta que, cuando rankBy se configura como DISTANCE, debes especificar un location, pero no puedes especificar un radius o bounds.
type optional
Tipo:  string optional
Busca lugares del tipo especificado. El tipo se traduce al idioma local de la ubicación objetivo de la solicitud y se usa como una cadena de consulta. Si también se proporciona una búsqueda, se concatena con la cadena de tipo localizada. Los resultados de un tipo diferente se descartan de la respuesta. Usa este campo para realizar búsquedas categóricas independientes del idioma y la región. Los tipos válidos se indican aquí.

Interfaz de TextSearchRequest

Interfaz de google.maps.places.TextSearchRequest

Es una solicitud de búsqueda de texto que se enviará a PlacesService.
bounds optional
Son los límites que se usan para sesgar los resultados cuando se buscan lugares (opcional). Se ignorarán location y radius si se establece bounds. Los resultados no se restringirán a los que se encuentren dentro de estos límites, pero los que estén dentro de ellos tendrán una clasificación más alta.
language optional
Tipo:  string optional
Es un identificador de idioma para el idioma en el que se deben mostrar los nombres y las direcciones, cuando sea posible. Consulta la