Configure native maps in FSM Mobile (without ESRI)

When you cannot use ESRI, configure FSM Mobile to enable basic map features and location services through native maps.

Gain access to:

• Basic basemap selection like standard road maps and satellite imagery.

• The ability to show and center the user's current location.

• Agenda interventions on the map.

• Basic address searches.

Requirements to configure native maps

• You only need basic map visualization, general location services, and standard routing.

• There isn’t a requirement to access private, customer-specific geospatial data.

• There is no requirement for advanced ESRI-specific mapping features like:

  • Offline map packages.

  • Redlining.

  • Utility network tracing.

  • Displaying specialized GIS layers.

• You need a cost-effective solution for basic mapping needs.

• Your customers use native maps on Google or Apple and don’t need ESRI features or licensing.

Compare native map features to ESRI SDK in this table.

Prerequisites

To configure native maps, you must have a billing account, a Google API key (for android), and an Apple developer account (for iOS).

• For Google Maps, link a valid billing account linked to your Google Cloud project, even if you stay within Google's free monthly credit.

• For Android devices, get a Google API Key to authenticate and bill for Google's basemap services.

• For iOS devices, get an Apple Developer account to configure the iOS platform.

Configure native maps in Android

To make FSM Mobile default to native map functionalities:

1. Generate a Google API Key. See Use API Keys | Maps Embed API | Google for Developers.

   1. Sign in to your Google Cloud Console.

   2. Click APIs & Services > Credentials.

   3. Create a new API key:

      1. Restrict the API Key to your Android application by package name and SHA-1 certificate fingerprint.

      2. Enable Google Maps Platform APIs (e.g. Maps SDK for Android).

2. Link your Google Cloud project with the API key to a valid billing account.

   • ⚠️ Important: Usage beyond Google’s $200 monthly credit may incur charges.

3. Integrate the API Key into your FSM Mobile Android application project:

   • Note: While methods vary on your FSM Mobile build process, you can add the key to your AndroidManifest.xml file or build.gradle scripts.

Configure native maps in iOS

Apple Maps is already integrated into the OS, so there is no additional configuration required.

Check and monitor the configuration

• Test that native map features load correctly and provide the expected basic functionalities on both Android and iOS devices.

• To manage costs and stay within your budget, regularly monitor your Google Maps API usage in the Google Cloud Console.

• Review features to determine if you need to upgrade to ESRI integration for access to GIS functionalities or private data.