PlacesService
Clase google.maps.places.PlacesService
Contiene métodos relacionados con la búsqueda de sitios y la recuperación de detalles acerca de un sitio.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Cuando se usa v=beta
, se puede acceder a él llamando a const {PlacesService} = await google.map.importLibrary("places")
. Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
PlacesService |
PlacesService(attrContainer) Parámetros:
Crea una instancia nueva de PlacesService que procesa las atribuciones en el contenedor especificado. |
Métodos | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) Parámetros:
Valor que se muestra: Ninguno
Recupera una lista de lugares en función de 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, se puede mostrar 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 PlaceResult más detallado para cada lugar llamando a PlacesService.getDetails y pasando PlaceResult.place_id para el lugar deseado. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Parámetros:
Valor que se muestra: Ninguno
Recupera una lista de lugares en función de una cadena de consulta. 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, se puede mostrar 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 PlaceResult más detallado para cada lugar llamando a PlacesService.getDetails y pasando PlaceResult.place_id para el lugar deseado. |
getDetails |
getDetails(request, callback) Parámetros:
Valor que se muestra: Ninguno
Recupera los detalles sobre el lugar identificado por la placeId especificada. |
nearbySearch |
nearbySearch(request, callback) Parámetros:
Valor que se muestra: Ninguno
Recupera una lista de lugares cerca de una ubicación en particular, según la palabra clave o el tipo. La ubicación siempre debe especificarse, ya sea pasando los parámetros LatLngBounds o location y radius . Los PlaceResult que se pasan a la devolución de llamada son subconjuntos de la PlaceResult completa. Tu aplicación puede obtener un PlaceResult más detallado para cada sitio al enviar una solicitud de Place Details al pasar el PlaceResult.place_id del lugar deseado. El objeto PlaceSearchPagination se puede usar para recuperar páginas de resultados adicionales (nulo si es la última página de resultados o si solo hay una página de resultados). |
textSearch |
textSearch(request, callback) Parámetros:
Valor que se muestra: Ninguno
Recupera una lista de lugares en función de una cadena de consulta (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 inclinan hacia resultados cercanos en lugar de restringirse a lugares dentro del área. Usa textSearch cuando quieras buscar lugares con una string arbitraria y en los casos en que tal vez 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 de resultados adicionales (nulo si es la última página de resultados o si solo hay una página de resultados). |
PlaceDetailsRequest
Interfaz de google.maps.places.PlaceDetailsRequest
Una consulta de Place Details para enviar a PlacesService
.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
placeId |
Tipo:
string El id. de sitio del sitio para el cual se solicitan detalles. |
fields optional |
Tipo:
Array<string> optional Los campos que se incluirán en la respuesta de detalles, que se facturarán. Si no se especifican campos o se pasa ['ALL'] , se mostrarán y facturarán todos los campos disponibles (esto no se recomienda para implementaciones de producción). Para obtener una lista de campos, consulta PlaceResult . Los campos anidados se pueden especificar con rutas de acceso de puntos (por ejemplo, "geometry.location" ). |
language optional |
Tipo:
string optional Un identificador de idioma para el idioma en el que se deben mostrar los detalles. Consulta la lista de idiomas compatibles. |
region optional |
Tipo:
string optional Un código de región de la región del usuario. Esto puede afectar las fotos que se pueden mostrar 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 "Reino Unido de Gran Bretaña e Irlanda del Norte"). |
sessionToken optional |
Tipo:
AutocompleteSessionToken optional Referencia única que se usa para empaquetar la solicitud de detalles con una sesión de autocompletado. |
FindPlaceFromPhoneNumberRequest.
Interfaz de google.maps.places.FindPlaceFromPhoneNumberRequest
Un lugar de la solicitud de búsqueda de texto se enviará a PlacesService.findPlaceFromPhoneNumber
.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
fields |
Tipo:
Array<string> Los campos que se incluirán en la respuesta, que se facturarán. Si se pasa ['ALL'] , se mostrarán y facturarán todos los campos disponibles (esto no se recomienda para implementaciones de producción). Para obtener una lista de campos, consulta PlaceResult . Los campos anidados se pueden especificar con rutas de acceso de puntos (por ejemplo, "geometry.location" ). |
phoneNumber |
Tipo:
string El número de teléfono del lugar donde se buscará. El formato debe ser E.164. |
language optional |
Tipo:
string optional 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 El sesgo utilizado al buscar lugar. El resultado se restringirá a la LocationBias determinada, pero no estará restringida a ella. |
FindPlaceFromQueryRequest
Interfaz de google.maps.places.FindPlaceFromQueryRequest
Un lugar de la solicitud de búsqueda de texto se enviará a PlacesService.findPlaceFromQuery
.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
fields |
Tipo:
Array<string> Los campos que se incluirán en la respuesta, que se facturarán. Si se pasa ['ALL'] , se mostrarán y facturarán todos los campos disponibles (esto no se recomienda para implementaciones de producción). Para obtener una lista de campos, consulta PlaceResult . Los campos anidados se pueden especificar con rutas de acceso de puntos (por ejemplo, "geometry.location" ). |
query |
Tipo:
string La consulta de la solicitud. Por ejemplo, el nombre o la dirección de un lugar. |
language optional |
Tipo:
string optional 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 El sesgo utilizado al buscar lugar. El resultado se restringirá a la LocationBias determinada, pero no estará restringida a ella. |
PlaceSearchRequest
Interfaz de google.maps.places.PlaceSearchRequest
Una consulta de búsqueda de sitios que se enviará al PlacesService
.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Los límites dentro de los cuales buscar sitios. location y radius se ignorarán si se configura bounds . |
keyword optional |
Tipo:
string optional Un término para coincidir con todos los campos disponibles, incluidos, entre otros, 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 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 La ubicación alrededor de la cual se buscará Places. |
maxPriceLevel optional |
Tipo:
number optional Restringe los resultados a los lugares que se encuentran en el nivel de precio 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 a aquellos lugares que tengan 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. |
|
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 string de búsqueda. |
openNow optional |
Tipo:
boolean optional Restringe los resultados a los lugares que están abiertos en este momento. |
radius optional |
Tipo:
number optional La distancia desde la ubicación determinada, en la que se buscará Places, 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á para mostrar 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 específico. El tipo se traduce al idioma local de la ubicación de destino de la solicitud y se utiliza como una cadena de consulta. Si también se proporciona una consulta, se concatena a la string de tipo localizado. Los resultados de un tipo diferente se eliminan de la respuesta. Usa este campo para realizar búsquedas categóricas independientes de idiomas y regiones. Los tipos válidos se proporcionan aquí. |
TextSearchRequest
Interfaz de google.maps.places.TextSearchRequest
Se enviará una solicitud de búsqueda de texto a PlacesService
.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Los límites que se usan para restringir los resultados al buscar lugares (opcional). location y radius se ignorarán si se configura bounds . Los resultados no se restringirán a aquellos que se encuentren dentro de estos límites. Sin embargo, sus resultados tendrán una clasificación más alta. |
language optional |
Tipo:
string optional 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 El centro del área utilizada para restringir los resultados al buscar lugares. |
query optional |
Tipo:
string optional El término de la consulta de la solicitud. Por ejemplo, el nombre de un lugar ("Torre Eiffel"), una categoría seguida del nombre de una ubicación ("pizza en Nueva York") o el nombre de un lugar seguido por un desambiguador de ubicación ("Starbucks en Sídney"). |
radius optional |
Tipo:
number optional El área del área utilizada para restringir los resultados al buscar lugares, en metros. |
region optional |
Tipo:
string optional Un código de región para obtener resultados. 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 "Reino Unido de Gran Bretaña e Irlanda del Norte"). |
type optional |
Tipo:
string optional Busca lugares del tipo específico. El tipo se traduce al idioma local de la ubicación de destino de la solicitud y se utiliza como una cadena de consulta. Si también se proporciona una consulta, se concatena a la string de tipo localizado. Los resultados de un tipo diferente se eliminan de la respuesta. Usa este campo para realizar búsquedas categóricas independientes de idiomas y regiones. Los tipos válidos se proporcionan aquí. |
Constantes de RankBy
google.maps.places.RankBy
constantes
Opciones de clasificación para una PlaceSearchRequest.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Cuando se usa v=beta
, se puede acceder a él llamando a const {RankBy} = await google.map.importLibrary("places")
. Consulta Bibliotecas en la API de Maps JavaScript.
Constantes | |
---|---|
DISTANCE |
Las clasificaciones clasifican los resultados según la distancia desde la ubicación. |
PROMINENCE |
Clasifica los resultados según la importancia. |
LocationBias typedef
google.maps.places.LocationBias
deftype
Un LocationBias representa un límite flexible o una sugerencia para utilizar al buscar lugares. Los resultados pueden provenir de fuera del área especificada. Para usar la dirección IP del usuario actual como un sesgo, se puede especificar la string "IP_BIAS"
. Nota: Si se usa un objeto Circle
, se deben definir el radio y el centro.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
deftype
Una LocationRestriction es un límite estricto que se debe usar al buscar lugares.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Constantes de PlacesServiceStatus
google.maps.places.PlacesServiceStatus
constantes
Es el estado que muestra PlacesService
cuando completa sus búsquedas. Especifícalos por valor o usa el nombre de la constante. Por ejemplo, 'OK'
o google.maps.places.PlacesServiceStatus.OK
.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Cuando se usa v=beta
, se puede acceder a él llamando a const {PlacesServiceStatus} = await google.map.importLibrary("places")
. Consulta Bibliotecas en la API de Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
esta solicitud no es válida. |
NOT_FOUND |
No se encontró el lugar al que se hace referencia. |
OK |
la respuesta contiene un resultado válido. |
OVER_QUERY_LIMIT |
La aplicación excedió su cuota de solicitudes. |
REQUEST_DENIED |
La aplicación no puede usar el PlacesService . |
UNKNOWN_ERROR |
No se pudo procesar la solicitud PlacesService debido a un error del servidor. La solicitud podría completarse si realizas un nuevo intento. |
ZERO_RESULTS |
No se encontraron errores para esta solicitud. |
PlaceSearchPagination
Interfaz de google.maps.places.PlaceSearchPagination
Un objeto que se usa para recuperar páginas adicionales de resultados de Places.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
hasNextPage |
Tipo:
boolean Indica si hay más resultados disponibles. true cuando haya una página de resultados adicionales |
Métodos | |
---|---|
nextPage |
nextPage() Parámetros: ninguno
Valor que se muestra: Ninguno
Recupera la siguiente página de resultados. Usa la misma función de devolución de llamada que se proporcionó a la primera solicitud de búsqueda. |
PlaceResult.
Interfaz de google.maps.places.PlaceResult
Define información sobre un lugar.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
address_components optional |
Tipo:
Array<GeocoderAddressComponent> optional el conjunto de componentes de dirección para la ubicación de este lugar. Solo disponible con PlacesService.getDetails . |
adr_address optional |
Tipo:
string optional la representación de la dirección del lugar en el microformato del anuncio; Solo disponible con PlacesService.getDetails . |
aspects optional |
Tipo:
Array<PlaceAspectRating> optional Los aspectos calificados de este lugar, basados en los comentarios de usuarios de Google y Zagat. Las calificaciones se basan en una escala de 0 a 30. |
business_status optional |
Tipo:
BusinessStatus optional Indicador del estado operativo del Lugar, si es un negocio (indica si el lugar está en funcionamiento o cerrado temporal o permanentemente). Si no hay datos disponibles, la marca no aparecerá en la búsqueda ni en las respuestas de detalles. |
formatted_address optional |
Tipo:
string optional La dirección completa del lugar. |
formatted_phone_number optional |
Tipo:
string optional El número de teléfono del lugar, con el formato conforme a la convención regional del número. Solo disponible con PlacesService.getDetails . |
geometry optional |
Tipo:
PlaceGeometry optional La información del sitio relacionada con aspectos geométricos. |
html_attributions optional |
Tipo:
Array<string> optional Texto de atribución que se mostrará para este resultado de lugar. Siempre se muestran los html_attributions disponibles, independientemente de los fields que se hayan solicitado y deben mostrarse. |
icon optional |
Tipo:
string optional URL de un recurso de imagen que puede usarse para representar la categoría de este sitio. |
icon_background_color optional |
Tipo:
string optional Color de fondo para usar con el ícono de un lugar. Consulta también PlaceResult.icon_mask_base_uri . |
icon_mask_base_uri optional |
Tipo:
string optional Es una URL truncada a una máscara de ícono. Para acceder a diferentes tipos de íconos, agrega una extensión de archivo al final (es decir, .svg o .png ). |
international_phone_number optional |
Tipo:
string optional El número de teléfono del lugar en formato internacional. El formato internacional incluye el código de país y está precedido por un signo más (+). Solo disponible con PlacesService.getDetails . |
name optional |
Tipo:
string optional el nombre del lugar. Nota: si el usuario ingresó en Google Places, este es el texto sin formato, tal como lo escribió el usuario. Ten cuidado cuando uses estos datos, ya que los usuarios malintencionados pueden intentar usarlos como un vector para ataques de inyección de código (consulta http://en.wikipedia.org/wiki/Code_injection). |
opening_hours optional |
Tipo:
PlaceOpeningHours optional Define cuándo se abre o se cierra el lugar. |
|
Tipo:
boolean optional Indicador que indica si el lugar está cerrado, ya sea de forma permanente o temporal. Si el sitio está operativo o si no hay datos disponibles, la marca no aparecerá en la respuesta. |
photos optional |
Tipo:
Array<PlacePhoto> optional Fotos de este lugar. La colección contendrá hasta diez objetos PlacePhoto . |
place_id optional |
Tipo:
string optional un identificador único para el sitio. |
plus_code optional |
Tipo:
PlacePlusCode optional Define los códigos de ubicación abiertos o los "códigos plus" del lugar. |
price_level optional |
Tipo:
number optional Corresponde al nivel de precio del lugar, en una escala del 0 al 4. Los niveles de precios se interpretan de la siguiente manera:
|
rating optional |
Tipo:
number optional Calificación: entre 1,0 y 5,0, según las opiniones de los usuarios sobre este lugar. |
reviews optional |
Tipo:
Array<PlaceReview> optional Una lista de comentarios acerca de este lugar. Solo disponible con PlacesService.getDetails . |
types optional |
Tipo:
Array<string> optional Un arreglo de tipos para este lugar (por ejemplo, ["political", "locality"] o ["restaurant", "establishment"] ). |
url optional |
Tipo:
string optional URL de la página oficial de Google del sitio. Esta es la página de Google que contiene la mejor información disponible acerca del sitio. Solo disponible con PlacesService.getDetails . |
user_ratings_total optional |
Tipo:
number optional Cantidad de calificaciones de los usuarios que contribuyeron a las PlaceResult.rating de este lugar. |
|
Tipo:
number optional Desplazamiento de UTC de la zona horaria actual del lugar, en minutos. Por ejemplo, en Sídney, Australia, en horario de verano, hay 11 horas de anticipación respecto de UTC, por lo que la métrica utc_offset será de 660 . Para las zonas horarias posteriores a UTC, la compensación es negativa. Por ejemplo, el utc_offset es -60 en Cabo Verde. Solo disponible con PlacesService.getDetails . |
utc_offset_minutes optional |
Tipo:
number optional Desplazamiento de UTC de la zona horaria actual del lugar, en minutos. Por ejemplo, en Sídney, Australia, en horario de verano, hay 11 horas de anticipación respecto de UTC, por lo que la métrica utc_offset_minutes será de 660 . Para las zonas horarias posteriores a UTC, la compensación es negativa. Por ejemplo, el utc_offset_minutes es -60 en Cabo Verde. Solo disponible con PlacesService.getDetails . |
vicinity optional |
Tipo:
string optional La dirección simplificada del lugar, que incluye el nombre de la calle, el número y la localidad, pero no incluye la provincia o el estado, el código postal ni el país. Por ejemplo, la oficina de Google en Sídney, Australia, tiene un valor de proximidad de "48 Pirrama Road, Pyrmont" . Solo disponible con PlacesService.getDetails . |
website optional |
Tipo:
string optional El sitio web autorizado para este lugar, como la página principal de una empresa. Solo disponible con PlacesService.getDetails . |
PlaceAspectRating
Interfaz de google.maps.places.PlaceAspectRating
Define la información acerca de un aspecto del lugar que opinaron los usuarios.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
rating |
Tipo:
number La calificación de este aspecto. En el caso de las opiniones individuales, es un número entero de 0 a 3. Para las calificaciones totales de un lugar, se trata de un número entero de 0 a 30. |
type |
Tipo:
string El tipo de aspecto. Por ejemplo, "food" , "decor" , "service" o "overall" . |
Constantes de BusinessStatus
google.maps.places.BusinessStatus
constantes
el estado operativo del sitio, si es un negocio, devuelto en un PlaceResult (indica si el sitio está en funcionamiento, o si está cerrado temporal o permanentemente). Especifícalos por valor o el nombre de la constante (ejemplo: 'OPERATIONAL'
o google.maps.places.BusinessStatus.OPERATIONAL
).
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Cuando se usa v=beta
, se puede acceder a él llamando a const {BusinessStatus} = await google.map.importLibrary("places")
. Consulta Bibliotecas en la API de Maps JavaScript.
Constantes | |
---|---|
CLOSED_PERMANENTLY |
La empresa está cerrada permanentemente. |
CLOSED_TEMPORARILY |
La empresa está cerrada temporalmente. |
OPERATIONAL |
La empresa funciona con normalidad. |
PlaceGeometry
Interfaz de google.maps.places.PlaceGeometry
Define información acerca de la geometría de un sitio.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
location optional |
Tipo:
LatLng optional La posición del lugar. |
viewport optional |
Tipo:
LatLngBounds optional El viewport preferido cuando se muestra este lugar en un mapa. Esta propiedad será null si no se conoce el viewport preferido para el lugar. Solo disponible con PlacesService.getDetails . |
PlaceOpeningHours
Interfaz de google.maps.places.PlaceOpeningHours
Define información sobre el horario de atención de un lugar.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
|
Tipo:
boolean optional Indica si el lugar está abierto en este momento. |
periods optional |
Tipo:
Array<PlaceOpeningHoursPeriod> optional Períodos de apertura que abarcan todos los días de la semana, a partir del día domingo, en orden cronológico. Los días en que el Lugar no está abierto no se incluyen. Solo disponible con PlacesService.getDetails . |
weekday_text optional |
Tipo:
Array<string> optional Un arreglo de siete strings que representan las horas de apertura con formato para cada día de la semana. El servicio de Places dará formato y localizará el horario de atención de manera apropiada al idioma actual. El orden de los elementos en este array depende del lenguaje. En algunos idiomas, la semana inicia el lunes y, en otros, comienza el domingo. Solo disponible con PlacesService.getDetails . Otras llamadas pueden mostrar un arreglo vacío. |
Métodos | |
---|---|
isOpen |
isOpen([date]) Parámetros:
Valor que se muestra:
boolean|undefined Verifica si el lugar está abierto ahora (cuando no se pasa una fecha) o en una fecha determinada. Si este lugar no tiene PlaceResult.utc_offset_minutes ni PlaceOpeningHours.periods , se muestra undefined (PlaceOpeningHours.periods solo está disponible mediante PlacesService.getDetails ). Este método no tiene en cuenta un horario excepcional, como el horario de días feriados. |
PlaceOpeningHoursPeriod
Interfaz de google.maps.places.PlaceOpeningHoursPeriod
Define información estructurada sobre el horario de atención de un lugar. Nota: Si un lugar está siempre abierto, la sección close
no aparecerá en la respuesta. Los clientes pueden confiar en que la representación siempre abierta se represente como un período open
que contiene day
con el valor 0
y time
con el valor "0000"
, y no close
.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
open |
Tipo:
PlaceOpeningHoursTime La hora de apertura del lugar. |
close optional |
Tipo:
PlaceOpeningHoursTime optional La hora de cierre del lugar. |
PlaceOpeningHoursTime
Interfaz de google.maps.places.PlaceOpeningHoursTime
Define cuándo se abre o se cierra un lugar.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
day |
Tipo:
number Los días de la semana como número en el rango [ 0 , 6 ], a partir del domingo. Por ejemplo, 2 significa martes. |
hours |
Tipo:
number Las horas del PlaceOpeningHoursTime.time como número, en el rango [0 , 23 ]. Esto se informará en la zona horaria del lugar. |
minutes |
Tipo:
number Los minutos de la PlaceOpeningHoursTime.time como un número, en el rango [0 , 59 ]. Esto se informará en la zona horaria del lugar. |
time |
Tipo:
string Es la hora del día en formato de 24 horas. Los valores están en el intervalo [ "0000" , "2359" ]. La hora se informará en la zona horaria del lugar. |
nextDate optional |
Tipo:
number optional La marca de tiempo (como milisegundos desde el ciclo de entrenamiento, adecuada para usarse con new Date() ) que representa el próximo caso de este PlaceOpeningHoursTime Se calcula a partir del PlaceOpeningHoursTime.day de la semana, el PlaceOpeningHoursTime.time y el PlaceResult.utc_offset_minutes . Si el PlaceResult.utc_offset_minutes es undefined , entonces nextDate será undefined . |
PlacePlusCode
Interfaz de google.maps.places.PlacePlusCode
Define los códigos de ubicación abiertos o los "códigos plus" de un lugar. Los Plus Codes se pueden usar como reemplazo de las direcciones en los lugares donde estas no existen (donde los edificios no están numerados o las calles no tienen nombre).
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
global_code |
Tipo:
string Un código plus con un grado de 1/8000 en un grado y un área de grado Por ejemplo, "8FVC9G8F+5W" |
compound_code optional |
Tipo:
string optional Un código plus con una undécima de grado por un grado de área en la que los primeros cuatro caracteres (el código de área) se descartan y se reemplazan con una descripción de localidad. Por ejemplo, "9G8F+5W Zurich, Switzerland" Si no se encuentra una localidad adecuada que pueda acortar el código, se omite este campo. |
PlacePhoto.
Interfaz de google.maps.places.PlacePhoto
Representa un elemento de foto de un lugar.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
height |
Tipo:
number La altura de la foto en píxeles. |
html_attributions |
Tipo:
Array<string> Texto de atribución que se mostrará para esta foto. |
width |
Tipo:
number El ancho de la foto en píxeles. |
Métodos | |
---|---|
getUrl |
getUrl([opts]) Parámetros:
Valor que se muestra:
string Muestra la URL de la imagen correspondiente a las opciones especificadas. |
PhotoOptions.
Interfaz de google.maps.places.PhotoOptions
Define las opciones de solicitud de fotos.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
maxHeight optional |
Tipo:
number optional La altura máxima en píxeles de la imagen que se muestra. |
maxWidth optional |
Tipo:
number optional El ancho máximo en píxeles de la imagen que se muestra. |
PlaceReview
Interfaz de google.maps.places.PlaceReview
Representa una sola opinión de un lugar.
Carga con el parámetro de URL &libraries=places
. Consulta Bibliotecas en la API de Maps JavaScript.
Propiedades | |
---|---|
author_name |
Tipo:
string Corresponde al nombre del usuario que dejó la opinión. |
language |
Tipo:
string Es un código de idioma IETF que indica el idioma en el que se escribió esta opinión. Tenga en cuenta que este código solo incluye la etiqueta del idioma principal, sin etiquetas secundarias que indiquen el país o la región. Por ejemplo, todas las reseñas en inglés están etiquetadas como 'en' en lugar de "en-AU" o "en-UK". |
profile_photo_url |
Tipo:
string Una URL a la imagen de perfil del remitente. |
relative_time_description |
Tipo:
string Una string de hora reciente con formato que expresa la hora de revisión en relación con la hora actual en un formato adecuado para el idioma y el país. Por ejemplo: "a month ago" . |
text |
Tipo:
string Es el texto de una opinión. |
time |
Tipo:
number Marca de tiempo de la opinión, expresada en segundos desde el epoch. |
|
Tipo:
Array<PlaceAspectRating> optional Los aspectos calificados por la opinión. Calificaciones en una escala del 0 al 3 |
author_url optional |
Tipo:
string optional Una URL al perfil del usuario que dejó la opinión. Este valor será undefined cuando el perfil del usuario que deja la opinión no esté disponible. |
rating optional |
Tipo:
number optional Es la calificación de esta opinión, un número entre 1.0 y 5.0 (inclusive). |