How the Google Map Field Works:

1. Activate Google Maps API: Before using the widget, you must activate your Google Maps API key once. The key is necessary to enable the address search and map functionalities. If you don't have an API key, you can easily obtain one from the Google Maps Platform.
2. Start Typing an Address: As soon as the user starts typing an address in the field, the widget communicates with Google Maps to suggest possible address matches in real-time. This provides an easy way to find the correct address without having to manually enter the full details.
3. Select an Address: After typing, the user can choose from the list of suggested addresses. Once an address is selected, it is automatically saved to the field. The selected address is stored in its proper format, ready for use throughout the application.
4. Open the Map View: To ensure the address is correct, the user can click the pin icon. This opens a map view of the selected address, which provides a visual representation of the location.
5. Update the Address on the Map: If the user wants to make adjustments to the selected address, they can drag the pin on the map to a new location. The address will automatically update to reflect the new position, ensuring that the stored address is always accurate.