Skip to main content
Accurate prayer times require precise location information. Praydo uses OpenStreetMap’s geocoding service to help you set your location quickly and accurately.

Setting Your Location

Location setup is the first step when using Praydo. The app requires your location to calculate accurate prayer times based on your geographical coordinates.
1

Open Settings

Click the Settings icon in the bottom-right corner of the dashboard, or navigate directly from the initial setup screen
2

Navigate to Location Tab

Select the “Location” tab (marked with a map pin icon)
3

Search for Your Location

Enter your city, address, or landmark in the search field:
  • Type at least 3 characters for best results
  • The search uses OpenStreetMap’s geocoding API
  • Examples: “New York”, “London, UK”, “123 Main Street, Toronto”
4

Submit Your Search

Click the “Submit” button to search for locations
5

Automatic Selection

The app automatically selects the first (most relevant) result from the search

Location Search Features

Intelligent Debouncing

To provide a smooth experience and respect OpenStreetMap’s API limits, Praydo implements smart request throttling:
  • 500ms debounce delay: Waits for you to finish typing before searching
  • 1 request per second limit: Ensures we don’t overload the API
  • Automatic queuing: If you search too quickly, requests are queued and sent when allowed
If you don’t see results immediately, wait a moment - the app may be queuing your request to comply with rate limits.

What Information is Stored

When you select a location, Praydo stores:
  • Place ID: A unique identifier from OpenStreetMap
  • Display Name: The full formatted address (e.g., “New York, NY, United States”)
  • Latitude: Your location’s latitude coordinate
  • Longitude: Your location’s longitude coordinate
This information is stored locally on your device and used to calculate prayer times.

Viewing Your Selected Location

After selecting a location, you’ll see:
  1. Confirmation Card: Shows your selected location with full address and coordinates
  2. Main Dashboard: Your location appears in the bottom widget
  3. Qibla Compass: Automatically updates based on your new location

Location Display Format

The app formats your location name for clean display:
  • Long addresses are truncated with ellipsis
  • The location appears on the main dashboard in the location widget
  • Coordinates are shown in decimal degrees format

OpenStreetMap Attribution

Praydo uses location data from OpenStreetMap, a collaborative mapping project. Location searches are powered by OpenStreetMap’s Nominatim geocoding service.
OpenStreetMap data is provided by thousands of contributors worldwide and is available under the Open Database License. You’ll see the OpenStreetMap attribution in the Settings > Location tab:
Location data provided by OpenStreetMap (© OpenStreetMap contributors)

Troubleshooting Location Issues

No Results Found

Make sure you’ve entered at least 3 characters. Shorter queries typically don’t return results.
Try searching for a nearby city or landmark instead of a specific address.
Check your internet connection. The app requires network access to search locations.

Inaccurate Prayer Times

Double-check the selected location in Settings. The full address and coordinates are displayed.
Try searching for a more specific address rather than just a city name.
Different calculation methods may produce slightly different times. See Calculation Methods.

Privacy and Data

Your location data:
  • Is stored only on your local device
  • Is not sent to Praydo’s servers (Praydo doesn’t have servers)
  • Is only shared with OpenStreetMap when you perform a search
  • Can be changed at any time in Settings
Changing your location will immediately recalculate all prayer times and update the Qibla direction.

Build docs developers (and LLMs) love