Beta
Telemetry and privacy
Today: live since 11 November 2026 on the web services; the SDKs send health events once they are published. Our lawyer still reviews this page and the API and SDK terms.
We use no outside analytics or tracking company. Everything below goes only to Rana's own servers.
SDK health events
The SDKs send a few events so we can see when the map fails to load:
| Event | Sent when | What it carries |
|---|---|---|
map_initialized |
A map view starts | SDK version, platform, OS version |
style_loaded |
The style finished loading | Load time in milliseconds |
tile_error |
A tile failed | Whether the failure was a 4xx, a 5xx or no answer |
- Events are batched, sent at most once a minute to
POST /v1/telemetrywith your key, and never block the map. - We keep only daily counts per organisation, SDK, version and event (and the total style load time, for an average), for 90 days. Telemetry does not count as usage.
- No location and no viewport (where the map is looking) is ever sent.
- No end-user ids, advertising ids or device ids are sent.
- Switch it off with one option:
telemetry: falseon the web,RanaMaps.telemetry = falseon Android,RanaMaps.telemetryEnabled = falseon iOS.
Demand counts from your requests
To know where to map next, we keep two kinds of daily count, per grid cell of about 1 km:
- searches that found nothing;
- route starts and ends.
We keep only the count per cell per day, across all customers: not even your organisation is kept with it. The
coordinates, the query text and anything that identifies your users are dropped when the request ends. Counts are kept for
two years. A search with no location (no lat/lng) is not counted at all.
What we keep about requests
- Per key, per product, per day: the number of requests (for limits and invoices).
- Short-lived server logs for errors and abuse, with keys removed.
For your store listing
Our reading, to be confirmed by our lawyer (checklist item H3):
- Google Play Data safety: the SDK sends "App info and performance: diagnostics" (map load and tile errors), not linked to the user, not used for tracking. If you switch telemetry off, there is nothing to declare for it.
- Apple privacy manifest: "Other diagnostic data", not linked to the user, not used for tracking, for app functionality. The SDK collects no data types used for tracking and no required-reason APIs beyond the system's own.
- The web services themselves receive what your requests contain (points, search words). Describe that in your own privacy notice like any other service you call.
Attribution
Telemetry settings never change attribution: "© Rana Maps © OpenStreetMap" stays on every map.