Custom Tile Server
If you prefer a provider other than tile.openstreetmap.org — e.g. Mapbox, Stamen, or a self-hosted tile server — change the urlTemplate.
Mapbox example
TileLayer(
urlTemplate: 'https://api.mapbox.com/styles/v1/{id}/tiles/{z}/{x}/{y}?access_token={accessToken}',
additionalOptions: const {
'accessToken': 'YOUR_MAPBOX_ACCESS_TOKEN',
'id': 'mapbox/streets-v11',
},
userAgentPackageName: 'com.yourdomain.prohandy',
)
Set additionalOptions.accessToken to your Mapbox access token and id to your style (e.g. mapbox/streets-v11 or a custom style).
Steps
- Replace
urlTemplateandadditionalOptionsin the same files as OSM User Agent —visitor_map_header.dartandvisitor_map_view.dart. - Rebuild the app and verify tiles load at multiple zoom levels.
- Keep
userAgentPackageNameset even with Mapbox — some providers still check it.
Still stuck?
Our support team is ready to help you get set up.

