UGasolineras (Android)

Aplicacion Android de UGasolineras para localizar gasolineras y puntos de recarga cercanos, con mapa interactivo, cache inteligente y soporte base para Android Auto.

Estado

• Version: 1.1.2 (versionCode 4)
• Estado: Probada en Android
• Plataforma incluida en este repositorio: Android

Funcionalidades clave

• Geolocalizacion en tiempo real (permiso while-in-use).
• Modo fosil / electrico con cambio suave.
• Cache local de radio 50 km para acelerar apertura.
• Actualizacion de datos:
  • Cada 30 segundos en primer plano.
  • Cada hora en segundo plano (precios).
• Modal de resultados y detalle de estaciones.
• Tema claro / oscuro / sistema.
• Integracion base con Android Auto (categoria POI).

Estructura del proyecto

app/
  src/main/
    assets/index.html
    java/com/ug/gasolineralowcost/
    res/
playstore/
  privacy-policy-es.md
  data-safety-es.md
  publish-checklist-es.md
  store-listing-es.md

Credenciales y tokens (obligatorio antes de publicar)

1) Open Charge Map API key

• Uso: obtener puntos de recarga EV.
• Dato a configurar: OCM_API_KEY.
• Archivo: app/src/main/assets/index.html.
• Busca esta linea y reemplaza el placeholder:

const OCM_API_KEY = "ADD_YOUR_OCM_API_KEY_HERE";

Si no se configura, la parte EV no devolvera resultados reales.

2) Token de GitHub (solo para script de subida)

• Uso: publicar automaticamente por API.
• Archivo: scripts/upload_via_github_api.ps1.
• El script pide token por consola (Read-Host).
• Scope minimo recomendado para repo publico: public_repo.

No guardes tokens en codigo. No hagas commit de secretos.

Requisitos

• Android Studio Hedgehog o superior (recomendado).
• JDK 17.
• SDK Android con compileSdk 35.
• Conexion a internet para dependencias Gradle.

Compilacion (Android Studio)

1. Abre la carpeta del proyecto en Android Studio.
2. Espera sincronizacion de Gradle.
3. Ejecuta Run para debug en dispositivo/emulador.
4. Para release, usa Build > Generate Signed Bundle / APK.

Compilacion (CLI, opcional)

Si tienes Gradle instalado en PATH:

gradle :app:assembleDebug
gradle :app:assembleRelease

Publicacion y cumplimiento

En la carpeta playstore/ tienes material inicial para publicacion:

• Politica de privacidad.
• Data Safety.
• Checklist de revision.
• Texto de ficha de Play Store.

Seguridad y privacidad

• Ubicacion usada solo para funcionalidad local de la app.
• No se comparte ubicacion con terceros (segun configuracion actual).
• Revisa credenciales/API keys antes de publicar en produccion.

Uso comercial

• No se permite uso comercial sin autorizacion expresa del titular del proyecto.

Android Auto

• Se incluye base tecnica para Android Auto.
• Antes de publicacion final, revisar:
  • hosts permitidos,
  • validacion de templates,
  • cumplimiento de politicas de Google para Car App.

Licencia

Este repositorio se publica con licencia CC BY-NC 4.0 (no permite uso comercial). Revisa LICENSE para detalle completo.

Autor

• Eugenio Moya Perez
• Contacto: eugenio.moya.perez@gmail.com