How-To Guide for "Map Geo Point Field" and "Map Select Geo Point Field"

Overview

Map Geo Point Field is useful when we need the data form to capture the specific location of the point where it is currently located. On the other hand, Map Select Geo Point Field allows us to choose an exact location by interacting with a map.

Key Features

• Location Precision: Both fields allow precise location selection, either automatically (Map Geo Point Field) or manually (Map Select Geo Point Field).
• Interactive Map Integration: Both fields integrate with interactive maps, enabling users to either get their location or select a point.
• Latitude and Longitude Storage: Locations are stored as latitude and longitude coordinates for accurate future reference.

Steps to Configure the Fields

Step 1: Select Field Type

1. Navigate to your Data Form configuration.
2. Add a new field or edit an existing one.
3. From the Field Type dropdown, select Map Geo Point Field or Map Select Geo Point Field.

Step 2: Configure Field Details

• Field Name: Assign a unique name for the field (e.g., Location).
• Field Label: Provide a descriptive label for the form display (e.g., "User Location").
• Explanation of the Empty Field: Add an optional description to guide users. Example:
  "Select the location."or "Please allow acces to your current location"
• Alignment: Specify the field alignment in the form:
  • Left: Default alignment.
  • Center or Right: Based on your layout preference.
• Field Width: Define the width of the field (e.g., 100% width for full-row display).

Step 3: Enable Additional Options

• Required Field: Check this box if the field must always contain a value.
• Blank on Load: Enable this if the field should remain empty until data is loaded or generated.

Step 4: Enable MapBox Integration (Only for Map Select Geo Point Field)

1. Go to www.mapbox.com and get a public token.
2. Navigate to Other Data Tools > Integrations.
3. Set up the public token in the mapbox API token field.
4. Click save.

Step 4: Save and Test

1. Click SAVE after configuring the field.
2. Test the form by ensuring:
   • You grant access to your current location when using a Map Geo Point Field.
   • You select a location manually when using a Map Selector Geo Point Field.

Troubleshooting

Example Configuration

Scenario: Capture the user’s current location using a Map Geo Point Field.

• Field Details:
  • Field Name: user_location
  • Field Label: "Current Location"
  • Field Type: Map Geo Point Field

Example Output

40.7128, -74.0060

Scenario: Allow users to manually select a location on a map using a Map Select Geo Point Field.

• Field Details:
  • Field Name: selected_location
  • Field Label: "Selected Location"
  • Field Type: Map Select Geo Point Field
• User Selection:

Example Output :

12.363142,-1.529773

Best Practices

• Provide Clear Field Names:
  Use meaningful and descriptive names that indicate the field's purpose (e.g., user_location, destination_location).

• Offer Descriptive Labels:
  Label the fields with clear and user-friendly text to guide users, such as "Current Location" or "Select Your Location".

• Utilize the Correct Field Type:

  • Use Map Geo Point Field when capturing the user’s current location automatically.
  • Use Map Select Geo Point Field when allowing the user to manually select a location on the map.

Summary

The Map Geo Point Field and Map Select Geo Point Field provide powerful options for collecting geographic data in your forms. They provide flexibility for use cases where location data is required, whether automatically gathering the user's position or letting the user choose a specific spot on the map.