Skip to Content
ConfiguraciónPerfiles de configuración

Perfiles de configuración

Tracelet viene con varios perfiles de configuración predefinidos para ayudarlo a configurar rápidamente la geolocalización en segundo plano para diferentes casos de uso. Estos perfiles optimizan el equilibrio entre el consumo de batería y la precisión de la ubicación.

Perfiles disponibles

1. Equilibrado (NO TRANS0LATE)

Este es el valor predeterminado recomendado para la mayoría de las aplicaciones. Proporciona un equilibrio altamente optimizado entre capturar rutas detalladas y preservar la duración de la batería.

  • Caso de uso objetivo: Aplicaciones de entrega, seguimiento de flotas, registro de kilometraje.
  • Precisión: Media a alta (depende del hardware)
  • Filtro de distancia: ~20-50 metros
  • Consumo de batería: Bajo (~1-3 % por hora)
  • Muestreo adaptativo: Habilitado
final config = Config.balanced(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

2. Alta precisión (Config.highAccuracy())

Este perfil obliga al hardware del GPS a permanecer activo y solicita la mayor precisión posible. Deshabilita la mayoría de las heurísticas de ahorro de batería.

  • Caso de uso objetivo: Navegación paso a paso, seguimiento de deportes (correr, andar en bicicleta), activadores de geocercas exactas.
  • Precisión: Máxima (1-5 metros)
  • Filtro de distancia: 0-10 metros
  • Consumo de batería: Alto (~5-10% por hora)
  • Muestreo adaptativo: Deshabilitado
final config = Config.highAccuracy(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

3. Baja potencia (Config.lowPower())

Este perfil minimiza el impacto de la batería al depender principalmente de la triangulación de las torres de telefonía móvil y las redes Wi-Fi en lugar del chip GPS que consume mucha energía. Las actualizaciones son menos frecuentes y menos precisas.

  • Caso de uso objetivo: Aplicaciones sociales, actualizaciones meteorológicas, seguimiento de área generalizada.
  • Precisión: Nivel de ciudad/barrio (100-3000 metros)
  • Filtro de distancia: ~500+ metros
  • Consumo de batería: Insignificante (menos del 1% por hora)
  • Muestreo adaptativo: Habilitado
final config = Config.lowPower(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

4. Pasivo (NO TRADUCIR)

Este perfil representa el extremo de la optimización de la batería. En Android, no activará activamente los escáneres GPS o Wi-Fi; en su lugar, se “aprovecha” pasivamente de las solicitudes de ubicación realizadas por otras aplicaciones (por ejemplo, Google Maps, aplicaciones meteorológicas) o el sistema operativo. En iOS, que carece de una verdadera API pasiva, esto recurre a la precisión más baja posible (kCLLocationAccuracyThreeKilometers), funcionando de manera similar al perfil de bajo consumo.

  • Caso de uso objetivo: Ahorro extremo de batería, recopilación de datos en segundo plano sin impacto para el usuario.
  • Precisión: Variable (depende de lo que soliciten otras aplicaciones en Android; 3 km en iOS)
  • Consumo de batería: De cero a insignificante
  • Muestreo adaptativo: Deshabilitado
final config = Config.passive(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

Personalización de perfiles

Los perfiles son simplemente instancias Config preconfiguradas. Puede comenzar con un perfil y anular campos específicos usando .copyWith():

final config = Config.balanced().copyWith(
  geo: GeoConfig(
    distanceFilter: 10, // Override just the distance filter
  ),
  sync: SyncConfig(
    url: 'https://my-api.com/locations',
  ),
);
API de configuraciónFunciones empresariales