Preferences
Tip: Use the Preferences Generator for an interactive way to create your configuration file without writing JSON manually.
Introduction
PTV Navigator G2 supports configuration through a preferences file. This allows fleet managers and integrators to pre-configure the navigation application for their specific use cases without requiring manual setup by end users.
With preferences you can:
- Pre-configure the app language, theme, and units
- Set vehicle profiles and restrict profile editing
- Define routing preferences (avoid tolls, ferries, tunnels, etc.)
- Control map download permissions and behavior
- Integrate an external application button for seamless app switching
- Restrict user access to specific settings
- Configure assistant and safety features
What is the preferences_import.json?
The preferences_import.json is a configuration file that allows you to programmatically set application preferences for PTV Navigator G2. Instead of manually configuring each device through the user interface, you can deploy a single JSON file that automatically applies all desired settings when the application starts.
Use Cases:
- MDM Deployment: Push standardized configurations to a fleet of devices via Mobile Device Management systems
- Initial Setup Automation: Skip manual configuration steps for new installations
- Corporate Policy Enforcement: Ensure specific settings (like restricting logout or profile changes) are applied consistently
- Integration Scenarios: Configure external app buttons for seamless switching between PTV Navigator G2 and your fleet management application
File Structure
The preferences file follows a simple JSON structure:
{
"data": [
{
"keyName": "variable_name",
"defaultOrValue": "value",
"type": "TYPE"
}
],
"version": 1.0
}
Structure Elements:
| Element | Description |
|---|---|
data |
Array containing all preference items |
keyName |
The unique identifier for the setting |
defaultOrValue |
The value to apply |
type |
Data type: STRING, BOOLEAN, INT, LONG, FLOAT, or STRINGSET |
version |
File format version (always 1.0) |
How to Export Preferences
To export the current preferences from a device:
- Enable developer mode by tapping 25 times on the build date (Menu → System → Build date)
- Navigate to Menu → System → Export Preferences (only visible in developer mode)
- The exported file will be saved to the device
How to Import Preferences
Remote Configuration (Recommended)
You can upload a preferences JSON file for each license key via the Remote Configuration tab in the license key management portal. PTV Navigator G2 automatically applies this configuration once after initial login. Note that subsequent changes to the JSON file are not automatically synchronized — the configuration is only applied during the first login.
Manual Import
To import preferences manually:
- Name the file
preferences_import.json - Place it in the appropriate directory depending on your APK version:
- Play Store version:
/sdcard/Android/data/com.ptvlogistics.navigator/files/ - myPTV.com version:
/sdcard/Android/data/com.ptv.navigation.app/files/ - Restart the application
- The file will be automatically imported and deleted
- A toast message will confirm the successful import
Alternative: Use the Preferences Generator tool to create configuration files through a visual interface.
Available Variables
Setup / General Settings
license_key
Import a license key for automated login. The license key will only be imported but not exported.
| Property | Value |
|---|---|
| keyName | license_key |
| Type | STRING |
| Default | (empty) |
{"keyName": "license_key", "defaultOrValue": "YourLicenseKey", "type": "STRING"}
settings_use_device_language
Use the Android device language setting or the language configured in PTV Navigator G2.
| Property | Value |
|---|---|
| keyName | settings_use_device_language |
| Type | BOOLEAN |
| Default | true |
{"keyName": "settings_use_device_language", "defaultOrValue": true, "type": "BOOLEAN"}
settings_language
Set the UI language. Note: settings_use_device_language must be false for this setting to take effect.
| Property | Value |
|---|---|
| keyName | settings_language |
| Type | STRING |
| Default | en-GB |
Available Language Codes:
af-ZA, ar, eu-ES, bg-BG, ca-ES, zh-CN, zh-TW, cs-CZ, da-DK, nl-BE, nl-NL, en-AU, en-NZ, en-GB, en-US, et-EE, fi-FI, fr-CA, fr-FR, gl-ES, de-DE, el-GR, hr-HR, he-IL, hu-HU, id-ID, it-IT, kk-KZ, lv-LV, lt-LT, ms-MY, nb-NO, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sr-RS, sk-SK, sl-SL, es-ES, sv-SE, th-TH, tr-TR, uk-UA, vi-VN
{"keyName": "settings_language", "defaultOrValue": "de-DE", "type": "STRING"}
settings_theme
Set the app design to automatic, light, or dark mode.
| Property | Value |
|---|---|
| keyName | settings_theme |
| Type | STRING |
| Default | automatic |
| Values | automatic, light, dark |
{"keyName": "settings_theme", "defaultOrValue": "light", "type": "STRING"}
settings_skip_intro
Skip the intro dialogue upon startup.
| Property | Value |
|---|---|
| keyName | settings_skip_intro |
| Type | BOOLEAN |
| Default | false |
{"keyName": "settings_skip_intro", "defaultOrValue": true, "type": "BOOLEAN"}
settings_units
Set measurement units to metric or imperial.
| Property | Value |
|---|---|
| keyName | settings_units |
| Type | STRING |
| Default | METRIC |
| Values | METRIC (km & metric tons), IMPERIAL (miles & lbs) |
{"keyName": "settings_units", "defaultOrValue": "METRIC", "type": "STRING"}
settings_connection_mode
Set the connection mode for routing and map data.
| Property | Value |
|---|---|
| keyName | settings_connection_mode |
| Type | STRING |
| Default | online |
| Values | online, hybrid |
{"keyName": "settings_connection_mode", "defaultOrValue": "hybrid", "type": "STRING"}
settings_allow_connection_mode_switching
Allow or prevent users from switching connection modes.
| Property | Value |
|---|---|
| keyName | settings_allow_connection_mode_switching |
| Type | BOOLEAN |
| Default | true |
{"keyName": "settings_allow_connection_mode_switching", "defaultOrValue": false, "type": "BOOLEAN"}
device_description_startup_request
Request the device description from the user upon startup. The description is visible in the License Key app under "Devices".
| Property | Value |
|---|---|
| keyName | device_description_startup_request |
| Type | BOOLEAN |
| Default | true |
{"keyName": "device_description_startup_request", "defaultOrValue": false, "type": "BOOLEAN"}
settings_device_description_edit
Allow users to change the device description in the settings menu.
| Property | Value |
|---|---|
| keyName | settings_device_description_edit |
| Type | BOOLEAN |
| Default | true |
{"keyName": "settings_device_description_edit", "defaultOrValue": true, "type": "BOOLEAN"}
Vehicle Profile
settings_profile
Set the active vehicle profile. Provide the filename of the profile available in the profiles folder.
| Property | Value |
|---|---|
| keyName | settings_profile |
| Type | STRING |
| Default | truck40.json |
{"keyName": "settings_profile", "defaultOrValue": "truck40.json", "type": "STRING"}
settings_profile_deny_edit
Prevent users from editing or adding vehicle profiles. Hides the edit and add buttons in the UI.
| Property | Value |
|---|---|
| keyName | settings_profile_deny_edit |
| Type | BOOLEAN |
| Default | false |
{"keyName": "settings_profile_deny_edit", "defaultOrValue": true, "type": "BOOLEAN"}
settings_profile_deny_switch
Prevent users from switching vehicle profiles in the UI. Profiles can still be set via the API.
| Property | Value |
|---|---|
| keyName | settings_profile_deny_switch |
| Type | BOOLEAN |
| Default | false |
{"keyName": "settings_profile_deny_switch", "defaultOrValue": true, "type": "BOOLEAN"}
Routing
routing_optimization
Define how routes should be optimized.
| Property | Value |
|---|---|
| keyName | routing_optimization |
| Type | STRING |
| Default | Fast |
| Values | Fast, Short, Efficient |
{"keyName": "routing_optimization", "defaultOrValue": "Fast", "type": "STRING"}
routing_avoid_ferry
Avoid or allow use of ferries during routing.
| Property | Value |
|---|---|
| keyName | routing_avoid_ferry |
| Type | BOOLEAN |
| Default | false |
{"keyName": "routing_avoid_ferry", "defaultOrValue": true, "type": "BOOLEAN"}
routing_avoid_motorways
Avoid or allow use of motorways during routing.
| Property | Value |
|---|---|
| keyName | routing_avoid_motorways |
| Type | BOOLEAN |
| Default | false |
{"keyName": "routing_avoid_motorways", "defaultOrValue": true, "type": "BOOLEAN"}
routing_avoid_toll_roads
Avoid or allow use of toll roads during routing.
| Property | Value |
|---|---|
| keyName | routing_avoid_toll_roads |
| Type | BOOLEAN |
| Default | false |
{"keyName": "routing_avoid_toll_roads", "defaultOrValue": true, "type": "BOOLEAN"}
settings_routing_avoid_unpaved_roads
Avoid or allow use of unpaved roads during routing.
| Property | Value |
|---|---|
| keyName | settings_routing_avoid_unpaved_roads |
| Type | BOOLEAN |
| Default | false |
{"keyName": "settings_routing_avoid_unpaved_roads", "defaultOrValue": true, "type": "BOOLEAN"}
routing_avoid_tunnels
Avoid or allow use of tunnels during routing.
| Property | Value |
|---|---|
| keyName | routing_avoid_tunnels |
| Type | BOOLEAN |
| Default | false |
{"keyName": "routing_avoid_tunnels", "defaultOrValue": true, "type": "BOOLEAN"}
routing_avoid_border_crossings
Avoid or allow border crossings during routing.
| Property | Value |
|---|---|
| keyName | routing_avoid_border_crossings |
| Type | BOOLEAN |
| Default | false |
{"keyName": "routing_avoid_border_crossings", "defaultOrValue": true, "type": "BOOLEAN"}
settings_routing_avoid_low_emission_zones
Avoid or allow routing through environmental/low emission zones.
| Property | Value |
|---|---|
| keyName | settings_routing_avoid_low_emission_zones |
| Type | BOOLEAN |
| Default | false |
{"keyName": "settings_routing_avoid_low_emission_zones", "defaultOrValue": true, "type": "BOOLEAN"}
Traffic
routing_consider_traffic
Enable or disable traffic consideration for routing.
| Property | Value |
|---|---|
| keyName | routing_consider_traffic |
| Type | BOOLEAN |
| Default | true |
{"keyName": "routing_consider_traffic", "defaultOrValue": true, "type": "BOOLEAN"}
navigation_traffic_delay
Set the minimum traffic delay (in minutes) to trigger rerouting.
| Property | Value |
|---|---|
| keyName | navigation_traffic_delay |
| Type | INT |
| Default | 10 |
| Range | 3 - 30 minutes |
{"keyName": "navigation_traffic_delay", "defaultOrValue": 10, "type": "INT"}
map_show_traffic_incidents
Show or hide traffic incidents on the map.
| Property | Value |
|---|---|
| keyName | map_show_traffic_incidents |
| Type | BOOLEAN |
| Default | true |
{"keyName": "map_show_traffic_incidents", "defaultOrValue": true, "type": "BOOLEAN"}
Map Display
map_show_truck_restrictions
Show or hide truck restrictions on the map.
| Property | Value |
|---|---|
| keyName | map_show_truck_restrictions |
| Type | BOOLEAN |
| Default | true |
{"keyName": "map_show_truck_restrictions", "defaultOrValue": true, "type": "BOOLEAN"}
map_show_hill_shading
Show or hide hill shading layer on the map.
| Property | Value |
|---|---|
| keyName | map_show_hill_shading |
| Type | BOOLEAN |
| Default | false |
{"keyName": "map_show_hill_shading", "defaultOrValue": true, "type": "BOOLEAN"}
User Control / Administration
update_check_enabled
Enable or disable automatic update check for newer versions of PTV Navigator G2. (Available with version >= 9.6.0)
| Property | Value |
|---|---|
| keyName | update_check_enabled |
| Type | BOOLEAN |
| Default | true |
{"keyName": "update_check_enabled", "defaultOrValue": false, "type": "BOOLEAN"}
license_error_show_logout_button
Show or hide the logout button in the license check error screen.
| Property | Value |
|---|---|
| keyName | license_error_show_logout_button |
| Type | BOOLEAN |
| Default | true |
{"keyName": "license_error_show_logout_button", "defaultOrValue": false, "type": "BOOLEAN"}
map_download_allow_download
Enable or disable the ability to download maps.
| Property | Value |
|---|---|
| keyName | map_download_allow_download |
| Type | BOOLEAN |
| Default | true |
{"keyName": "map_download_allow_download", "defaultOrValue": true, "type": "BOOLEAN"}
map_download_show_download_section
Show or hide the download section in the download overview.
| Property | Value |
|---|---|
| keyName | map_download_show_download_section |
| Type | BOOLEAN |
| Default | true |
{"keyName": "map_download_show_download_section", "defaultOrValue": true, "type": "BOOLEAN"}
settings_show_download_button
Show or hide the download button in the main settings menu.
| Property | Value |
|---|---|
| keyName | settings_show_download_button |
| Type | BOOLEAN |
| Default | true |
{"keyName": "settings_show_download_button", "defaultOrValue": false, "type": "BOOLEAN"}
map_download_allow_update
Enable or disable map updates.
| Property | Value |
|---|---|
| keyName | map_download_allow_update |
| Type | BOOLEAN |
| Default | true |
{"keyName": "map_download_allow_update", "defaultOrValue": true, "type": "BOOLEAN"}
map_download_allow_delete
Enable or disable the ability to delete maps.
| Property | Value |
|---|---|
| keyName | map_download_allow_delete |
| Type | BOOLEAN |
| Default | true |
{"keyName": "map_download_allow_delete", "defaultOrValue": false, "type": "BOOLEAN"}
map_download_iso_codes
Automatically download maps for specified countries. Provide country ISO codes as a comma-separated string.
| Property | Value |
|---|---|
| keyName | map_download_iso_codes |
| Type | STRING |
| Default | (empty) |
Available Country Codes:
af, xx_ai, us-al, us-ak, al, dz, ao, ar, ar_no, ar_so, am, au, au-nsw, au_nt, au_qld, au_sa, au_tas, au_vic, au_wa, at, az, bh, bd, by, be, bz, bj, bt, bo, ba, bw, br, br_bap, br_rrg, br_mat, br_msp, br_rjm, br_rss, br_sp, bn, bg, bf, bi, us-ca, kh, cm, ca, ca_ab, ca_bc, ca_mb, ca_no, ca_on, ca_qc, ca-sk, ca_ac, cf, td, cl, cl_no, cl_so, cn, co, cr, ci, hr, cy, cz, cd, dk, dj, ec, eg, sv, gq, er, ee, et, fi, fr, fr_ce, fr_ne, fr_nw, fr_so, fr_sw, gf, ga, gm, ge, de, de_ea, de_nw, de_se, de_sw, de_we, gh, gr, gt, gn, gw, gy, hn, hk, hu, is, in, in_ap, in_br, in_cg, in_dl, in_gj, in_hr, in_jh, in_kl, in_ka, in_mp, in_mhg, in_nes, in_od, in_pb, in_rj, in_ts, in_tn, in_up, in_wb, in_whs, id, id_ce, id_ea, id_we, ir, iq, ie, il, it, it_ce, it_ne, it_nw, it_so, jp, jo, kz, ke, kw, kg, la, lv, lb, lr, ly, lt, lu, mg, mw, my, mv, ml, mt, mr, xx_me, mx, mx_bcs, mx_cea, mx_cwe, mx_chh, mx_dco, mx_mcc, mx_mig, mx_nlt, mx_yea, fm, md, mn, me, ma, mz, mm, na, np, nl, nz, ni, ne, ng, kp, mk, no, pk, pa, py, pe, ph, pl, pf, pt, pr, cg, ro, ru, ru_cc, ru_ea, ru_ce, ru_nw, ru_kv, ru_us, ru_vd, rw, sa, sn, rs, sl, sg, sk, si, so, za, za_ea, za_we, kr, ss, es, es_ne, es_nw, es_so, lk, sd, sr, se, ch, sy, tw, tj, tz, th, th_ea, th_no, th_so, tl, tg, tn, tr, tr_ce, tr_ea, tr_we, tm, ug, ua, ae, gb, gb_ni, gb_no, gb_so, us, us-az, us-ar, us-co, us-ct, us-de, us-dc, us-fl, us-ge, us-id, us-il, us-in, us-ia, us-ks, us-ky, us-la, us-me, us-md, us-ma, us-mi, us-mn, us-ms, us-mo, us-mt, us-ne, us-nv, us-nh, us-nj, us-nm, us-ny, us-nc, us-nd, us-oh, us-ok, us-or, um, us-pa, us-ri, us-sc, us-sd, us-tn, us-tx, us-ut, us-vt, us-va, us-wa, us-wv, us-wi, us-wy, uy, uz, ve, vn, ye, zm, zw
{"keyName": "map_download_iso_codes", "defaultOrValue": "de,at,ch,nl,be,lu", "type": "STRING"}
Mobile Data
mobile_data_allow_map_download
Allow map downloads over mobile network. Caution: Map data can be several GB!
| Property | Value |
|---|---|
| keyName | mobile_data_allow_map_download |
| Type | BOOLEAN |
| Default | false |
{"keyName": "mobile_data_allow_map_download", "defaultOrValue": false, "type": "BOOLEAN"}
mobile_data_allow_app_update
Allow APK updates over mobile network. Caution: APK file size is > 150MB!
| Property | Value |
|---|---|
| keyName | mobile_data_allow_app_update |
| Type | BOOLEAN |
| Default | false |
{"keyName": "mobile_data_allow_app_update", "defaultOrValue": false, "type": "BOOLEAN"}
External Application Integration
Configure an ExtApp button to switch between PTV Navigator G2 and your own application. The button appears in the MainFragment and NavigationFragment.
external_app_package
Package name of the external application.
| Property | Value |
|---|---|
| keyName | external_app_package |
| Type | STRING |
| Default | (empty) |
{"keyName": "external_app_package", "defaultOrValue": "com.example.app", "type": "STRING"}
external_app_class
Activity class name of the external application.
| Property | Value |
|---|---|
| keyName | external_app_class |
| Type | STRING |
| Default | (empty) |
{"keyName": "external_app_class", "defaultOrValue": "com.example.app.MainActivity", "type": "STRING"}
external_app_icon
Icon filename for the ExtApp button. The icon must be placed in the app's files directory depending on your APK version:
- Play Store version: /sdcard/Android/data/com.ptvlogistics.navigator/files/
- myPTV.com version: /sdcard/Android/data/com.ptv.navigation.app/files/
Supported formats: PNG, WebP. Recommended size: 300x300 pixels for Full HD displays.
| Property | Value |
|---|---|
| keyName | external_app_icon |
| Type | STRING |
| Default | (empty) |
{"keyName": "external_app_icon", "defaultOrValue": "app_icon.png", "type": "STRING"}
Complete ExtApp Button Example:
{
"data": [
{"keyName": "external_app_package", "defaultOrValue": "com.example.fleetapp", "type": "STRING"},
{"keyName": "external_app_class", "defaultOrValue": "com.example.fleetapp.MainActivity", "type": "STRING"},
{"keyName": "external_app_icon", "defaultOrValue": "fleet_icon.png", "type": "STRING"}
],
"version": 1.0
}
Assistant / Safety Features
settings_assistant_safety_warner_activated
Activate or deactivate the safety warner. When deactivated, the Assistant menu entries are also removed.
| Property | Value |
|---|---|
| keyName | settings_assistant_safety_warner_activated |
| Type | BOOLEAN |
| Default | true |
{"keyName": "settings_assistant_safety_warner_activated", "defaultOrValue": false, "type": "BOOLEAN"}
settings_assistant_speedwarner_on_off
Enable or disable the speed warner feature.
| Property | Value |
|---|---|
| keyName | settings_assistant_speedwarner_on_off |
| Type | BOOLEAN |
| Default | true |
{"keyName": "settings_assistant_speedwarner_on_off", "defaultOrValue": true, "type": "BOOLEAN"}
settings_assistant_speedwarner_threshold_percentage
Set the speed threshold as a percentage above the speed limit for the speed warner to trigger.
| Property | Value |
|---|---|
| keyName | settings_assistant_speedwarner_threshold_percentage |
| Type | INT |
| Default | 0 |
| Range | 0 - 100 |
{"keyName": "settings_assistant_speedwarner_threshold_percentage", "defaultOrValue": 10, "type": "INT"}
settings_assistant_speedwarner_threshold_kmh
Set the absolute speed threshold in km/h for the speed warner (metric units).
| Property | Value |
|---|---|
| keyName | settings_assistant_speedwarner_threshold_kmh |
| Type | INT |
| Default | 0 |
{"keyName": "settings_assistant_speedwarner_threshold_kmh", "defaultOrValue": 5, "type": "INT"}
settings_assistant_speedwarner_threshold_mph
Set the absolute speed threshold in mph for the speed warner (imperial units).
| Property | Value |
|---|---|
| keyName | settings_assistant_speedwarner_threshold_mph |
| Type | INT |
| Default | 0 |
{"keyName": "settings_assistant_speedwarner_threshold_mph", "defaultOrValue": 5, "type": "INT"}
settings_assistant_poi_categories
Define which POI (Point of Interest) categories are enabled for the assistant.
| Property | Value |
|---|---|
| keyName | settings_assistant_poi_categories |
| Type | STRINGSET |
| Default | (all categories) |
{"keyName": "settings_assistant_poi_categories", "defaultOrValue": ["fuel_station", "rest_area", "parking"], "type": "STRINGSET"}
settings_assistant_poi_max_entries
Maximum number of POI entries to display.
| Property | Value |
|---|---|
| keyName | settings_assistant_poi_max_entries |
| Type | INT |
| Default | 5 |
{"keyName": "settings_assistant_poi_max_entries", "defaultOrValue": 10, "type": "INT"}
settings_assistant_poi_max_detour_duration_in_minutes
Maximum detour duration in minutes for POI suggestions.
| Property | Value |
|---|---|
| keyName | settings_assistant_poi_max_detour_duration_in_minutes |
| Type | INT |
| Default | 15 |
{"keyName": "settings_assistant_poi_max_detour_duration_in_minutes", "defaultOrValue": 20, "type": "INT"}
Variable Reference Table
| Variable | Type | Default | Description |
|---|---|---|---|
license_key |
STRING | (empty) | License key for automated login |
settings_use_device_language |
BOOLEAN | true | Use device language setting |
settings_language |
STRING | en-GB | Manual language setting |
settings_theme |
STRING | automatic | App theme (automatic/light/dark) |
settings_skip_intro |
BOOLEAN | false | Skip intro dialogue |
settings_units |
STRING | METRIC | Measurement units |
settings_connection_mode |
STRING | online | Connection mode (online/hybrid) |
settings_allow_connection_mode_switching |
BOOLEAN | true | Allow mode switching |
device_description_startup_request |
BOOLEAN | true | Request device description on startup |
settings_device_description_edit |
BOOLEAN | true | Allow device description editing |
settings_profile |
STRING | truck40.json | Active vehicle profile |
settings_profile_deny_edit |
BOOLEAN | false | Prevent profile editing |
settings_profile_deny_switch |
BOOLEAN | false | Prevent profile switching |
routing_optimization |
STRING | Fast | Route optimization mode |
routing_avoid_ferry |
BOOLEAN | false | Avoid ferries |
routing_avoid_motorways |
BOOLEAN | false | Avoid motorways |
routing_avoid_toll_roads |
BOOLEAN | false | Avoid toll roads |
settings_routing_avoid_unpaved_roads |
BOOLEAN | false | Avoid unpaved roads |
routing_avoid_tunnels |
BOOLEAN | false | Avoid tunnels |
routing_avoid_border_crossings |
BOOLEAN | false | Avoid border crossings |
settings_routing_avoid_low_emission_zones |
BOOLEAN | false | Avoid environmental zones |
routing_consider_traffic |
BOOLEAN | true | Consider traffic |
navigation_traffic_delay |
INT | 10 | Traffic delay threshold (minutes) |
map_show_traffic_incidents |
BOOLEAN | true | Show traffic incidents |
map_show_truck_restrictions |
BOOLEAN | true | Show truck restrictions |
map_show_hill_shading |
BOOLEAN | false | Show hill shading |
update_check_enabled |
BOOLEAN | true | Enable update checks |
license_error_show_logout_button |
BOOLEAN | true | Show logout button on error |
map_download_allow_download |
BOOLEAN | true | Allow map downloads |
map_download_show_download_section |
BOOLEAN | true | Show download section |
settings_show_download_button |
BOOLEAN | true | Show download button |
map_download_allow_update |
BOOLEAN | true | Allow map updates |
map_download_allow_delete |
BOOLEAN | true | Allow map deletion |
map_download_iso_codes |
STRING | (empty) | Auto-download country codes |
mobile_data_allow_map_download |
BOOLEAN | false | Allow mobile map downloads |
mobile_data_allow_app_update |
BOOLEAN | false | Allow mobile app updates |
external_app_package |
STRING | (empty) | ExtApp package name |
external_app_class |
STRING | (empty) | ExtApp activity class |
external_app_icon |
STRING | (empty) | ExtApp icon filename |
settings_assistant_safety_warner_activated |
BOOLEAN | true | Enable safety warner |
settings_assistant_speedwarner_on_off |
BOOLEAN | true | Enable speed warner |
settings_assistant_speedwarner_threshold_percentage |
INT | 0 | Speed threshold (%) |
settings_assistant_speedwarner_threshold_kmh |
INT | 0 | Speed threshold (km/h) |
settings_assistant_speedwarner_threshold_mph |
INT | 0 | Speed threshold (mph) |
settings_assistant_poi_categories |
STRINGSET | (all) | Enabled POI categories |
settings_assistant_poi_max_entries |
INT | 5 | Max POI entries |
settings_assistant_poi_max_detour_duration_in_minutes |
INT | 15 | Max detour duration |
Example Configurations
MDM Deployment Configuration
Recommended settings when using a Mobile Device Management system:
{
"data": [
{"keyName": "settings_skip_intro", "defaultOrValue": true, "type": "BOOLEAN"},
{"keyName": "settings_connection_mode", "defaultOrValue": "hybrid", "type": "STRING"},
{"keyName": "update_check_enabled", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "license_error_show_logout_button", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "mobile_data_allow_app_update", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "device_description_startup_request", "defaultOrValue": false, "type": "BOOLEAN"}
],
"version": 1.0
}
European Fleet Configuration
Configuration for a European fleet with pre-downloaded maps:
{
"data": [
{"keyName": "settings_connection_mode", "defaultOrValue": "hybrid", "type": "STRING"},
{"keyName": "settings_language", "defaultOrValue": "de-DE", "type": "STRING"},
{"keyName": "settings_use_device_language", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "settings_units", "defaultOrValue": "METRIC", "type": "STRING"},
{"keyName": "map_download_iso_codes", "defaultOrValue": "de,at,ch,nl,be,lu,fr,it,es,pl,cz", "type": "STRING"},
{"keyName": "routing_avoid_toll_roads", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "settings_routing_avoid_unpaved_roads", "defaultOrValue": true, "type": "BOOLEAN"},
{"keyName": "settings_profile_deny_switch", "defaultOrValue": true, "type": "BOOLEAN"}
],
"version": 1.0
}
Locked-Down Configuration
Restrictive configuration for managed devices:
{
"data": [
{"keyName": "settings_skip_intro", "defaultOrValue": true, "type": "BOOLEAN"},
{"keyName": "settings_profile_deny_edit", "defaultOrValue": true, "type": "BOOLEAN"},
{"keyName": "settings_profile_deny_switch", "defaultOrValue": true, "type": "BOOLEAN"},
{"keyName": "license_error_show_logout_button", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "settings_allow_connection_mode_switching", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "update_check_enabled", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "map_download_allow_delete", "defaultOrValue": false, "type": "BOOLEAN"},
{"keyName": "settings_device_description_edit", "defaultOrValue": false, "type": "BOOLEAN"}
],
"version": 1.0
}
For interactive configuration file creation, use the Preferences Generator tool.