FW Real Estate – Documentation

The Map View addon adds interactive map support to FW Real Estate. It places a location map on each property detail page and adds a map-based layout to the property listing page, where visitors can browse all properties as clickable markers on a full-width map.

What It Adds

• Single property map — an embedded map with a location pin appears on every property detail page, giving visitors immediate neighborhood context.
• Listing page map panel — optionally display a map alongside your property list or grid, with each property shown as a marker.
• Map View layout — a full-width map layout for the listing page. Clicking a marker shows a mini-card with the property photo, title, and price.
• Auto-geocoding — when you type an address in the property edit form, the map resolves it to coordinates automatically, so you rarely need to enter latitude and longitude by hand.

Google API Keys — Why Two Are Required

Google Maps requires two separate API keys because the map is used in two different contexts that demand different security restrictions.

• Google Maps API key — used by visitors' browsers to render the map and display property pins. This key must use an HTTP referrer (website) restriction set to your site URL. Enable the Maps JavaScript API and Geocoding API on this key.
• Google Geocoding API key — used by the server when a property is saved, to convert an entered address into coordinates. This key must use an IP address restriction pointing to your server's IP. Enable the Geocoding API on this key.

You cannot use one key for both purposes. HTTP referrer restrictions block server-side requests, so geocoding on save will silently fail if you supply only the browser key. Conversely, an IP-restricted key is unsuitable for browser-side use.

Map View Settings

Configure the addon under Settings → General, in the Map View card.

• Hide map — globally hides the map on all single property pages, overriding any per-property coordinate data.
• Map provider — choose Google Maps or MapBox.
• Google Maps API key — your HTTP-referrer-restricted key for browser map rendering.
• Google Geocoding API key — your IP-restricted key for server-side address geocoding.
• Google Maps zoom — default zoom level (10–19) for single property pages.
• MapBox API key — required when MapBox is selected as the provider.
• MapBox zoom — default zoom level (14–19) for MapBox maps.
• Map display as — initial map style: Map (road map) or Satellite.

To show a map panel on the listing page, go to Settings → Properties and set Display map on listing page to Yes.

Setting Property Coordinates

In the property edit form, the Map section lets you set a location in three ways: type an address to auto-geocode it, drag the marker to the exact position, or enter latitude and longitude directly. Properties with no coordinates set (both values at 0) do not appear on the listing map.

Frontend Map Views

On the listing page, properties appear as markers on a full-width map. Clicking a marker opens a mini-card showing the property photo, title, and price.

On each property detail page, an embedded map with the property's location pin appears in the details section.

To install this addon, open the Add-ons panel inside FW Real Estate. See Getting Started → Add-ons for details on free addons, paid addons, and site verification.