PositionOptions

La interfaz PositionOptions describe las opciones disponibles cuando invocamos el "backend" de geolocalización. El navegador no crea este objeto directamente: es el script que invoca quien lo crea y usa como un parámetro de Geolocation.getCurrentPosition() y Geolocation.watchPosition().

Propiedades

La interfaz PositionOptions no hereda ninguna propiedad.

PositionOptions.enableHighAccuracy

Es un Boolean que indica que la aplicación quiere recibir los mejores resultados posibles. Si es true y si el dispositivo es capaz de proporcionar una posición más precisa, así lo hará. Ten en cuenta que esto puede resultar en tiempos de respuesta más lentos o en un incremento del uso de energía (con un chip GPS en un teléfono móvil por ejemplo). Por otro lado, si es false (el valor por defecto), el dispositivo tiene libertad para decidir ahorrar recursos respondiendo más rápido y/o usando menos energía.

PositionOptions.timeout

Es un valor long positivo que representa el máximo período de tiempo (en millisegundos) que se le permite tomar al dispositivo para retornar a una posición. El valor por defecto es Infinity, y significa que getCurrentPosition() no retornará hasta que esté disponible la posición.

PositionOptions.maximumAge

Es un valor long positivo que indica la edad máxima en milisegundos de una posible posición "cacheada" que es aceptable retornar. Si es 0, significa que el dispositivo no puede usar posiciones "cacheadas" y debe intentar conseguir la posición real actual. Si es Infinity el dispositivo debe retornar una posición previamente "cacheada" independientemente de su edad.

Métodos

La interfaz PositionOptions no implementa ni hereda ningún método.

Especificaciones

Compatibilidad de navegador

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Ver también

• Using geolocation
• La interfaz Geolocation que la usa.