Skip to content
avoid-questPublic

About

Android maps application built with Expo and MapLibre.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

125 Commits

Folders and files

Repository files navigation

Avoid Maps

An Android maps app built with Expo, React Native, NativeWind and native MapLibre. It uses direct public services and local data, with no app account, API key, analytics SDK, or paid service required.

The interface is Italian. Local discovery uses a limited bundled place dataset; online geocoding supplements it.

Available in this version

  • Native vector map, manual map browsing and optional foreground Android location without Google Play services.
  • Local restaurant/shop discovery from 23,274 bundled Overture records in a declared regional rectangle, with separately versioned supplements and documented corrections. This is incomplete coverage; online Photon address/name search supplements it when enabled.
  • Place details, available contact links, provenance, and locally saved favourites.
  • Walking, cycling and driving route previews with directions through FOSSGIS; experimental MATO transit journeys when choosing Mezzi.
  • Nearby GTT stops with offline scheduled departures from a bundled timetable, refined by direct GTT realtime predictions, plus service alerts with freshness and missing-data states. An opt-in setting adds GTT's per-stop live passages (GTT then learns which stop is viewed).
  • Local favourites, persisted Solo ricerca locale search policy and bundled regional lookup data. Network outages retain local discovery and show honest unavailable states for online functions.

Development version 0.1.8 adds Avvia navigazione for walking, cycling, driving and the selected transit journey, with native road progress, platform GPS, offline Italian speech when installed, and manual transit boarding/alighting/transfer confirmations. The integrated Android engine, GPS, speech and screen-off service still require runtime acceptance; see the implementation and checks. Route previews remain planning until explicitly started.

This is an early test build. Live road traffic, full offline routing, reviews, comprehensive business hours and all-Italy transit coverage remain unavailable. MATO's access/reuse policy remains unresolved. Choosing Mezzi requests its experimental journey planner and sends route coordinates to MATO/5T.

Install on Android

When a signed APK is available, download avoid-maps.apk from the public releases, or copy artifacts/avoid-maps.apk from a local build. Open it in Android's Files app and permit that installer to install unknown apps when asked. The arm64 release bundles its JavaScript and runs without Metro, Expo Go, an Expo login, or Google Play.

For updates through Obtainium, add https://github.com/avoid-quest/maps as a GitHub source. Repository and release access require no GitHub account or token. Select avoid-maps.apk if asked to choose an asset. Updates use the same signing key; install over the existing app to retain favourites. Obtainium installation and upgrade preservation still require a device test.

Location is optional for browsing and manual-origin planning; Start navigation requires precise location. Denying it leaves map browsing and manual-origin search available. Read Android installation and device checks before testing upgrades or rebuilding. Keep the signing key backed up privately so later APKs preserve app data.

Develop

Use the pinned Bun version and Node 22, then bun install --frozen-lockfile. Run bun check for native typechecking, bun run lint for Expo/React Hooks checks, bun test for fixtures, or bun run verify for all three. See development tooling for CI and the Node/Expo boundary. Native dependencies require a compiled Android app; Expo Go is unsupported. The browser version helps iterate on UI and may encounter provider CORS restrictions that do not apply to Android.

For the prepared local SDK/JDK/Node tools, run source scripts/toolchain-env.sh, then bun run build:android. See Android build instructions for other toolchains and signing.

Prepare changes through feature branches and PRs following the review workflow.

Data refresh and privacy

Public map/search/routing/transit providers receive the requests sent to them and the user's IP address. For timetables these are GTT (realtime feeds; trip lists and calendars of its static export; per-stop departures only if that setting is enabled) and GitHub (Pages and release assets, configured at build time) for the timetable manifest, checked automatically when a stop board opens (at most every 6 hours) or live data no longer matches the installed package, and on request, and for packages. Route providers receive route coordinates. Transitous receives only the selected rail station's or stop's identifier, and only after an explicit action and its disclosure (rail station boards, Cerca su Transitous on a stop board without GTT realtime). Favorites remain on-device; no account or cloud history is created. Online services are best effort and may be unavailable. Full provider attribution, data terms, and transit-provider information are available in the app's information screen and bundled licences and notices.

The APK bundles a validated GTT timetable package, so stop boards are expected to work offline on first launch; native acceptance of import time and first-launch behaviour is pending. GTT re-issues trip IDs for unchanged trips, so live updates are also joined by schedule identity (route, direction, shape, first departure) using only the trip list, calendars and feed metadata read directly from GTT's export with small ranged requests. Optionally, the app checks a manifest published by this repository's workflow (GitHub Pages, then a data-only prerelease that is never marked latest) and installs newer hashed (not signed) timetable packages after verification, keeping the previous one for rollback. Place data still ships only through a rebuilt APK. Follow the data preparation workflow to render the pinned extraction SQL, validate inputs, preserve provenance and prepare reviewed packages.

bun run data:smoke performs bounded live provider checks using public sample coordinates; ordinary unit tests use fixtures. Research and architectural tradeoffs are recorded in the proposal.

Feature gaps and the next device milestone distinguish the current test build from the broader maps capability goal.

Source and data terms

The original application source is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later). Bundled datasets retain their separate licences and notices: GTT permits non-commercial use and redistribution with attribution; Overture place records retain their source-specific terms. Repository visibility does not change those data terms. Navigation dependencies retain their bundled code notices, separate from application-source and dataset terms.

About

Android maps application built with Expo and MapLibre.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages