talabaty_maps

Author: Bashar (Si1verSurfer) · Repository: OSMFlutterMap

Shared OpenStreetMap integration for Flutter apps:

  • flutter_map + https://tile.openstreetmap.org/{z}/{x}/{y}.png
  • geolocator (high accuracy; debounced stream in LocationService)
  • Backend-proxied OSRM (/maps/route, /maps/match) and Nominatim (/maps/geocode, /maps/reverse)
  • Socket.io live tracking (captain_location events)
  • Widgets: MapCanvas, RoutePolylineLayer, TrackingMarkersLayer

Install

From pub.flutter-io.cn (after publish):

dependencies:
  talabaty_maps: ^1.0.0

From Git:

dependencies:
  talabaty_maps:
    git:
      url: https://github.com/Si1verSurfer/OSMFlutterMap.git
      ref: main

Publish (maintainers)

dart pub publish --dry-run
dart pub publish

Use a clean git tree; sign in with dart pub token / Google account on pub.flutter-io.cn.

Android

In AndroidManifest.xml (above <application>):

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

iOS

In Info.plist:

<key>NSLocationWhenInUseUsageDescription</key>
<string>Your reason for using location.</string>

API base URL

Pass the same value as your REST client: http://host:port/api/v1 (no trailing slash).

Socket.io URL is the origin only — use socketOriginFromApiBaseUrl.

Performance notes

  • Markers: cap list size when many POIs; prefer clustering or viewport filtering.
  • Polylines: simplify geometry client-side for huge routes if needed.
  • Attribution: pass real userAgentPackageName in buildOsmTileLayers; use attributionLabel for i18n.

Optional integration test

Add an integration_test/ target in the consuming app to smoke-test against a staging API.

Libraries

talabaty_maps