Map Settings
To access the map settings, tap
at the top left corner of the screen.
Maps API:
You can select the software platform that provides the maps and their rendering. The default option is Google Maps. Alternatively, you can choose the OpenStreetMap platform (https://www.openstreetmap.org/). OpenStreetMap is an open-source project that allows users to add their own objects to the map.
Google Maps allows you to choose between different types of maps—schematic, satellite photo, or hybrid version— and works only in online mode, meaning the displayed sections of the map are downloaded by the application from the Google server.
OpenStreetMap displays the map only as a schema. You can choose between online mode, where the map is downloaded as raster image tiles from the servers of OpenStreetMap partner companies, and offline mode, where preloaded files with vector maps are used for display (see below for details). OpenStreetMap draws markers much faster than Google Maps, making it more convenient for very large tracks.
By default, only the basic map settings are shown. To view all the settings, select "Advanced" in the first group of settings. Later in the text, the advanced settings are highlighted in blue.
The settings for Google Maps and OpenStreetMap differ slightly. The specific differences are listed at the end of the page.
Marker colors indicate: select the value that determines how the markers are colored. This can be either the dose rate or the count rate.
Save the coordinates in the database:
Never: The coordinates of your smartphone's current location are not stored in the database (log).
Only when recording a track: The coordinates of your smartphone's current location are entered into the database only when recording a track. This enables you to partially recover a track from the base log as a pseudo track.
Always: If enabled, the location is recorded in the database along with the other information. In the future, you can view the pseudo track on the map and observe changes in the radiation situation related to the selected location. Avoid enabling this option unnecessarily, as determining the location significantly increases the smartphone's power consumption.
Coordinates are stored in the database only if the user enables location detection on the smartphone. Android apps cannot independently turn location detection on or off. The user's permission is necessary to determine the location.
Location:
Location resolution and distance between markers on the map: If the smartphone's location changes by more than the specified number of meters from the previous one, a new point is recorded in the track. Avoid setting values too low, as this will cause the smartphone's GPS module to work more intensively, rapidly increasing the number of track points and slowing down the rendering of the track on the map.
Ignore a location if its measurement accuracy is worse than:If the accuracy of the position measurement is worse (greater than) the specified value, the application will ignore the system message about the position change. For example, if you specify to ignore locations with a measurement accuracy worse than 20 meters, and the system reports that the location has changed, but the measurement accuracy is ± 22 meters, then this location change will be ignored.
Ignore a location if the distance to the previous point is less than:If the distance between the previous point and the current point is less than the specified value, the application will ignore the system message about the location change. The combination of the last two options helps eliminate situations where the system reports small changes in geolocation coordinates measured with poor accuracy.
In the “Markers” group, you can choose how the circle markers will be displayed on the map:
- Minimum and maximum dose rate/count rate values for the markerdefine the range of measured dose rate/count rate levels displayed on the map. Points with levels outside the specified range are not displayed, and their values are not considered when coloring markers. These values are automatically adjusted when the track is explicitly or implicitly autocolored.
- Automatically adjust minimum and maximum values: If a marker added to the track has a dose rate value that exceeds the boundaries of the levels displayed on the map ("Minimum and maximum dose rate value for the marker"), adjust the corresponding boundary so the marker is visible. For example, if the maximum limit is set to 120 μR/h and the dose rate of the next marker is 140 μR/h, the maximum displayed value will become 140 μR/h.
- Automatically select minimum and maximum values when loading a track:equivalent to pressing the auto-coloring button after loading a track. The range of the displayed values is set to the minimum and maximum values of the track, with a ±10% margin.
- Display markers where the dose rate/count rate value is out of bounds as defined by the color scale:if this option is disabled, only those points with dose rate levels between the values defined by the sliders will be displayed on the map. Points with values below the purple slider (for example, less than 40.5 μR/h) and above the red slider (77.2 μR/h) will not be displayed.
- Connect markers with a line:Draw a dashed line connecting the markers. This helps to display the intended trajectory of movement if the markers are far apart, but it slows down rendering.
- Automatically color markers based on dose rate/count rate values: set colors (including during the track recording process) so that purple represents the minimum dose rate in the track, and red represents the maximum value. The triangles on the color bar will be positioned accordingly.If you move one of the triangles, this option will be disabled. Keep in mind that automatically coloring markers with a large number of points can slow down the application.
- Enable the auto-coloring option when loading a new track:If auto-coloring was disabled, for instance, due to manual adjustments to the color scale, it will be automatically re-enabled when loading another track or starting to record a new one.
- Disable the stroke of raw data markers: do not outline live markers (for which the dose rate value has not yet been transmitted by the device) with a thick gray line.
- Marker size: you can choose the diameter of the circles.
- Marker transparency: you can choose the level of transparency for the circles.
- Markers stroke: Marker circles are outlined with a semi-transparent gray line, allowing you to see them as a set of circles rather than a solid line if the markers partially overlap. At small map scales, the stroke can obscure the colors of the circles, so you can disable the stroke or set it to turn off automatically at small scales. The track renders slightly faster when the stroke is off.
- Decimation of markers: You can choose an additional criterion to determine how markers are decimated when added to the map, which helps speed up the rendering of large tracks. When a new marker is added, the application compares its parameters with those of the previously added marker. The next marker is NOT added if the following conditions are met simultaneously:
1. The distance between this marker and the previous one is less than specified in the selected criterion (1/4 of the marker radius, 1/2 of the radius, or the whole radius).
2. The difference in the dose rate between this marker and the previous one does not exceed 10% of the dose rate value of the previous marker.
Decimation of markers only affects their display on the map. This setting does not impact the process of recording a track; non-displayed markers are not removed from the track. - Marker palette: you can choose the color palette used to draw the markers.
- Map Auto-Centering: If, during the process of recording a track, you move the map to the side (for example, to view another part of the map), the map will automatically recenter to your current location after a specified time.
- Track Length Calculation:When calculating the track length, do not include points where the location accuracy is worse than specified. This ensures a more accurate calculation of the track length.
- "Record" button action: you can choose the action to perform when you tap the "Record" button on the map window toolbar.
- When loading a track: you can choose what to display when opening a track on the map: the start of the track, its end, or automatically adjust the scale and position of the map so that the entire track fits on the screen.
Options:
- Automatically rotate the map in the direction of movement when recording a track: if this option is enabled, the map will rotate during track recording so that the direction of movement is from the bottom to the top (from the bottom edge of the screen to the top).
- Display location accuracy: Display information about the accuracy of the last determined location in the upper left corner of the map. This function works only when track recording is enabled. If the location was recorded in the track, the text color in the window will be black; otherwise, it will be red (indicating that the conditions for recording coordinates are not met).
- Display track length: show track length information in the upper left corner of the map.
- Display movement speed: show the speed in the upper left corner of the map. This information is provided by the system; the application does not calculate the speed and displays it as is. Speed information may be unreliable due to, for example, low accuracy in location determination.
- Show movement direction: Display the direction of travel in the upper left corner of the map. This information is provided by the system. By default, the direction is indicated by one or two letters: N - north, SE - southeast, etc. If you select "Detailed direction (3 letters)" below, the direction will be represented by one, two, or three letters: N - north, SE - southeast, WNW - west-northwest, etc.
- Keep the smartphone screen on when the map is active: the smartphone screen will remain on if a map is displayed.
Some location-related settings can be found in the application settings.
You can import a track using the
button. The system file picker will open.
Export Settings (“Share”)
The Radiacode application can export a track in several formats:
- in its own rctrk format, which is a text format and can be imported back into the application on another smartphone.
- in json format, which is compatible with the export/import format of the Radiacode iOS app. JSON files have the same .rctrk extension as native rctrk format files.
- in gpx format (a free text format for storing and exchanging GPS data). GPX files can be opened in a browser with various viewing tools. When exporting the GPX file, the application specifies the dose rate value in micro-roentgen as the altitude above sea level.
- in kmz format (compressed .kml) for viewing in Google Earth (https://earth.google.com/) and in other programs that support the .kml/.kmz format.
When exporting a track in the .kmz format, you can configure the following settings:
- Marker size: By default, Google Earth draws markers at an automatically selected size. This setting allows you to control the marker size in Google Earth.
- Marker transparency:You can select the level of transparency for the markers: 0% means opaque, while 75% means almost transparent.
- Decimation of markers: do not add a marker to the file if the distance in meters between it and the previous marker is less than the specified value, and the difference in dose rate values is not significant. This helps reduce the number of markers on the map. The same algorithms used for drawing a track in the application are applied for decimation.
- HTML in point descriptions: each point is assigned a text string that is displayed in Google Earth when the marker is clicked—date/time, dose rate, and location accuracy. Google Earth allows the use of HTML markup in descriptions, which makes the text more readable. However, not all programs that work with the .kmz format interpret HTML correctly, and for such programs, you can disable HTML in the text.
Settings specific to Google Maps:
In the “Map type” field, you can choose how the map will appear: a diagram, a satellite photo, or a hybrid version.
Theme for the "Scheme" mode: you can choose a map theme: light (the default), dark, or let the app select the theme based on the smartphone's light sensor. In this case, the theme switches automatically if the light level changes and remains stable for 10 seconds. Due to the use of the ambient light sensor, the application's power consumption may increase slightly.
Do not add markers to the map outside the displayed area: this option can optimize map performance when there are many points in the track. If the number of points exceeds 500, then when moving and scaling the map, all markers are removed and only those within the visible map area are re-added. This causes track markers to blink, but the map is rendered faster due to the limited number of markers. The effectiveness of this technology depends on the ratio of visible markers to their total number in the track (if the entire track is displayed on the map, the efficiency may even be negative), as well as the speed of the smartphone.
Show traffic:Request the maps to display traffic on the roads. If traffic information is available, the maps will show it.
Settings specific to OpenStreetMap:
OpenStreetMap map source: by default (online), the option where the map is loaded as pre-rendered raster image tiles from the servers of OpenStreetMap's partner companies is used. The alternative is to work with maps in offline mode, meaning no Internet connection is required. The maps are sourced from vector map files, which you need to download yourself from one of the sites listed on the page https://download.mapsforge.org/ (it's more convenient to do this with a computer) and place them in the RadiaCode app folder on your smartphone named /sdcard/Android/data/com.almacode.radiacode/files/Maps.
Currently, the Mapsforge library does not support working with files due to the access restrictions imposed by Android system versions 11+. Therefore, the map files must be placed in the folder mentioned above.
In offline mode, map rendering, which involves converting vector information into an image, is performed by the Mapsforge library integrated into the application. This process requires some smartphone processing resources. When you move the map around the screen and zoom in, the app will consume more power than in online mode.
Map theme: In offline mode, you can choose between two display options, which primarily differ in their color palettes.
Image scaling: In online mode, the application retrieves low-resolution images of map areas. On high-resolution smartphone screens, the text on these maps may appear too small and might require image scaling. After scaling, the final image might look slightly blurry, but you must balance image quality with text size. You can find the optimal ratio by manually adjusting the scale. Offline mode doesn't have this issue, but you can still experiment with the scale.
Updated: Jan 9, 2026