OSM User Agent

The Prohandy Client app uses OpenStreetMap (OSM) powered by flutter_map to render location markers — no Google Maps API key required.

Note

Former docs under google-map-setup used a Google API key via mapApiKey / AndroidManifest.xml. That flow is deprecated. Follow this OSM guide instead (old routes redirect here).

User-Agent package name

OpenStreetMap's tile servers require a valid HTTP User-Agent identifying your app. When you changed the package name in Updating Package & Bundle ID, update userAgentPackageName in the visitor map views:

Files (example — adjust to your project layout; original Helpnest guide used Visitor_view paths):

lib/views/visitor_view/component/visitor_map_header.dart
lib/views/visitor_view/visitor_map_view.dart

TileLayer(
  urlTemplate: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
  userAgentPackageName: 'com.yourdomain.prohandy', // Must match your app package
)

Note

Replace com.yourdomain.prohandy with the applicationId / Bundle ID you set. Failure to set a valid userAgentPackageName may cause tiles to be blocked or rate-limited by OSM servers.

Verify

Build and open the map screen — tiles should load without an API key. If tiles are 403/429, check the package name spelling.

Still stuck?

Our support team is ready to help you get set up.

Get support