Google Map Widget

The Google Map Widget embeds an interactive map on your site that automatically zooms to and highlights the visitor’s nearest physical location — branch office, retail store, service center, whatever you have. It’s similar to a “Store Finder,” except no input is required from the visitor: their nearest location is selected automatically using their IP geolocation, GPS (if available), or zip code data Personyze has on file.

Good fits for the Map Widget

• Multi-location retailers showing visitors the closest store.
• Service businesses highlighting the nearest branch or technician territory.
• Healthcare / clinics directing patients to the closest practice.
• Events or pop-ups showing the nearest upcoming event date for visitors in different cities.
• Franchise sites where each location has different inventory, hours, or contact info.

How location detection works

Personyze identifies the visitor’s location through a cascading priority:

1. GPS / browser geolocation — most accurate, but requires the visitor to grant permission. Used when available.
2. IP geolocation — accurate to city level for most visitors, used as the default.
3. Profile zip code — for known/logged-in visitors with a stored zip code, this overrides IP-based detection.

The widget then calculates the distance from the visitor to each of your configured locations and highlights the closest one on the map.

Setting up the widget

1. Configure your locations. Upload a CSV or feed of your locations with at minimum: name, latitude, longitude, address. Optional fields like phone, hours, and image URL show in the location info card.
2. Build the campaign. Create a new campaign and choose the Google Map widget action. The wizard walks you through targeting and placement.
3. Choose where to render. Drop the map into a placeholder you’ve defined in your site’s HTML, or have Personyze render it floating in a specific page region.
4. Customize the location info display. Decide whether each location’s details appear in a floating div over the map, beside the map, or in a popover when the user clicks the pin.

Customization options

• Map style. Use Google’s standard map, satellite, or terrain view. You can also apply custom Google Maps styles for branded color schemes.
• Pin appearance. Default Google pins or custom branded markers. Different pin styles for different location types (corporate, retail, partner) supported.
• Default zoom and radius. How tightly the map zooms in to the nearest location, and whether other nearby locations also appear.
• Location-specific content. Each pin’s info card can include the location’s address, phone, hours, photos, and a CTA link (e.g., “Get directions” or “Visit this store’s page”).