What Does Field Syncing/Grouping Mean?
Let’s say that you have a form with an Address field, a Locator button, a Coordinates field, and a Google Map field. And you want that each time when the front-end user drags the marker on the map, the Address field and the Coordinates field will get populated with the location returned from the map field. And the same goes for vice versa; if the user manually enters a set of coordinates or an address, the map marker will then dynamically point to the position of that address or coordinates on the map.
The same applied to the locator button; when a user clicks the locator button, and the browser successfully detects his/her current position, the other geolocation fields will get populated with the current location returned from the browser.
The field that is responsible for the syncing described above is the Geocoder field; The Geocoder field will not only sync between the different geolocation fields but will also perform a complete geocoding of the address or coordinates entered manually by the user, the position of the marker on the map, and the position returned from the locator button.
You can create unlimited geolocation groups; Groups that include any or all of the geolocation fields. It can be a map only, a map and an address field, a map and coordinates, and so on. You get the idea.
This way, for example, you can create a form where users will be able to provide the addresses of two locations: home address and work address. For this task, you can present the users with two geolocation groups of an address field and a Google map field each.
After form submission, you will see on the entry page the complete geocoded information of each of the locations entered by the user. You can as well send the location information via email notification.
The list of the location fields returned by the geocoder are listed below:
- Place Name
- Street Number
- Street Name
- Street ( number + name )
- Street ( name + number )
- Region Name
- Region Code
- Country Name
- Country Code
- Address (the way it was entered by the user )
- Formatted Address ( address returned by Google API )