Map V2 Component

Label Text

Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field.

User-friendly labels make your module more accessible. Keep labels short and descriptive (a word or two) using title case. For longer entries, use sentence case.

Hide Field

Displays or hides the component from view. Setting Hide Field to (ON) hides the component in Express View. Setting it to (OFF) displays the component. The component is always visible in the Module Builder.

By default, Hide Field is set to (OFF).

Reveal a hidden component by using a logic component's  Outputs table  with the Type set to visible.

Make Map Draggable

Set to (ON) to let end-users adjust the map view when clicking and dragging inside the map view port.

Allow Map Zoom

Set to (checked) to let end-users zoom in or out using ⌘ (Apple Key) + Mousewheel Scroll or ⊞ (Windows Key) + Mousewheel Scroll.

Allow Satelite View

Set to (checked) to insert  a two-dimensional map and Satellite imagery buttons to the map view in Express View.

Allow Fullscreen View

Set to (checked) to display a Full Screen button in the top-right corner of the map view in Express View. When end-users click the Full Screen button, the map expands to full-screen view.

Allow Street View

Set to (checked) to insert the (Street View) icon into the bottom-right corner of the map view in Express View. End-Users can click and drag the (Street View) icon onto the map, placing them in the ground-level Street View.

Learn more about street view here: https://www.google.com/streetview/.

Input Behavior

Controls how end-users interact with the component. Choose from the following options:

• Enable User Input: Allow end-users to view and enter data in this field.

• Disable User Input: Prevents end-users from entering data in the field, but lets them view it. In the Module Builder, the field’s background displays as gray. In Express View, when end-users hover over the field, their cursor displays with a prohibited symbol.

• Read Only - Legacy: Prevents end-users from entering data and replaces the field with the component’s data value. If no value is provided, the component displays None.

Multiple Values

Enter a formatted address string for the map to begin on.

Table View

Displays the value in the table view of the submission data.

Store in Database                    

The Store Data in Database setting affects how data persists through your application. When set to (ON), Unqork stores values entered into the field to the database (server-side submission). This occurs in three scenarios:

• Navigating between Panels in a Navigation component. On navigation between pages (Panels), the component’s value saves to the database.

• Triggering a module save event using a Button component with an Action Type of Save.

• Navigating between screens of a workflow. On navigation between screens, the component’s value saves to the database.

By default, workflows persist data from all fields in the client-side submission when navigating between screens. However, only values from fields with Store Data in Database enabled store in the server-side submission.

Set the toggle to (OFF) when you don’t want to store the values from this field in the database.

When using a Plug-In to remote execute a module, ensure data moving between modules is persistent. You can optionally enable Store Data in Database for components in the source module. But any components in the API module whose values are included in an API response must have Store Data in Database enabled. When a component’s data is not persistent, the data isn't included in an API call's response. So, Plug-Ins or external services requesting data from the API module can't receive non-persistent data in the response

Store Data in Database also affects what data is tracked using Unqork’s built-in tracker. When the Enable Tracker and Track Value toggles are set to (ON) in Module Settings, only values from fields with Store Data in Database enabled are tracked.

Data Reference Key                    

Enter the Property ID of the component that contains a formatted address string. If a valid address exists, moves the map view to the address location and places a pin on it.

To retrieve an address from an Address Search component, use a Data Workflow Get operator to extract the formatted address.

Google Key                    

Enter an API key  to access Google's Maps API.

*This field is required to use the Map V2 component.

Acquire an API key here:  https://developers.google.com/maps/documentation/javascript/get-api-key.

The API Key in this field is hard-coded and cannot be dynamically changed.

Required

Set to (ON) to make this component required. However, this component does not receive user input and no validation occurs.

Debounce the Calls After                    

The number of milliseconds that pass before this component calls the Google Maps API using the Data Reference Key value.

If your Data Reference Key dynamically updates, increase the value to reduce the call frequency to the Google Maps API.

The default value is 600 ms.

The Default Location on Browser Load                    

Enter a formatted address string for the map to begin on.

Default Zoom Level                    

The map's zoom level based on the location set in The Default Location on Browser Load field. Set a value between 1 (World Map) and 22 (Street Level).

The default value is 8.

Point Zoom Level                    

The level of zoom after Set a value between 1 (World Map) and 22 (Street Level).

The default for this setting is 15.

Height of Map, In Pixels or %                    

Set the height of the map view port in pixels (px).

The default value is 400px.

This setting accepts only pixel (px) values at this time.

Width of Map, In Pixels or %                    

Set the width of the map view port in pixels (px) or percentage (%).

The default value is 100%.

Custom CSS Class                        

Enter a Custom CSS Class to apply to your component. Custom CSS lets you maintain a consistent look and feel when the field or element is part of a template or multiple modules.

Updated CSS styling applies to all components that reference this custom class name.