ADEPS - Points Verts

A Flutter application for displaying future ADEPS walks.

This app uses the ODWB platform API to retrieve walk data.

Features

• Display walks by date in list or map view
• Show walks alphabetically in a directory-style list
• Calculate distance between your current position and walks (requires location permission)
• Calculate distance and time from your home to walks (requires setting home address in app settings)
• Display 5-day weather forecasts for walks
• Launch navigation to selected walks
• Receive notifications about the nearest walk one day in advance (requires setting home address in app settings)

Setup and Configuration

Map API Configuration

The app supports multiple map providers for different functionalities. You can configure separate providers for API calls (MAP_API) and for displaying the interactive map (INTERACTIVE_MAP).

Map API Provider (for API calls)

Choose one of the following providers and add the corresponding configuration to your .env file:

1. Google Maps

   MAP_API=google
   MAP_API_KEY=your_google_api_key
   MAP_API_WEBSITE=https://developers.google.com/maps?hl=fr
   MAP_API_NAME=Google Maps
   

2. Mapbox

   MAP_API=mapbox
   MAP_API_KEY=your_mapbox_token
   MAP_API_WEBSITE=https://www.mapbox.com/
   MAP_API_NAME=Mapbox
   

3. Azure Maps

   MAP_API=azure
   MAP_API_KEY=your_azure_maps_key
   MAP_API_WEBSITE=https://azure.microsoft.com/fr-fr/products/azure-maps/
   MAP_API_NAME=Azure Maps
   

Interactive Map Provider

Choose one of the following providers for the interactive map display and add the configuration to your .env file:

1. Google Maps

   INTERACTIVE_MAP=google
   INTERACTIVE_MAP_API=your_google_api_key
   

2. Mapbox

   INTERACTIVE_MAP=mapbox
   INTERACTIVE_MAP_API=your_mapbox_token
   

3. Azure Maps

   INTERACTIVE_MAP=azure
   INTERACTIVE_MAP_API=your_azure_maps_key
   

Note: The MAP_API and INTERACTIVE_MAP providers do not need to be the same. You can mix and match based on your requirements and preferences.

Additional Google Maps Configuration

If you're using Google Maps for either MAP_API or INTERACTIVE_MAP, you'll need to set up platform-specific API keys:

1. Android-restricted key:

   • Enable Maps SDK for Android API
   • Add to android/local.properties:

     googleMaps.apiKey=your_android_api_key
     

2. iOS-restricted key:

   • Enable Maps SDK for iOS API
   • Create ios/Runner/GoogleMaps.plist:

     <?xml version="1.0" encoding="UTF-8"?>
     <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
     <plist version="1.0">
     <dict>
     <key>API_KEY</key>
     <string>your_ios_api_key</string>
     </dict>
     </plist>
     

3. Unrestricted key (if using Google for MAP_API):

   • Enable Distance Matrix API, Geocoding API, Maps Static API, and Places API
   • Use this key for the MAP_API_KEY in the .env file

Weather API Configuration

Add your OpenWeather API key to .env:

OPENWEATHER_TOKEN=your_openweather_api_key

Firebase Configuration

1. Follow the Firebase Flutter setup guide
2. Add Firebase configuration to .env:

   FIREBASE_ANDROID_APP_ID=android_app_id
   FIREBASE_ANDROID_API_KEY=android_api_key
   FIREBASE_IOS_APP_ID=ios_app_id
   FIREBASE_IOS_API_KEY=ios_api_key
   FIREBASE_IOS_CLIENT_ID=ios_client_id
   FIREBASE_IOS_BUNDLE_ID=ios_bundle_id
   FIREBASE_PROJECT_ID=project_id
   FIREBASE_SENDER_ID=sender_id
   FIREBASE_STORAGE_BUCKET=storage_bucket
   

Android Keystore Configuration

Add keystore information to android/key.properties:

storePassword=your_store_password
keyPassword=your_key_password
keyAlias=key
storeFile=/path/to/your/key.jks

Building and Releasing

1. Generate splash screen:

   flutter pub run flutter_native_splash:create
   

2. Generate launcher icons:

   flutter pub run flutter_launcher_icons:main
   

3. Build release version:

   • Android:

     flutter build appbundle
     

   • iOS: Use Xcode to build and release

Initial Walk Dataset

To include an initial offline dataset, place a JSON file named walk_data.json in the assets folder. This file should follow the ODWB schema.

Missing Assets

Due to copyright restrictions, the following assets are not included in the repository:

• Android:

  android/app/src/main/res/drawable*/ic_notification.png
  android/app/src/main/res/mimap*/ic_launcher_foreground.png
  android/app/src/main/ic_launcher-playstore.png
  

• iOS:

  ios/Runner/Assets.xcassets/AppIcon.appiconset
  

• Flutter:

  assets/dark/logo.png
  assets/dark/logo-annule.png
  assets/dark/splash.png
  assets/light/logo.png
  assets/light/logo-annule.png
  assets/light/splash.png
  

Please ensure you have the necessary rights to use any replacement assets.