Place
The Place element lets visitors search a place or address and returns structured location data you can use in formulas. Use it when a visitor's location drives the result, for example a service area check, a travel-cost calculation, or a solar calculator.
Properties
The properties live in the inspector under the Place group.
Property | What it does | Default |
|---|---|---|
Placeholder | Text shown in the field before a visitor types | Type to find a place... |
Required | Forces the visitor to choose a place before continuing | Off |
Restrict to countries | Limits the search to the countries you select | |
Logic | Controls when the element is shown or enabled |
The inspector's placeholder field shows "Add placeholder". Restrict to countries opens a conditional record editor with a Country field whose select shows "Select a country", and it accepts a maximum of five records. The Place element has no "Go to next view when answered" property.
References
References expose the chosen place as data you can use in formulas and other elements. Assign a reference to store the place in a variable. Reference names use the Q prefix.
Address: the formatted address of the chosen place.
Latitude: the latitude of the chosen place.
Longitude: the longitude of the chosen place.
Country: the country of the chosen place.
Province: the province or state of the chosen place.
Locality: the city or town of the chosen place.
Sublocality: the district or neighbourhood of the chosen place.
Postalcode: the postal code of the chosen place.
Route: the street name of the chosen place.
Streetnumber: the street number of the chosen place.
Styling
The Place element can be styled per state and per part of the element.
Style states: Active, Default, Disabled, Error, Focus, Hover, Placeholder.
Named targets: wrapper, trigger, input, clear, clear-icon, menu, menu-item, error-label.
Named styles: Place, Place - brand background, Place - underlined.
Apply general styling from the Style tab: quick styles, style sets, and CSS overrides per state and per breakpoint. See the styling reference for the full system.
Related articles
UI Elements: overview of the elements.
FormulaScript Overview: using formulas in properties.