Contact
For bug reports, feature requests, and general questions, open a GitHub issue or send an email.
Frequently Asked Questions
Why does the app need Location Always permission?
Background location is the core function of Maps Telemetry — it is a GPS data logger designed to run continuously while you drive. Without Always permission, iOS will suspend the app when the screen turns off and GPS recording will stop.
Where does my data go?
Your GPS and sensor data is published to the MQTT broker you configure in Settings → MQTT. The developer has no server that receives your data and no ability to see it. See the Privacy Policy for full details.
What is AWS IoT fleet provisioning?
On first launch the app generates a device-unique TLS certificate using a claim certificate bundled in the app, and registers it with your AWS IoT endpoint. This happens automatically — no manual configuration needed. The private key is stored in the iOS Keychain and never leaves your device.
CarPlay isn't working
Maps Telemetry supports CarPlay on iOS 14 and later. The entitlement requires a compatible vehicle or the iOS CarPlay Simulator (Settings → Developer → Enable CarPlay Simulator). If using a vehicle, make sure the app has CarPlay permission in Settings → Screen Time → Content & Privacy Restrictions → Allowed Apps.
The MQTT status shows Offline
Check Settings → MQTT and confirm the broker URL, port, and credentials are correct. The app uses MQTT over TLS (port 8883 by default). If you are using AWS IoT, verify the device certificate is active in the AWS IoT console and that the device policy grants Publish/Subscribe on the relevant topics.
Road mapping sessions aren't saving
Ensure the app is not in Low Power Mode during capture — iOS may throttle background tasks. Keep the screen on or plug in to charge during long mapping sessions.
How do I export my data?
On the Sessions screen, tap any session and use the Share button to export as GPX, CSV, GeoJSON, or KML. You can send via AirDrop, Mail, or save to Files.
Privacy — I want to delete my data
Local session data is deleted when you remove the app from your device. Data on your MQTT server is under your control — consult your server administrator or your own AWS IoT console to delete published records.