Add geolocation

Geolocation is the identification of the real-world geographic ___location of an object. Geolocation is closely related to the use of positioning systems, but places a greater emphasis on determining a meaningful ___location (for example, a street address) rather than just a set of geographic coordinates. The word geolocation can also mean the latitude and longitude coordinates of a particular ___location.

A form can be configured to display a map control either to display an existing ___location as a pin on a map or to provide the ability for the user to specify a ___location.

If the form or address line field is editable and this field is blank, when the webpage loads it will prompt the user asking if they would like to share their ___location. If they choose to share their ___location, the map will be updated with their currently detected ___location. The user can refine the ___location of the pin by dragging it. If the user chooses not to share their ___location, they can manually specify the ___location in the fields provided and the mapping service will be queried to find the ___location, update latitude and longitude, and reposition the pin on the map accordingly.

Add geolocation

To add geolocation functionality to a form, the following tasks must be completed.

Form customization

Edit the basic form by using the form designer and make the following modifications:

1. Create a new section and provide an appropriate label, for example Map. This section will contain the map.

2. Set the name of the section to section_map or a name that ends with section_map, for example contoso_section_map. This name is important because the form engine looks for a section with this name to determine when to render a map.

3. Add a new or existing field that will store the formatted address, and add it to the Map section created in the previous step.

4. Create a new section and provide an appropriate label, for example Location. This section will contain the address fields for the selected ___location.

5. Add the required address fields to the Location section created in the previous step:

   • Address Line
   • City
   • County
   • State/Province
   • Country/Region
   • Zip/Postal Code
   • Latitude
   • Longitude

The resulting form should look similar to the following. You can choose different display names for these fields. You can also choose to lay out these sections any way you prefer.

Site settings

Geolocation with map functionality on forms requires configuration settings to complete requests with the mapping service REST endpoint. The following site settings are used to configure the ___location service.

Field configurations

The map control requires additional configuration to tell it what the IDs of the various ___location fields are, so it can assign values to them or retrieve values from them. The configuration depends on the type of managed form.

• For basic forms, see Geolocation configuration for basic forms.

• For multistep forms, see Geolocation configuration for multistep forms.